pyrad.proc.process_point_measurement

pyrad.proc.process_point_measurement(procstatus, dscfg, radar_list=None)

Obtains the radar data at a point location. Multiple radars are supported only if latlon is True.

Parameters:

• procstatus (int) – Processing status: 0 initializing, 1 processing volume, 2 post-processing

• dscfg (dictionary of dictionaries) –

  data set configuration. Accepted Configuration Keywords:

  datatype : string. Dataset keyword
      The data type where we want to extract the point measurement,
      can be any datatype supported by pyrad and available in the data.
      If multiple radars are provided, the datatype must be the same for all
      of them.
  agg_method : string. Dataset keyword
      Which aggregation method to use to combine data that is within the
      tolerance in AziTol, EleTol and RngTol
      'nearest' : will only get nearest point to prescribed lon/lat/alt or
          ele/azi/rng
      'nearest_valid' : will only get the nearest valid point, within
          tolerance AziTol, EleTol and RngTol to prescribed
          lon/lat/alt or ele/azi/rng (ignore missing values)
      'average' : will average (while ignore missing values), all values
          that fall within the tolerance in AziTol, EleTol and RngTol
      'none' : will not perform any averaging and will get all values that
          fall within the tolerance in AziTol, EleTol and RngTol, each
          with its individual timestamp
      Default is 'nearest'
  latlon : boolean. Dataset keyword
      if True position is obtained from latitude, longitude information,
      otherwise position is obtained from antenna coordinates
      (range, azimuth, elevation).
  truealt : boolean. Dataset keyword
      if True the user input altitude is used to determine the point of
      interest.
      if False use the altitude at a given radar elevation ele over the
      point of interest. Default is False.
  lon : float. Dataset keyword
      the longitude [deg]. Use when latlon is True.
  lat : float. Dataset keyword
      the latitude [deg]. Use when latlon is True.
  alt : float. Dataset keyword
      altitude [m MSL]. Use when latlon is True and truealt is True
  ele : float. Dataset keyword
      radar elevation [deg]. Use when latlon is False or when latlon is
      True and truealt is False
  azi : float. Dataset keyword
      radar azimuth [deg]. Use when latlon is False
  rng : float. Dataset keyword
      range from radar [m]. Use when latlon is False
  AziTol : float. Dataset keyword
      azimuthal tolerance to determine which radar azimuth to use [deg]
  EleTol : float. Dataset keyword
      elevation tolerance to determine which radar elevation to use [deg]
  RngTol : float. Dataset keyword
      range tolerance to determine which radar bin to use [m]
  fill_value : float or None
      If not None masked values are going to be filled by this value
  

• radar_list (list of Radar objects) – Optional. list of radar objects

Returns:

• new_dataset (dict) – dictionary containing the data and metadata at the point of interest

• ind_rad (int) – radar index