pyart.aux_io.read_kazr_spectra#
- pyart.aux_io.read_kazr_spectra(filename, field_names=None, additional_metadata=None, file_field_names=False, exclude_fields=None, include_fields=None, **kwargs)[source]#
Read a ARM KAZR spectra netCDF file.
- Parameters:
filename (str) – Name of KAZR spectra netCDF file to read data from.
field_names (dict, optional) – Dictionary mapping field names in the file names to radar_spectra field names. Unlike other read functions, fields not in this dictionary or having a value of None are still included in the radar_spectra.fields dictionary, to exclude them use the exclude_fields parameter. Fields which are mapped by this dictionary will be renamed from key to value.
additional_metadata (dict of dicts, optional) – This parameter is not used, it is included for uniformity.
file_field_names (bool, optional) – True to force the use of the field names from the file in which case the field_names parameter is ignored. False will use to field_names parameter to rename fields.
exclude_fields (list or None, optional) – List of fields to exclude from the radar spectra object. This is applied after the file_field_names and field_names parameters. Set to None to include all fields specified by include_fields.
include_fields (list or None, optional) – List of fields to include from the radar spectra object. This is applied after the file_field_names and field_names parameters. Set to None to include all fields not specified by exclude_fields.
delay_field_loading (bool) – True to delay loading of field data from the file until the ‘data’ key in a particular field dictionary is accessed. In this case the field attribute of the returned RadarSpectra object will contain LazyLoadDict objects not dict objects. Delayed field loading will not provide any speedup in file where the number of gates vary between rays (ngates_vary=True) and is not recommended.
- Returns:
radar_spectra (RadarSpectra) – RadarSpectra object.