Radar.get_gate_x_y_z(sweep, edges=False, filter_transitions=False)[source]#

Return the x, y and z gate locations in meters for a given sweep.

With the default parameter this method returns the same data as contained in the gate_x, gate_y and gate_z attributes but this method performs the gate location calculations only for the specified sweep and therefore is more efficient than accessing this data through these attribute.

When used with get_field() this method can be used to obtain the data needed for plotting a radar field with the correct spatial context.

  • sweep (int) – Sweep number to retrieve gate locations from, 0 based.

  • edges (bool, optional) – True to return the locations of the gate edges calculated by interpolating between the range, azimuths and elevations. False (the default) will return the locations of the gate centers with no interpolation.

  • filter_transitions (bool, optional) – True to remove rays where the antenna was in transition between sweeps. False will include these rays. No rays will be removed if the antenna_transition attribute is not available (set to None).


x, y, z (2D array) – Array containing the x, y and z, distances from the radar in meters for the center (or edges) for all gates in the sweep.