towerpy.datavis.rad_display#

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

Functions#

pltparams(var2plot, rad_varskeys, vars_bounds[, ...])

Create parameters for plots.

plot_ppi(rad_georef, rad_params, rad_vars[, var2plot, ...])

Display a radar PPI scan.

plot_setppi(rad_georef, rad_params, rad_vars[, mlyr, ...])

Plot a set of PPIs of polarimetric variables.

plot_mgrid(rscans_georef, rscans_params, rscans_vars)

Graph multiple PPI scans into a grid.

plot_cone_coverage(rad_georef, rad_params, rad_vars[, ...])

Display a 3-D representation of the radar cone coverage.

plot_snr(rad_georef, rad_params, snr_data, min_snr[, ...])

Display the results of the SNR classification.

plot_nmeclassif(rad_georef, rad_params, nme_classif, ...)

Plot a set of PPIs of polarimetric variables.

plot_zhattcorr(rad_georef, rad_params, rad_vars_att, ...)

Plot the results of the ZH attenuation correction method.

plot_zdrattcorr(rad_georef, rad_params, rad_vars_att, ...)

Plot the results of the ZDR attenuation correction method.

plot_radprofiles(rad_profs, beam_height[, mlyr, ...])

Display a set of profiles of polarimetric variables.

plot_rdqvps(rscans_georef, rscans_params, tp_rdqvp[, ...])

Display a set of RD-QVPS of polarimetric variables.

plot_offsetcorrection(rad_georef, rad_params, rad_var)

Plot the offset detection method from ZDR/PhiDP_Calibration Class.

plot_mfs(path_mfs[, norm, vars_bounds, fig_size])

Plot the membership functions used in clutter classification.

plot_zhah(rad_vars, r_ahzh, temp, coeff_a, coeff_b, ...)

Display the AH-ZH relation.

plot_ppidiff(rad_georef, rad_params, rad_var1, rad_var2)

Plot the difference between a radar variable from different dicts.

_plot_rhohvmethod_single(snr_edges, rho_edges, hist, ...)

_plot_rhohvmethod_grid(Z, rng_km, rhohv_na[, mode, ...])

Plot calibration grid around the optimised noise level.

Module Contents#

towerpy.datavis.rad_display.pltparams(var2plot, rad_varskeys, vars_bounds, ucmap=None, unorm=None, cb_ext=None)[source]#

Create parameters for plots.

Parameters#

var2plotstr

Key of the radar variable to plot. The default is None. This option will plot ZH or the ‘first’ element in the rad_vars dict.

rad_varskeyslist

List of radar variables names.

vars_boundsdict containing key and 3-element tuple or list
The default are:
{‘ZH [dBZ]’: [-10, 60, 15], ‘ZDR [dB]’: [-2, 6, 17],

‘PhiDP [deg]’: [0, 180, 10], ‘KDP [deg/km]’: [-2, 6, 17], ‘rhoHV [-]’: [0.3, .9, 1], ‘AH [dB/km]’: [0, 0.5, 11], ‘V [m/s]’: [-5, 5, 11], ‘gradV [dV/dh]’: [-1, 0, 11], ‘LDR [dB]’: [-30, 10, 17], }, ‘Rainfall [mm/h]’: [0, 64, 11], ‘Rainfall [mm]’: [0, 200, 14], ‘SQI [0-1]’: [0, 1, 11] ‘beam_height [km]’: [0, 7, 36]}

ucmapcolormap, optional

User-defined colormap, either a mpl.colors.ListedColormap, or string from matplotlib.colormaps.

unormdict containing mpl.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

towerpy.datavis.rad_display.plot_ppi(rad_georef, rad_params, rad_vars, var2plot=None, mlyr=None, vars_bounds=None, ucmap=None, unorm=None, plot_contourl=None, contour_kw=None, coord_sys='polar', cpy_feats=None, data_proj=None, proj_suffix='osgb', xlims=None, ylims=None, ring=None, range_rings=None, rd_maxrange=False, pixel_midp=False, points2plot=None, ptsvar2plot=None, cbticks=None, cb_ext=None, fig_title=None, fig_size=None, font_sizes='regular')[source]#

Display a radar PPI scan.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_varsdict

