pyart.aux_io.read_iq#

pyart.aux_io.read_iq(filename, filenames_iq, field_names=None, additional_metadata=None, file_field_names=False, exclude_fields=None, include_fields=None, reader='C', nbytes=4, prf=None, ang_tol=0.4, noise_h=None, noise_v=None, rconst_h=None, rconst_v=None, radconst_h=None, radconst_v=None, mfloss_h=1.0, mfloss_v=1.0, azi_min=None, azi_max=None, ele_min=None, ele_max=None, rng_min=None, rng_max=None, **kwargs)[source]#

Read a rad4alp IQ file.

Parameters:

  • filename (str) – Name of the METRANET file to be used as reference.

  • filenames_iq (list of str) – Name of the IQ files

  • field_names (dict, optional) – Dictionary mapping RAINBOW field names to radar field names. If a data type found in 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 Py-ART configuration file.

  • additional_metadata (dict of dicts, optional) – Dictionary of dictionaries to retrieve metadata 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 Py-ART configuration file will be used.

  • file_field_names (bool, optional) – True to use the MDV data type names for the field names. If 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.

  • reader (str) – The library used to read the METRANET reference file. Can be either ‘C’ or ‘python’

  • nbytes (int) – The number of bytes used to store the data in numpy arrays, e.g. if nbytes=4 then floats are going to be stored as np.float6432

  • prf (float) – The PRF of the read scan

  • ang_tol (float) – Tolerated angle distance between nominal radar angle and angle in PSR files

  • noise_h, noise_v (float) – The estimated H(V) noise power (ADU) of the scan

  • rconst_h, rconst_v (float) – Dynamical factor used in the conversion from dBADU to dBm/dBZ

  • radconst_h, radconst_v (float) – The H(V) radar constant

  • mfloss_h, mfloss_v (float) – The H(V) matched filter losses in the receiver (dB)

  • azi_min, azi_max, ele_min, ele_max (float or None) – The minimum and maximum angles to keep (deg)

  • rng_min, rng_max (float or None) – The minimum and maximum ranges to keep (m)

Returns:

radar (Radar) – Radar object containing data from PSR file.