pyart.io.read_nexrad_level3#

pyart.io.read_nexrad_level3(filename, field_names=None, additional_metadata=None, file_field_names=False, exclude_fields=None, include_fields=None, storage_options={'anon': True}, **kwargs)[source]#

Read a NEXRAD Level 3 product.

Parameters:

  • filename (str) – Filename of NEXRAD Level 3 product file. The files hosted by at the NOAA National Climate Data Center [1] as well as on the NWS WSR-88D Level III Data Collection and Distribution Network have been tests. Other NEXRAD Level 3 files may or may not work. A file-like object pointing to the beginning of such a file is also supported [2].

  • field_names (dict, optional) – Dictionary mapping NEXRAD level 3 product number to radar field names. If the product number of the file does not appear in this dictionary or has a value of None it will not be placed in the radar.fields dictionary. A value of None, the default, will use the mapping defined in the metadata configuration file.

  • additional_metadata (dict of dicts, optional) – Dictionary of dictionaries to retrieve metadata from during this read. This metadata is not used during any successive file reads unless explicitly included. A value of None, the default, will not introduct any addition metadata and the file specific or default metadata as specified by the metadata configuration file will be used.

  • file_field_names (bool, optional) – True to use the product number for the field name. In this case the field_names parameter is ignored. The field dictionary will likely only have a ‘data’ key, unless the fields are defined in additional_metadata.

  • exclude_fields (list or None, optional) – List of fields to exclude from the radar 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 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.

  • **kwargs – Additional keyword arguments to pass to fsspec to open the dataset

Returns:

radar (Radar) – Radar object containing all moments and sweeps/cuts in the volume. Gates not collected are masked in the field data.

References