Dict containing radar variables to plot.

var2plotstr, optional

Key of the radar variable to plot. The default is None. This option will plot ZH or look for the ‘first’ element in the rad_vars dict.

mlyrMeltingLayer Class, optional

Plot the melting layer height. ml_top (float, int, list or np.array) and ml_bottom (float, int, list or np.array) must be explicitly defined. The default is None.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

plot_contourl: str, optional

Key of the variable (within rad_vars) used to plot contour lines. Levels and normalisation are retrieved from vars_bounds, but these and other parameters can be overridden using the contour_kw parameter.

contour_kw:

Additional keyword arguments passed to matplotlib.pyplot.contour.

coord_sys‘rect’ or ‘polar’, optional

Coordinates system (polar or rectangular). The default is ‘polar’.

cpy_featsdict, optional
Cartopy attributes to add to the map. The default are:

{‘status’: False, ‘add_land’: False, ‘add_ocean’: False, ‘add_coastline’: False, ‘add_borders’: False, ‘add_countries’: True, ‘add_provinces’: True, ‘borders_ls’: ‘:’, ‘add_lakes’: False, ‘lakes_transparency’: 0.5, ‘add_rivers’: False, ‘tiles’: False, ‘tiles_source’: None, ‘tiles_style’: None}

data_projCartopy Coordinate Reference System object, optional

Cartopy projection used to plot the data in a map e.g., ccrs.OSGB(approx=False).

proj_suffixstr, optional

Suffix of the georeferenced grids used to display the data. The X/Y grids must exist in the rad_georef dictionary, e.g. ‘grid_osgbx–grid_osgby’, ‘grid_utmx–grid_utmy’, ‘grid_wgs84x–grid_wgs84y’, etc. The default is ‘osgb’.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

ringint or float, optional

Plot a circle in the given distance, in km.

range_ringsint, float, list or tuple, optional

If int or float, plot circles at a fixed range, in km. If list or tuple, plot circles at the given ranges, in km.

rd_maxrangeBool, optional

If True, plot the radar’s maximum range coverage. Note that this arg won’t work if a polar coordinates system is used. The default is False.

pixel_midpBool, optional

If True, mark the mid-point of all radar pixels. Note that this arg won’t work if a polar coordinates system is used. The default is False.

points2plotdict, optional

Plot a given set of points. Dict must contain the x-coord and y-coord in the same format as coord_sys or proj_suffix. A third element inside the dict can be used as the z-coord.

ptsvar2plotstr, optional

Key of the variable to plot. The default is None. This option will looks for the ‘first’ element in the points2plot dict.

cbticksdict, optional

Modifies the default ticks’ location (dict values) and labels (dict keys) in the colour bar.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

fig_titlestr, optional

String to show in the plot title.

fig_size2-element tuple or list, optional

Modify the default plot size.

font_sizesstr, optional

Modifies the size of the fonts in the plot. The string has to be one of ‘regular’ or ‘large’.

towerpy.datavis.rad_display.plot_setppi(rad_georef, rad_params, rad_vars, mlyr=None, vars_bounds=None, ucmap=None, unorm=None, cb_ext=None, xlims=None, ylims=None, ncols=None, nrows=None, fig_title=None, fig_size=None)[source]#

Plot a set of PPIs of polarimetric variables.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_varsdict

Radar variables to be plotted.

mlyrMeltingLayer Class, optional

Plot the melting layer height. ml_top (float, int, list or np.array) and ml_bottom (float, int, list or np.array) must be explicitly defined. The default is None.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

ncolsint, optional

Number of columns used to build the grid. The default is None.

nrowsint, optional

Number of rows used to build the grid. The default is None.

fig_titlestr, optional

Modify the default plot title.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display.plot_mgrid(rscans_georef, rscans_params, rscans_vars, var2plot=None, vars_bounds=None, ucmap=None, unorm=None, cb_ext=None, cpy_feats=None, proj_suffix='osgb', data_proj=None, xlims=None, ylims=None, ncols=None, nrows=None, fig_size=None)[source]#

Graph multiple PPI scans into a grid.

Parameters#

rscans_georeflist

List of georeferenced data containing descriptors of the azimuth, gates and beam height, amongst others, corresponding to each PPI scan.

