towerpy.io.empty#

Towerpy: an open-source toolbox for processing polarimetric radar data.

Classes#

Rad_scan

A Towerpy class to store radar scan data.

Module Contents#

class towerpy.io.empty.Rad_scan(filename, site_name=None)[source]#

A Towerpy class to store radar scan data.

Attributes#

elev_anglefloat

Elevation angle at which the scan was taken, in deg.

file_namestr

Name of the file containing radar data.

scandatetimedatetime

Date and time of scan.

site_namestr

Name of the radar site.

georefdict

Georeferenced data containing descriptors of the azimuth, gates and beam height, amongst others.

paramsdict

Radar technical details.

varsdict

Radar variables.

file_name[source]#
site_name = None[source]#
ppi_emptylike(nrays=360, ngates=425, elev=0.5, rad_vars='default', scandt=None, tz='Europe/London')[source]#

Create an empty object listing different radar parameters.

Parameters#

nraysint

Number of rays on the radar sweep. The default is 360.

ngatesint, optional

Number of bins comprising the radar rays. The default is 425.

elevfloat, optional

Elevation angle of the radar scan. The default is 0.5.

rad_varslist, optional
Polarimetric variables to add to the object. The default are:

\(Z_{H} [dBZ]\), \(Z_{DR} [dB]\), \(\rho_{HV} [-]\), \(\Phi_{DP} [deg]\), \(V [m/s]\) The default is ‘default’.

scandtdatetime, optional

Date and time of the scan. If not provided, datetime.now is used. The default is None.

tzstr

Key/name of the radar data timezone. The given tz string is then retrieved from the ZoneInfo module. Default is ‘Europe/London’

ppi_create_georef(polarc_exist=True, elev=0.5, gate0=0, gateres=250)[source]#

Create a georeferenced grid for the empty object.

Parameters#

polarc_existbool

If True, polar coordinates (range, azimuth, elevation) are read directly from the georef attribute. If False, synthesise elevation, azimuth, and range. The default is True

elevfloat

Elevation angle in degrees (used if polarc_exist=False). The default is 0.5

gate0float

Starting range gate in metres (used if polarc_exist=False). The default is 0

gateresfloat

Gate resolution in metres (used if polarc_exist=False). The default is 250

Notes#

  1. Polar coordinates (azimuth, elevation) are expected to be in radians, and range values are expected to be in metres.

  2. Some radar technical details are read from Rad_scan.params

  3. This method wraps geo.ppi_georef() and updates the object’s georef attribute with computed Cartesian grids and beam heights.