pyart.map.GateMapper#

class pyart.map.GateMapper(src_radar, dest_radar, distance_tolerance=500.0, gatefilter_src=None, time_tolerance=60.0)[source]#

The GateMapper class will, given one radar’s gate, find the gate in another radar’s volume that is closest in location to the specified gate. GateMapper will use a kd-tree in order to generate a mapping function that provides the sweep and ray index in the other radar that is closest in physical location to the first radar’s gate. This functionality provides easy mapping of equivalent locations between radar objects with simple indexing. In addition, returning a mapped radar object is also supported.

Variables:
  • src_radar_y (src_radar_x,) – The source radar’s x and y location in the the destination radar’s Cartesian coordinates.

  • distance_tolerance (float) – The distance tolerance in meters for each gate in meters.

  • time_tolerance (float) – The time tolerance in meters for each gate in seconds.

  • gatefilter_src (pyart.filters.GateFilter) – The gatefilter to apply to the source radar data when mapping to the destination.

  • src_radar (pyart.core.Radar) – The source radar data.

  • dest_radar (pyart.core.Radar) – The destination radar to map the source radar data onto.

  • src_radar_time (float np.array) – The array of times of each gate in the source radar.

  • dest_radar_time (float np.array) – The array of times of each gate in the destination radar.

Parameters:

Examples

>>> gate_mapper = pyart.map.GateMapper(src, dest)
>>> # Get the destination radar's equivalent of (2, 2) in the source radar's coordinates
>>> dest_index = gate_mapper[2, 2]
>>> radar_mapped = gate_mapper.mapped_radar(['reflectivity'])
Parameters:
  • src_radar (pyart.core.Radar) – The source radar data.

  • dest_radar (pyart.core.Radar) – The destination radar to map the source radar data onto.

  • gatefilter_src (pyart.filters.GateFilter, or None) – The gatefilter to apply to the source radar data before mapping

  • distance_tolerance (float) – The difference in meters between the source and destination gate allowed for an adequate match.

  • time_tolerance (float) – The difference in time between the source and destination radar rays.

Parameters:

mapped_radar(field_list)

This returns a version of the destination radar with the fields in field_list from the source radar mapped into the destination radar's coordinate system.

distance_tolerance

Getter for distance_tolerance property of GateMapper class.

time_tolerance

Getter for time_tolerance property of GateMapper class.