rscans_paramslist

List of radar technical details corresponding to each PPI scan.

rscans_varslist

List of Dicts containing radar variables to plot corresponding to each PPI scan.

var2plotstr, optional

Key of the radar variable to plot. The default is None. This option will plot ZH or the ‘first’ element in the rad_vars dict.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped. The default are:

{‘ZH [dBZ]’: [-10, 60, 15],

‘ZDR [dB]’: [-2, 6, 17], ‘PhiDP [deg]’: [0, 180, 10], ‘KDP [deg/km]’: [-2, 6, 17], ‘rhoHV [-]’: [0.3, .9, 1], ‘V [m/s]’: [-5, 5, 11], ‘gradV [dV/dh]’: [-1, 0, 11], ‘LDR [dB]’: [-35, 0, 11], ‘Rainfall [mm/h]’: [0.1, 64, 11]}

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

coord_sys‘rect’ or ‘polar’, optional

Coordinates system (polar or rectangular). The default is ‘polar’.

cpy_featsdict, optional

Cartopy attributes to add to the map. The default are: { ‘status’: False, ‘add_land’: False, ‘add_ocean’: False, ‘add_coastline’: False, ‘add_borders’: False, ‘add_countries’: True, ‘add_provinces’: True, ‘borders_ls’: ‘:’, ‘add_lakes’: False, ‘lakes_transparency’: 0.5, ‘add_rivers’: False, ‘tiles’: False, ‘tiles_source’: None, ‘tiles_style’: None, }

proj_suffixstr

Suffix of the georeferenced grids used to display the data. The X/Y grids must exist in the rad_georef dictionary, e.g. ‘grid_osgbx–grid_osgby’, ‘grid_utmx–grid_utmy’, ‘grid_wgs84x–grid_wgs84y’, etc. The default is ‘osgb’.

data_projCartopy Coordinate Reference System object, optional

Cartopy projection used to plot the data in a map e.g., ccrs.OSGB(approx=False).

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

ncolsint, optional

Set the number of columns used to build the grid. The default is None.

nrowsint, optional

Set the number of rows used to build the grid. The default is None.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display.plot_cone_coverage(rad_georef, rad_params, rad_vars, var2plot=None, vars_bounds=None, xlims=None, ylims=None, zlims=[0, 8], limh=8, ucmap=None, unorm=None, cbticks=None, cb_ext=None, fig_size=None)[source]#

Display a 3-D representation of the radar cone coverage.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_varsdict

Dict containing radar variables to plot.

var2plotstr, optional

Key of the radar variable to plot. The default is None. This option will plot ZH or the ‘first’ element in the rad_vars dict.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

zlims2-element tuple or list, optional

Set the z-axis view limits [min, max]. The default is None.

limhint or float, optional

Set a height limit to the plot. The default is None.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

cbticksdict, optional

Modifies the default ticks’ location (dict values) and labels (dict keys) in the colour bar.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display.plot_snr(rad_georef, rad_params, snr_data, min_snr, coord_sys='polar', ucmap_snr=None, fig_size=None)[source]#

Display the results of the SNR classification.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

snr_datadict

Results of the SNR_Classif method.

proj‘rect’ or ‘polar’, optional

Coordinates system (polar or rectangular). The default is ‘polar’.

towerpy.datavis.rad_display.plot_nmeclassif(rad_georef, rad_params, nme_classif, echoesID, clutter_map=None, xlims=None, ylims=None, fig_size=None)[source]#

Plot a set of PPIs of polarimetric variables.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

nme_classifdict

Results of the NME_ID method.

clutter_maparray, optional

Clutter map used for the NME_ID method. The default is None.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

towerpy.datavis.rad_display.plot_zhattcorr(rad_georef, rad_params, rad_vars_att, rad_vars_attcorr, vars_bounds=None, mlyr=None, xlims=None, ylims=None, fig_size1=None, fig_size2=None)[source]#

Plot the results of the ZH attenuation correction method.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_vars_attdict

Radar variables not corrected for attenuation.

rad_vars_attcorrdict

Results of the AttenuationCorection method.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped. The default are:

