pyrad.proc.process_point_measurement#

pyrad.proc.process_point_measurement(procstatus, dscfg, radar_list=None)[source]#

Obtains the radar data at a point location.

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
    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 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