{‘ZH [dBZ]’: [-10, 60, 15],

‘ZDR [dB]’: [-2, 6, 17], ‘PhiDP [deg]’: [0, 180, 10], ‘KDP [deg/km]’: [-2, 6, 17], ‘rhoHV [-]’: [0.3, .9, 1], ‘V [m/s]’: [-5, 5, 11], ‘gradV [dV/dh]’: [-1, 0, 11], ‘LDR [dB]’: [-35, 0, 11], ‘Rainfall [mm/h]’: [0.1, 64, 11]}

mlyrMeltingLayer Class, optional

Plot the melting layer height. ml_top (float, int, list or np.array) and ml_bottom (float, int, list or np.array) must be explicitly defined. The default is None.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

towerpy.datavis.rad_display.plot_zdrattcorr(rad_georef, rad_params, rad_vars_att, rad_vars_attcorr, vars_bounds=None, mlyr=None, xlims=None, ylims=None, fig_size1=None, fig_size2=None)[source]#

Plot the results of the ZDR attenuation correction method.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_vars_attdict

Radar variables not corrected for attenuation.

rad_vars_attcorrdict

Results of the AttenuationCorection method.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped. The default are:

{‘ZH [dBZ]’: [-10, 60, 15],

‘ZDR [dB]’: [-2, 6, 17], ‘PhiDP [deg]’: [0, 180, 10], ‘KDP [deg/km]’: [-2, 6, 17], ‘rhoHV [-]’: [0.3, .9, 1], ‘V [m/s]’: [-5, 5, 11], ‘gradV [dV/dh]’: [-1, 0, 11], ‘LDR [dB]’: [-35, 0, 11], ‘Rainfall [mm/h]’: [0.1, 64, 11]}

mlyrMeltingLayer Class, optional

Plot the melting layer height. ml_top (float, int, list or np.array) and ml_bottom (float, int, list or np.array) must be explicitly defined. The default is None.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

towerpy.datavis.rad_display.plot_radprofiles(rad_profs, beam_height, mlyr=None, stats=None, ylims=None, vars_bounds=None, colours=False, unorm=None, ucmap=None, cb_ext=None, fig_size=None)[source]#

Display a set of profiles of polarimetric variables.

Parameters#

rad_profsdict

Profiles generated by the PolarimetricProfiles class.

beam_heightarray

The beam height.

mlyrMeltingLayer Class, optional

Plots the melting layer within the polarimetric profiles. The default is None.

statsdict, optional

Statistics of the profiles generation computed by the PolarimetricProfiles class. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max] between which radar variables are to be plotted.

coloursBool, optional

Creates coloured profiles using norm to map colormaps.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display.plot_rdqvps(rscans_georef, rscans_params, tp_rdqvp, spec_range=None, mlyr=None, ylims=None, vars_bounds=None, ucmap=None, cb_ext=None, all_desc=False, fig_size=None)[source]#

Display a set of RD-QVPS of polarimetric variables.

Parameters#

rscans_georefList

List of georeferenced data containing descriptors of the azimuth, gates and beam height, amongst others, corresponding to each QVP.

rscans_paramsList

List of radar technical details corresponding to each QVP.

tp_rdqvpPolarimetricProfiles Class

Outputs of the RD-QVPs function.

spec_rangeint, optional

Range from the radar within which the RD-QVPS were built.

mlyrMeltingLayer Class, optional

Plots the melting layer within the polarimetric profiles. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

vars_boundsdict containing key and 2-element tuple or list, optional

Boundaries [min, max] between which radar variables are to be plotted.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

all_descbool, optional

If True, plots the initial QVPs used to compute the RD-QPVs. The default is True.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display.plot_offsetcorrection(rad_georef, rad_params, rad_var, var_m=None, var_offset=0, fig_size=None, var_name='PhiDP [deg]', mode='mean', cmap='tpylsc_div_lbu_w_rd')[source]#

Plot the offset detection method from ZDR/PhiDP_Calibration Class.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_vardict

PPI scan of the radar variable used to detect the offset.

var_namestr

Key of the radar variable used to detect the offset.

cmapcolormap, optional

User-defined colormap. The default is ‘tpylsc_div_lbu_w_rd’.

towerpy.datavis.rad_display.plot_mfs(path_mfs, norm=True, vars_bounds=None, fig_size=None)[source]#

Plot the membership functions used in clutter classification.

Parameters#

path_mfsstr

Location of the membership function files..

normbool, optional

Determines if the variables are normalised for a more comprehensive visualisation of the MFS. The default is True.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, LaTeX Varnames] between which radar variables are to be mapped.

fig_sizelist or tuple containing 2-element numbers, optional

Width, height in inches. The default is None.

towerpy.datavis.rad_display.plot_zhah(rad_vars, r_ahzh, temp, coeff_a, coeff_b, coeffs_a, coeffs_b, temps, zh_lower_lim, zh_upper_lim, var2calc='ZH [dBZ]')[source]#

Display the AH-ZH relation.

Parameters#

rad_varsdict

Dict containing radar variables to plot.

r_ahzhobj

Results of the Attn_Refl_Relation class.

temp: float

Temperature, in \(^{\circ}C\), used to derive the coefficients according to [1]_. The default is 10.

coeff_a, coeff_b: float

Computed coefficients of the \(A_H(Z_H)\) relationship.

coeffs_a, coeffs_b: list or array

Default coefficients of the \(A_H(Z_H)\) relationship..

tempslist or array

Default values for the temperature.

var2calcstr, optional

Radar variable to be computed. The string has to be one of ‘AH [dB/km]’ or ‘ZH [dBZ]’. The default is ‘ZH [dBZ]’.

towerpy.datavis.rad_display.plot_ppidiff(rad_georef, rad_params, rad_var1, rad_var2, var2plot1=None, var2plot2=None, diff_lims=[-10, 10, 1], mlyr=None, xlims=None, ylims=None, vars_bounds=None, unorm=None, ucmap=None, ucmap_diff=None, cb_ext=None, fig_title=None, fig_size=None)[source]#

Plot the difference between a radar variable from different dicts.

Parameters#

rad_georefdict

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

rad_paramsdict

Radar technical details.

rad_var1dict

Dict containing radar variables to plot.

rad_var2dict

Dict containing radar variables to plot.

vars2plotstr, optional

Keys of the radar variables to plot. Variables must have the same units. The default is None. This option will plot ZH or look for the ‘first’ element in the rad_vars dict.

diff_lims3-element tuple or list, optional

Boundaries [min, max, step] used for mapping the difference plot. The default is [-10, 10, 1].

mlyrMeltingLayer Class, optional

Plot the melting layer height. ml_top (float, int, list or np.array) and ml_bottom (float, int, list or np.array) must be explicitly defined. The default is None.

xlims2-element tuple or list, optional

Set the x-axis view limits [min, max]. The default is None.

ylims2-element tuple or list, optional

Set the y-axis view limits [min, max]. The default is None.

vars_boundsdict containing key and 3-element tuple or list, optional

Boundaries [min, max, nvals] between which radar variables are to be mapped.

unormdict containing matplotlib.colors normalisation objects, optional

User-defined normalisation methods to map colormaps onto radar data. The default is None.

ucmapcolormap, optional

User-defined colormap, either a matplotlib.colors.ListedColormap, or string from matplotlib.colormaps.

ucmap_diffstr of colormap, optional

User-defined colormap used in the difference plot.

cb_extdict containing key and str, optional

The str modifies the end(s) for out-of-range values for a given key (radar variable). The str has to be one of ‘neither’, ‘both’, ‘min’ or ‘max’.

fig_titlestr, optional

String to show in the plot title.

fig_size2-element tuple or list, optional

Modify the default plot size.

towerpy.datavis.rad_display._plot_rhohvmethod_single(snr_edges, rho_edges, hist, snr_db, rhohv_na, snr_centers, theo_line, histmax, opt_noise, fig_size=(8, 6))[source]#
towerpy.datavis.rad_display._plot_rhohvmethod_grid(Z, rng_km, rhohv_na, mode='linear', exp_curvet=20.0, eps=0.005, rhohv_theo=(0.9, 1.0), opt_noise=None, bins_snr=(5, 30, 0.1), bins_rho=(0.8, 1.1, 0.005), fig_size=(16, 9))[source]#

Plot calibration grid around the optimised noise level. Shows histograms for opt_noise ±5 dB in 1 dB steps, using corrected rhoHV (rhohv_corr).