List of pyrad products separated by dataset type#
VOL#
ANTENNA_POS#
- description
- Plots time series of the antenna position with respectto elevation or azimuth
- parameters
- dpi:float
dpi of the plot
- datatype:str
type of data to plot. Can be AZ or EL
CDF#
- description
- plots and writes the cumulative density function of data
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- quantiles:list of floats
The quantiles to compute in percent. Default None
- sector:dict
dictionary defining the sector where to compute the CDF. Default is None and the CDF is computed over all the data
May : contain:
- rmin,rmax: float
min and max range [m]
- azmin,azmax: float
min and max azimuth angle [deg]
- elmin,elmax: float
min and max elevation angle [deg]
- hmin,hmax: float
min and max altitude [m MSL]
- vismin:float
The minimum visibility to use the data. Default None
- absolute:Bool
If true the absolute values of the data will be used. Default False
- use_nans:Bool
If true NaN values will be used. Default False
- nan_value:Bool
The value by which the NaNs are substituted if NaN values are to be used in the computation
- filterclt:Bool
If True the gates containing clutter are filtered
- filterprec:list of ints
The hydrometeor types that are filtered from the analysis. Default empty list.
BSCOPE_IMAGE#
- description
- Creates a B-scope image (azimuth, range)
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr: int
The elevation angle number to use
- ray_dim: str
the ray dimension. Can be ‘ang’ or ‘time’. Default ‘ang’
- xaxis_rng: bool
if True the range will be in the x-axis. Otherwise it will be in the y-axis. Default True
- vmin,vmax: float or None
The minimum and maximum values of the color scale. If None the scale is going to be set according to the Py-ART config file
CAPPI_IMAGE#
- description
- Creates a CAPPI image
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- altitude:flt
CAPPI altitude [m MSL]
- wfunc:str
The function used to produce the CAPPI as defined in pyart.map.grid_from_radars. Default ‘NEAREST’
- cappi_res:float
The CAPPI resolution [m]. Default 500.
CROSS_SECTION#
- description
- Plots a cross-section of polar data througharbitrary coordinates
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- coord1,coord2, …, coordN: dict
The two lat-lon coordinates marking the limits. They have the keywords ‘lat’ and ‘lon’ [degree].
- step: int
Step in meters to use between reference points to calculate the cross-section (i.e horizontal resolution).
- vert_res: int
Vertical resolution in meters used to calculate the cross-section
- alt_max: int
Maximum altitude of the vertical cross-section
- beamwidth: float
3dB beamwidth in degrees to be used in the calculations, if not provided will be read from the loc file
- demfile: str
Name of the DEM file to use to plot the topography, it must be in the dempath specified in the main config file
FIELD_COVERAGE#
- description
- Gets the field coverage over a certain sector
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- threshold:float or None
Minimum value to consider the data valid. Default None
- nvalid_min:float
Minimum number of valid gates in the ray to consider it valid. Default 5
- ele_res,azi_res: float
Elevation and azimuth resolution of the sectors [deg]. Default 1. and 2.
- ele_min,ele_max: float
Min and max elevation angle defining the sector [deg]. Default 0. and 30.
- ele_step:float
Elevation step [deg]. Default 5.
- ele_sect_start,ele_sect_stop: float or None
start and stop angles of the sector coverage. Default None
- quantiles:list of floats
The quantiles to compute in the sector. Default 10. to 90. by steps of 10.
- AngTol:float
The tolerance in elevation angle when putting the data in a fixed grid
FIXED_RNG_IMAGE#
- description
- Plots a fixed range image
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- AngTol: float
The tolerance between the nominal angles and the actual radar angles. Default 1.
- ele_res,azi_res: float or None
The resolution of the fixed grid [deg]. If None it will be obtained from the separation between angles
- vmin,vmax : float or None
Min and Max values of the color scale. If None the values are taken from the Py-ART config file
FIXED_RNG_SPAN_IMAGE#
- description
- Plots a user-defined statistic over a fixedrange image
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- AngTol: float
The tolerance between the nominal angles and the actual radar angles. Default 1.
- ele_res,azi_res: float or None
The resolution of the fixed grid [deg]. If None it will be obtained from the separation between angles
- stat: str
The statistic to compute. Can be ‘min’, ‘max’, ‘mean’, ‘mode’. Default ‘max’
HISTOGRAM#
- description
- Computes a histogram of the radar volume data
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- step:float or None
the data quantization step. If none it will be obtained from the Py-ART configuration file
- write_data:Bool
If true the histogram data is written in a csv file
PLOT_ALONG_COORD#
- description
- Plots the radar volume data along a particularcoordinate
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- colors:list of str or None
The colors of each ploted line
- data_on_y: bool
If True the x-axis is the coordinates, and the y the data values. False swaps the axis. Default True
- plot_legend: bool
If True a legend will be plotted. Default True
- mode:str
Ploting mode. Can be ‘ALONG_RNG’, ‘ALONG_AZI’ or ‘ALONG_ELE’
- value_start,value_stop: float
The starting and ending points of the data to plot. According to the mode it may refer to the range, azimuth or elevation. If not specified the minimum and maximum possible values are used
- fix_elevations,fix_azimuths, fix_ranges: list of floats
The elevations, azimuths or ranges to plot for each mode. ‘ALONG_RNG’ would use fix_elevations and fix_azimuths ‘ALONG_AZI’ fix_ranges and fix_elevations ‘ALONG_ELE’ fix_ranges and fix_azimuths
- AngTol:float
The tolerance to match the radar angle to the fixed angles Default 1.
- RngTol:float
The tolerance to match the radar range to the fixed ranges Default 50.
- use_altitude: bool
If true and in ALON_RNG mode the coordinate used is the gate altitude. Otherwise is the range. Default False
PLOT_TXH#
- description
- Plots the transmitted signal power (H) for a standardsunscan.
PPI_CONTOUR#
- description
- Plots a PPI countour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- anglenr:float
The elevation angle number
PPI_CONTOUR_OVERPLOT#
- description
- Plots a PPI of a field with another fieldoverplotted as a contour plot.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- anglenr:float
The elevation angle number
PPI_IMAGE#
- description
- Plots a PPI image. It can also plot the histogram and thequantiles of the data in the PPI.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr:float
The elevation angle number
- plot_type:str
The type of plot to perform. Can be ‘PPI’, ‘QUANTILES’ or ‘HISTOGRAM’
- write_data:Bool
If True the histrogram will be also written in a csv file
- step:float or None
If the plot type is ‘HISTOGRAM’, the width of the histogram bin. If None it will be obtained from the Py-ART config file
- quantiles:list of float or None
If the plot type is ‘QUANTILES’, the list of quantiles to compute. If None a default list of quantiles will be computed
- vmin,vmax: float or None
The minimum and maximum values of the color scale. If None the scale is going to be set according to the Py-ART config file
PPI_MAP#
- description
- Plots a PPI image over a map. The map resolution and thetype of maps used are defined in the variables ‘mapres’ and ‘maps’in ‘ppiMapImageConfig’ in the loc config file.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr:float
The elevation angle number
- vmin,vmax : float or None
Min and Max values of the color scale. If None the values are taken from the Py-ART config file
PPIMAP_ROI_OVERPLOT#
- description
- Over plots a polygon delimiting a region ofinterest on a PPI map. The map resolution and thetype of maps used are defined in the variables ‘mapres’ and ‘maps’in ‘ppiMapImageConfig’ in the loc config file.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr:float
The elevation angle number
PROFILE_STATS#
- description
- Computes and plots a vertical profile statistics.The statistics are saved in a csv file
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- heightResolution:float
The height resolution of the profile [m]. Default 100.
- heightMin,heightMax: float or None
The minimum and maximum altitude of the profile [m MSL]. If None the values will be obtained from the minimum and maximum gate altitude.
- quantity:str
The type of statistics to plot. Can be ‘quantiles’, ‘mode’, ‘reqgression_mean’ or ‘mean’.
- quantiles:list of floats
If quantity type is ‘quantiles’ the list of quantiles to compute. Default 25., 50., 75.
- nvalid_min:int
The minimum number of valid points to consider the statistic valid. Default 4
- make_linear:Bool
If true the data is converted from log to linear before computing the stats
- include_nans:Bool
If true NaN values are included in the statistics
- fixed_span:Bool
If true the profile plot has a fix X-axis
- vmin,vmax: float or None
If fixed_span is set, the minimum and maximum values of the X-axis. If None, they are obtained from the Py-ART config file
PSEUDOPPI_CONTOUR#
- description
- Plots a pseudo-PPI countour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- angle:float
The elevation angle at which compute the PPI
- EleTol:float
The tolerance between the actual radar elevation angle and the nominal pseudo-PPI elevation angle.
PSEUDOPPI_CONTOUR_OVERPLOT#
- description
- Plots a pseudo-PPI of a field withanother field over-plotted as a contour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- angle:float
The elevation angle at which compute the PPI
- EleTol:float
The tolerance between the actual radar elevation angle and the nominal pseudo-PPI elevation angle.
PSEUDOPPI_IMAGE#
- description
- Plots a pseudo-PPI image. It can also plot thehistogram and the quantiles of the data in the pseudo-PPI.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- angle:float
The elevation angle of the pseudo-PPI
- EleTol:float
The tolerance between the actual radar elevation angle and the nominal pseudo-PPI elevation angle.
- plot_type:str
The type of plot to perform. Can be ‘PPI’, ‘QUANTILES’ or ‘HISTOGRAM’
- step:float or None
If the plot type is ‘HISTOGRAM’, the width of the histogram bin. If None it will be obtained from the Py-ART config file
- quantiles:list of float or None
If the plot type is ‘QUANTILES’, the list of quantiles to compute. If None a default list of quantiles will be computed
- vmin,vmax : float or None
Min and Max values of the color scale. If None the values are taken from the Py-ART config file
PSEUDOPPI_MAP#
- description
- Plots a pseudo-PPI image over a map. The mapresolution and the type of maps used are defined in the variables‘mapres’ and ‘maps’ in ‘ppiMapImageConfig’ in the loc config file.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- angle:float
The elevation angle of the pseudo-PPI
- EleTol:float
The tolerance between the actual radar elevation angle and the nominal pseudo-PPI elevation angle.
- vmin,vmax : float or None
Min and Max values of the color scale. If None the values are taken from the Py-ART config file
PSEUDORHI_CONTOUR#
- description
- Plots a pseudo-RHI countour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- angle:float
The azimuth angle at which to compute the RPI
- AziTol:float
The tolerance between the actual radar azimuth angle and the nominal pseudo-RHI azimuth angle.
PSEUDORHI_CONTOUR_OVERPLOT#
- description
- Plots a pseudo-RHI of a field withanother field over-plotted as a contour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- angle:float
The azimuth angle at which to compute the RPI
- AziTol:float
The tolerance between the actual radar azimuth angle and the nominal pseudo-RHI azimuth angle.
PSEUDORHI_IMAGE#
- description
- Plots a pseudo-RHI image. It can also plot thehistogram and the quantiles of the data in the pseudo-RHI.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- angle:float
The azimuth angle at which to compute the RPI
- AziTol:float
The tolerance between the actual radar azimuth angle and the nominal pseudo-RHI azimuth angle.
- plot_type:str
The type of plot to perform. Can be ‘RHI’, ‘QUANTILES’ or ‘HISTOGRAM’
- step:float or None
If the plot type is ‘HISTOGRAM’, the width of the histogram bin. If None it will be obtained from the Py-ART config file
- quantiles:list of float or None
If the plot type is ‘QUANTILES’, the list of quantiles to compute. If None a default list of quantiles will be computed
- vmin,vmax : float or None
Min and Max values of the color scale. If None the values are taken from the Py-ART config file
QUANTILES#
- description
- Plots and writes the quantiles of a radar volume
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- quantiles:list of floats or None
the list of quantiles to compute. If None a default list of quantiles will be computed.
- write_data:Bool
If True the computed data will be also written in a csv file
- fixed_span:Bool
If true the quantile plot has a fix Y-axis
- vmin,vmax: float or None
If fixed_span is set, the minimum and maximum values of the Y-axis. If None, they are obtained from the Py-ART config file
RHI_CONTOUR#
- description
- Plots an RHI countour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- anglenr:int
The azimuth angle number
RHI_CONTOUR_OVERPLOT#
- description
- Plots an RHI of a field with another fieldover-plotted as a contour plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- contour_values:list of floats or None
The list of contour values to plot. If None the contour values are going to be obtained from the Py-ART config file either with the dictionary key ‘contour_values’ or from the minimum and maximum values of the field with an assumed division of 10 levels.
- anglenr:int
The azimuth angle number
RHI_IMAGE#
- description
- Plots an RHI image. It can also plot thehistogram and the quantiles of the data in the RHI.
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr:int
The azimuth angle number
- plot_type:str
The type of plot to perform. Can be ‘RHI’, ‘QUANTILES’ or ‘HISTOGRAM’
- step:float or None
If the plot type is ‘HISTOGRAM’, the width of the histogram bin. If None it will be obtained from the Py-ART config file
- quantiles:list of float or None
If the plot type is ‘QUANTILES’, the list of quantiles to compute. If None a default list of quantiles will be computed
- vmin,vmax: float or None
The minimum and maximum values of the color scale. If None the scale is going to be set according to the Py-ART config file
RHI_PROFILE#
- description
- Computes and plots a vertical profile statistics out ofan RHI.The statistics are saved in a csv file
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- rangeStart,rangeStop: float
The range start and stop of the data to extract from the RHI to compute the statistics [m]. Default 0., 25000.
- heightResolution:float
The height resolution of the profile [m]. Default 100.
- heightMin,heightMax: float or None
The minimum and maximum altitude of the profile [m MSL]. If None the values will be obtained from the minimum and maximum gate altitude.
- quantity:str
The type of statistics to plot. Can be ‘quantiles’, ‘mode’, ‘reqgression_mean’ or ‘mean’.
- quantiles:list of floats
If quantity type is ‘quantiles’ the list of quantiles to compute. Default 25., 50., 75.
- nvalid_min:int
The minimum number of valid points to consider the statistic valid. Default 4
- make_linear:Bool
If true the data is converted from log to linear before computing the stats
- include_nans:Bool
If true NaN values are included in the statistics
- fixed_span:Bool
If true the profile plot has a fix X-axis
- vmin,vmax: float or None
If fixed_span is set, the minimum and maximum values of the X-axis. If None, they are obtained from the Py-ART config file
SAMPLES_HISTOGRAM#
- description
- Computes a histogram of the number of samples used
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- step:float or None
the data quantization step. If none it will be obtained from the Py-ART configuration file
- write_data:Bool
If true the histogram data is written in a csv file
SAVEALL#
- description
- Saves radar volume data including all or a list of user-defined fields in a C/F radial or ODIM file
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- datatypes:list of str or None
The list of data types to save. If it is None, all fields in the radar object will be saved
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
SAVEALL_VOL#
- description
- Same as before but can be used in a mixed GRID/VOLdataset, as there is no ambiguity with SAVEALL for VOL datasets
SAVESTATE#
- description
- Saves the last processed data in a file. Used for real-time data processing
SAVEPSEUDORHI#
- description
- Saves one field of a pseudo-RHI computed from avolume scan in C/F radial or ODIM file
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
SAVEPSEUDOPPI#
- description
- Saves one field of a pseudo-PPI computed from avolume scan in C/F radial or ODIM file
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
SAVEVOL#
- description
- Saves one field of a radar volume data in a C/F radial orODIM file
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary. Default True
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
SAVEVOL_CSV#
- description
- Saves one field of a radar volume data in a CSV file
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- ignore_masked:bool
If True masked values will not be saved. Default False
SAVEVOL_KML#
- description
- Saves one field of a radar volume data in a KML file
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- ignore_masked:bool
If True masked values will not be saved. Default False
- azi_res: float or None
azimuthal resolution of the range bins. If None the antenna beamwidth is going to be used to determine the resolution
SAVEVOL_VOL#
- description
- Same as before but can be used in a mixed GRID/VOLdataset, as there is no ambiguity with SAVEVOL for GRID datasets
SAVE_FIXED_ANGLE#
- description
- Saves the position of the first fix angle in a csv file
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
SELFCONSISTENCY#
- description
- Plots a ZDR versus KDP/ZH histogram of data.
- parameters
- retrieve_relation: bool
If True plots also the retrieved relationship. Default True
- plot_theoretical: bool
If True plots also the theoretical relationship. Default True
- normalize: bool
If True the occurrence density of ZK/KDP for each ZDR bin is going to be represented. Otherwise it will show the number of gates at each bin. Default True
SELFCONSISTENCY2#
- description
- Plots a ZH measured versus ZH inferred from aself-consistency relation histogram of data.
- parameters
- normalize: bool
If True the occurrence density of ZK/KDP for each ZDR bin is going to be represented. Otherwise it will show the number of gates at each bin. Default True
TIME_RANGE#
- description
- Plots a time-range/azimuth/elevation plot
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- anglenr:float
The number of the fixed angle to plot
- vmin,vmax: float or None
The minimum and maximum values of the color scale. If None the scale is going to be set according to the Py-ART config file
VOL_TS#
- description
- Writes and plots a value corresponding to a time series.Meant primarily for writing and plotting the results of theSELFCONSISTENCY2 algorithm
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- ref_value:float
The reference value. Default 0
- sort_by_date:Bool
If true when reading the csv file containing the statistics the data is sorted by date. Default False
- rewrite:Bool
If true the csv file containing the statistics is rewritten
- add_data_in_fname:Bool
If true and the data used is cumulative the year is written in the csv file name and the plot file name
- npoints_min:int
Minimum number of points to use the data point in the plotting and to send an alarm. Default 0
- vmin,vmax: float or None
Limits of the Y-axis (data value). If None the limits are obtained from the Py-ART config file
- alarm:Bool
If true an alarm is sent
- tol_abs:float
Margin of tolerance from the reference value. If the current value is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- tol_trend:float
Margin of tolerance from the reference value. If the trend of the last X events is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- nevents_min:int
Minimum number of events with sufficient points to send an alarm related to the trend. If not specified it is not possible to send any alarm
- sender:str
The mail of the alarm sender. If not specified it is not possible to send any alarm
- receiver_list:list of str
The list of emails of the people that will receive the alarm.. If not specified it is not possible to send any alarm
WIND_PROFILE#
- description
- Plots vertical profile of wind data (U, V, Wcomponents and wind velocity and direction) out of a radarvolume containing the retrieved U,V and W components of the wind,the standard deviation of the retrieval and the velocitydifference between the estimated radial velocity (assuming thewind to be uniform) and the actual measured radial velocity.
- parameters
- heightResolution:float
The height resolution of the profile [m]. Default 100.
- heightMin,heightMax: float or None
The minimum and maximum altitude of the profile [m MSL]. If None the values will be obtained from the minimum and maximum gate altitude.
- min_ele:float
The minimum elevation to be used in the computation of the vertical velocities. Default 5.
- max_ele:float
The maximum elevation to be used in the computation of the horizontal velocities. Default 85.
- fixed_span:Bool
If true the profile plot has a fix X-axis
- vmin,vmax: float or None
If fixed_span is set, the minimum and maximum values of the X-axis. If None, they are obtained from the span of the U component defined in the Py-ART config file
WRITE_STATS#
- description
- write statistics about the average of a field within a certainsector (mean, median, stddev, nsamples, nvalid) and optionally min, max andadditional quantiles
- parameters
- voltype:name of the pyrad variable to use, it must be available
in the dataset
- ele_min:float
Max elevation angle defining the sector [deg]. Default 0.
- ele_max:float
Max elevation angle defining the sector [deg]. Default 90.
- azi_min:float
Min azimuth angle defining the sector [deg]. Default 0.
- azi_max:float
Max azimuth angle defining the sector [deg]. Default 360.
- rmin:float
Min range defining the sector [km]. Default 0.
- rmax:float
Max range defining the sector [km]. Default 50.
- write_min_max:Bool
If true will also write min and max values within sector
- quantiles:list of int
Additional quantiles (apart from median) to compute within the sector and write to file
CENTROIDS#
HISTOGRAM#
- description
- Plots the histogram of one of the variables used forcentroids computation.
- parameters
- voltype: str
The name of the variable to plot. Can be dBZ, ZDR, KDP, RhoHV, H_ISO0 and its standardized form (e.g. dBZ_std)
- write_data: Bool
If true writes the histogram in a .csv file. Default True
- step: float
bin size. Default 0.1
HISTOGRAM2D#
- description
- Plots the 2D- histogram of two of the variables usedfor centroids computation.
- parameters
- voltype_x,voltype_y : str
The name of the variables to plot. Can be dBZ, ZDR, KDP, RhoHV, H_ISO0 and its standardized form (e.g. dBZ_std)
- step_x,step_y : float
bin size. Default 0.1
HISTOGRAM_LABELED#
- description
- Plots the histogram of one of the variables usedfor centroids computation. Only plots labeled data.
- parameters
- voltype: str
The name of the variable to plot. Can be dBZ, ZDR, KDP, RhoHV, H_ISO0 and its standardized form (e.g. dBZ_std)
- write_data: Bool
If true writes the histogram in a .csv file. Default True
- step: float
bin size. Default 0.1
HISTOGRAM_CENTROIDS#
- description
- Plots the histogram of one of the variablesused for centroids computation corresponding to a particularhydrometeor type, the intermediate centroids and the finalcentroid
- parameters
- voltype: str
The name of the variable to plot. Can be dBZ, ZDR, KDP, RhoHV, H_ISO0 and its standardized form (e.g. dBZ_std)
- hydro_type: str
The name of the hydrometeor type.
- write_data: Bool
If true writes the histogram in a .csv file. Default True
- step: float
bin size. Default 0.1
HISTOGRAM2D_CENTROIDS#
- description
- Plots the 2D- histogram of two of thevariables used for centroids computatio ncorresponding to aparticular hydrometeor type, the intermediate centroids and thefinal centroid
- parameters
- voltype_x,voltype_y : str
The name of the variables to plot. Can be dBZ, ZDR, KDP, RhoHV, H_ISO0 and its standardized form (e.g. dBZ_std)
- hydro_type: str
The name of the hydrometeor type.
- step_x,step_y : float
bin size. Default 0.1
WRITE_CENTROIDS#
- description
- Writes the final centroids in a .csv file.
SAVE_DATA#
- description
- Saves the data used to compute the centroids in an .npzfile
COLOCATED_GATES#
Note
Supports all products of type ‘VOL’
ICON_COORD#
SAVEVOL#
- description
- Save an object containing the index of the icon model gridthat corresponds to each radar gate in a C/F radial file.
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
ICON2RADAR#
Note
Supports all products of type ‘VOL’
SAVEVOL#
- description
- Save an object containing the icon data in radarcoordinatesin a C/F radial or ODIM file.
- parameters
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level). All the products of the ‘VOL’ dataset group
GRID#
CROSS_SECTION#
- description
- Plots a cross-section of gridded data
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- coord1,coord2: dict
The two lat-lon coordinates marking the limits. They have the keywords ‘lat’ and ‘lon’ [degree]. The altitude limits are defined by the parameters in ‘xsecImageConfig’ in the ‘loc’ configuration file
HISTOGRAM#
- description
- Computes a histogram of the radar volum data
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- step:float or None
the data quantization step. If none it will be obtained from the Py-ART configuration file
- vmin,vmax: float or None
The minimum and maximum values. If None they will be obtained from the Py-ART configuration file
- mask_val:float or None
A value to mask.
- write_data:Bool
If true the histogram data is written in a csv file
LATITUDE_SLICE#
- description
- Plots a cross-section of gridded data over aconstant latitude.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- lon,lat: floats
The starting point of the cross-section. The ending point is defined by the parameters in ‘xsecImageConfig’ in the ‘loc’ configuration file
LONGITUDE_SLICE#
- description
- Plots a cross-ection of gridded data over aconstant longitude.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- lon,lat: floats
The starting point of the cross-section. The ending point is defined by the parameters in ‘xsecImageConfig’ in the ‘loc’ configuration file
SAVEALL#
- description
- Saves a gridded data object including all or a list ofuser-defined fields in a netcdf file
- parameters
- datatypes:list of str or None
The list of data types to save. If it is None, all fields in the radar object will be saved
SAVEALL_GRID#
- description
- Same as before but can be used in a mixed GRID/VOLdataset, as there is no ambiguity with SAVEALL for VOL datasets
SAVEVOL#
- description
- Saves on field of a gridded data object in a netcdf file.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- file_type:str
The type of file used to save the data. Can be ‘nc’ or ‘h5’. Default ‘nc’
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary. Default True
- compression:str
For ODIM file formats, the type of compression. Can be any of the allowed compression types for hdf5 files. Default gzip
- compression_opts:any
The compression options allowed by the hdf5. Depends on the type of compression. Default 6 (The gzip compression level).
SAVEVOL_GRID#
- description
- Same as before but can be used in a mixed GRID/VOLdataset, as there is no ambiguity with SAVEVOL for VOL datasets
STATS#
- description
- Computes statistics over the whole images and stores them ina file.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- stat:str
The statistic used. Can be mean, median, min, max
SURFACE_RAW#
- description
- Plots a surface image of gridded data withoutprojecting it into a map
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
SURFACE_IMAGE#
- description
- Plots a surface image of gridded data.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
SURFACE_CONTOUR#
- description
- Plots a surface image of contour gridded data.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
- contour_values: float array or None
The contour values. If None the values are taken from the ‘boundaries’ keyword in the field description in the Py-ART config file. If ‘boundaries’ is not set the countours are 10 values linearly distributed from vmin to vmax
- linewidths: float
width of the contour lines
- colors: color string or sequence of colors
The contour colours
SURFACE_CONTOUR_OVERPLOT#
- description
- Plots a surface image of gridded data with a contour overplotted.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
- contour_values: float array or None
The contour values. If None the values are taken from the ‘boundaries’ keyword in the field description in the Py-ART config file. If ‘boundaries’ is not set the countours are 10 values linearly distributed from vmin to vmax
- linewidths: float
width of the contour lines
- colors: color string or sequence of colors
The contour colours
SURFACE_OVERPLOT#
- description
- Plots on the same surface two images, one on top of the other.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
- contour_values: float array or None
The contour values. If None the values are taken from the ‘boundaries’ keyword in the field description in the Py-ART config file. If ‘boundaries’ is not set the countours are 10 values linearly distributed from vmin to vmax
DDA_MAP#
- description
- Plots horizontal wind vectors obtained from a DDA analysis on a 2D map.The pyDDA package is required
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The altitude level to plot. The rest of the parameters are defined by the parameters in ‘ppiImageConfig’ and ‘ppiMapImageConfig’ in the ‘loc’ configuration file
- display_type:str
Display method for the wind vectors, can be either ‘streamline’, ‘quiver’ or ‘barbs’
- bg_ref_rad:int
Which radar to use as reference to display the background voltype.
- u_vel_contours:list of int
The contours to use for plotting contours of u. Set to None to not display such contours.
- v_vel_contours:list of int
The contours to use for plotting contours of v. Set to None to not display such contours.
- w_vel_contours:list of int
The contours to use for plotting contours of w. Set to None to not display such contours.
- vector_spacing_km:float
Spacing in km between wind vectors in x and y axis (only used for barbs and quiver plots)
- quiver_len:float
Length to use for the quiver key in m/s. (only used for quiver plots)
- streamline_arrowsize:float
Factor scale arrow size for streamlines. (only used for streamline plots)
- linewidth:float
Linewidths for streamlines. (only used for streamline plots)
DDA_LONGITUDE_SLICE#
- description
- Plots horizontal wind vectors obtained from a DDA analysis on a vertical transectalong a given longitudeThe pyDDA package is required
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The longitude level to plot. The rest of the parameters are defined by the parameters in ‘xsecImageConfig’ in the ‘loc’ configuration file
- display_type:str
Display method for the wind vectors, can be either ‘streamline’, ‘quiver’ or ‘barbs’
- bg_ref_rad:int
Which radar to use as reference to display the background voltype.
- u_vel_contours:list of int
The contours to use for plotting contours of u. Set to None to not display such contours.
- v_vel_contours:list of int
The contours to use for plotting contours of v. Set to None to not display such contours.
- w_vel_contours:list of int
The contours to use for plotting contours of w. Set to None to not display such contours.
- vector_spacing_km:float
Spacing in km between wind vectors in x and y axis (only used for barbs and quiver plots)
- quiver_len:float
Length to use for the quiver key in m/s. (only used for quiver plots)
- streamline_arrowsize:float
Factor scale arrow size for streamlines. (only used for streamline plots)
- linewidth:float
Linewidths for streamlines. (only used for streamline plots)
DDA_LATITUDE_SLICE#
- description
- Plots horizontal wind vectors obtained from a DDA analysis on a vertical transectalong a given latitudeThe pyDDA package is required
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- level:int
The latitude level to plot. The rest of the parameters are defined by the parameters in ‘xsecImageConfig’ in the ‘loc’ configuration file
- display_type:str
Display method for the wind vectors, can be either ‘streamline’, ‘quiver’ or ‘barbs’
- bg_ref_rad:int
Which radar to use as reference to display the background voltype.
- u_vel_contours:list of int
The contours to use for plotting contours of u. Set to None to not display such contours.
- v_vel_contours:list of int
The contours to use for plotting contours of v. Set to None to not display such contours.
- w_vel_contours:list of int
The contours to use for plotting contours of w. Set to None to not display such contours.
- vector_spacing_km:float
Spacing in km between wind vectors in x and y axis (only used for barbs and quiver plots)
- quiver_len:float
Length to use for the quiver key in m/s. (only used for quiver plots)
- streamline_arrowsize:float
Factor scale arrow size for streamlines. (only used for streamline plots)
- linewidth:float
Linewidths for streamlines. (only used for streamline plots)
SPECTRA#
AMPLITUDE_PHASE_ANGLE_DOPPLER#
- description
- Makes an angle Doppler plot ofcomplex spectra or IQ data. The plot can be along azimuth or alongrange. It is plotted separately the module and the phase of thesignal.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- along_azi: bool
If true the plot is performed along azimuth, otherwise along elevation. Default true
- ang: float
The fixed angle (deg). Default 0.
- rng: float
The fixed range (m). Default 0.
- ang_tol: float
The fixed angle tolerance (deg). Default 1.
- rng_tol: float
The fixed range tolerance (m). Default 50.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- ampli_vmin,ampli_vmax, phase_vmin, phase_vmax : float or None
Minimum and maximum of the color scale for the module and phase
AMPLITUDE_PHASE_DOPPLER#
- description
- Plots a complex Doppler spectrum or IQ datamaking two separate plots for the module and phase of the signal
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- rng: float
range (m) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- rng_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 50.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- ind_rng: int
index of the range to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- ampli_vmin,ampli_vmax, phase_vmin, phase_vmax : float or None
Minimum and maximum of the color scale for the module and phase
AMPLITUDE_PHASE_RANGE_DOPPLER#
- description
- Plots a complex spectra or IQ datarange-Doppler making two separate plots for the module and phase
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- ampli_vmin,ampli_vmax, phase_vmin, phase_vmax : float or None
Minimum and maximum of the color scale for the module and phase
AMPLITUDE_PHASE_TIME_DOPPLER#
- description
- Plots a complex spectra or IQ datatime-Doppler making two separate plots for the module and phase ofthe signal
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- antenna_coordinates_az_el_r: list of float
azimuth, elevation and range coordinates of the reference point (3 elements)
- point_coordinates_WGS84_lon_lat_alt: list of float
lon, lat (deg in WGS84 reference) and alt (in m) coordinates of the reference point. Will be used only if antenna_coordinates_az_el_r is not provided.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’ or ‘Doppler frequency’
- ampli_vmin: float or None
Minimum of the color scale for the module
- ampli_vmax: float or None
Maximum of the color scale for the module
- phase_vmin: float or None
Minimum of the color scale for the module
- phase_vmax: float or None
Minimum of the color scale for the phase
- plot_type: str
Can be ‘final’ or ‘temporal’. If final the data is only plotted at the end of the processing
ANGLE_DOPPLER#
- description
- Makes an angle Doppler plot. The plot can be alongazimuth or along range
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- along_azi: bool
If true the plot is performed along azimuth, otherwise along elevation. Default true
- ang: float
The fixed angle (deg). Default 0.
- rng: float
The fixed range (m). Default 0.
- ang_tol: float
The fixed angle tolerance (deg). Default 1.
- rng_tol: float
The fixed range tolerance (m). Default 50.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
COMPLEX_ANGLE_DOPPLER#
- description
- Makes an angle Doppler plot of complexspectra or IQ data. The plot can be along azimuth or along range.The real and imaginary parts are plotted separately
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- along_azi: bool
If true the plot is performed along azimuth, otherwise along elevation. Default true
- ang: float
The fixed angle (deg). Default 0.
- rng: float
The fixed range (m). Default 0.
- ang_tol: float
The fixed angle tolerance (deg). Default 1.
- rng_tol: float
The fixed range tolerance (m). Default 50.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
COMPLEX_DOPPLER#
- description
- Plots a complex Doppler spectrum or IQ data makingtwo separate plots for the real and imaginary parts
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- rng: float
range (m) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- rng_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 50.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- ind_rng: int
index of the range to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
COMPLEX_RANGE_DOPPLER#
- description
- Plots the complex spectra or IQ datarange-Doppler making two separate plots for the real and imaginaryparts
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- rng: float
range (m) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- rng_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 50.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
COMPLEX_TIME_DOPPLER#
- description
- Plots the complex spectra or IQ datatime-Doppler making two separate plots for the real and imaginaryparts
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- antenna_coordinates_az_el_r: list of float
azimuth, elevation and range coordinates of the reference point (3 elements)
- point_coordinates_WGS84_lon_lat_alt: list of float
lon, lat (deg in WGS84 reference) and alt (in m) coordinates of the reference point. Will be used only if antenna_coordinates_az_el_r is not provided.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’ or ‘Doppler frequency’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
- plot_type: str
Can be ‘final’ or ‘temporal’. If final the data is only plotted at the end of the processing
DOPPLER#
- description
- Plots a Doppler spectrum variable or IQ data variable
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- rng: float
range (m) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- rng_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 50.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
RANGE_DOPPLER#
- description
- Makes a range-Doppler plot of spectral or IQ data
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- azi: float
azimuth (deg) of the ray to plot
- ele: float
elevation (deg) of the ray to plot
- azi_tol: float
azimuth (deg) tolerance respect to nominal position to plot. Default 1.
- ele_tol: float
elevation (deg) tolerance respect to nominal position to plot. Default 1.
- ind_ray: int
index of the ray to plot. Alternative to defining its antenna coordinates
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
SAVEALL#
- description
- Saves radar spectra or IQ volume data including all or alist of userdefined fields in a netcdf file
- parameters
- datatypes:list of str or None
The list of data types to save. If it is None, all fields in the radar object will be saved
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
SAVEVOL#
- description
- Saves one field of a radar spectra or IQ volume data in anetcdf file
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- physical:Bool
If True the data will be saved in physical units (floats). Otherwise it will be quantized and saved as binary
TIME_DOPPLER#
- description
- Makes a time-Doppler plot of spectral or IQ data at apoint of interest.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- antenna_coordinates_az_el_r: list of float
azimuth, elevation and range coordinates of the reference point (3 elements)
- point_coordinates_WGS84_lon_lat_alt: list of float
lon, lat (deg in WGS84 reference) and alt (in m) coordinates of the reference point. Will be used only if antenna_coordinates_az_el_r is not provided.
- xaxis_info: str
The xaxis type. Can be ‘Doppler_velocity’, ‘Doppler_frequency’ or ‘pulse_number’
- vmin: float or None
Minimum of the color scale
- vmax: float or None
Maximum of the color scale
- plot_type: str
Can be ‘final’ or ‘temporal’. If final the data is only plotted at the end of the processing
GRID_TIMEAVG#
Note
Supports all products of type ‘VOL’
INTERCOMP#
PLOT_AND_WRITE_INTERCOMP_TS#
- description
- Writes statistics of radarintercomparison in a file and plots the time series of thestatistics.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- add_date_in_fname:Bool
If true adds the year in the csv file containing the statistics. Default False
- sort_by_date:Bool
If true sorts the statistics by date when reading the csv file containing the statistics. Default False
- step:float
The quantization step of the data. If none it will be computed using the Py-ART config file. Default None
- rewrite:Bool
If true rewrites the csv file containing the statistics. Default False
- npoints_min:int
The minimum number of points to consider the statistics valid and therefore use the data point in the plotting. Default 0
- transform:str
A transform to apply to the data before computing the statistics and generating the plots. Any mathematical function with argument “x” is accepted for example “sin(x) + x**2” or “10 * log10(x)” Default is to use no transform
- corr_min:float
The minimum correlation to consider the statistics valid and therefore use the data point in the plotting. Default 0.
PLOT_SCATTER_INTERCOMP#
- description
- Plots a density plot with the points ofradar 1 versus the points of radar 2
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- step:float
The quantization step of the data. If none it will be computed using the Py-ART config file. Default None
- scatter_type:str
Type of scatter plot. Can be a plot for each radar volume (instant) or at the end of the processing period (cumulative). Default is cumulative
- transform:str
A transform to apply to the data before computing the statistics and generating the plots. Any mathematical function with argument “x” is accepted for example “sin(x) + x**2” or “10 * log10(x)” Default is to use no transform
WRITE_INTERCOMP#
- description
- Writes the instantaneously intercompared data(gate positions, values, etc.) in a csv file.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
WRITE_INTERCOMP_TIME_AVG#
- description
- Writes the time-averaged intercompareddata (gate positions, values, etc.) in a csv file.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
ML#
Note
Supports all products of type ‘VOL’
ML_TS#
- description
- Plots and writes a time series of the melting layer, i.e.the evolution of the average and standard deviation of the meltinglayer top and thickness and the the number of rays used in theretrieval.
- parameters
- dpi:int
The pixel density of the plot. Default 72
SAVE_ML#
- description
- Saves an object containing the best estimate of the meltinglayer retrieved in a C/F radial file
MONITORING#
ANGULAR_DENSITY#
- description
- For a specified elevation angle, plots a 2Dhistogram with the azimuth angle in the X-axis and the data valuesin the Y-axis. The reference values and the user defined quantilesare also plot on the same figure
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- anglenr:int
The elevation angle number to plot
- quantiles:list of floats
The quantiles to plot. Default 25., 50., 75.
- ref_value:float
The reference value
- vmin,vmax : floats or None
The minimum and maximum values of the data points. If not specified they are obtained from the Py-ART config file
CUMUL_VOL_TS#
- description
- Plots time series of the average of instantaneousquantiles stored in a csv file.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- quantiles:list of 3 floats
the quantiles to compute. Default 25., 50., 75.
- ref_value:float
The reference value. Default 0
- sort_by_date:Bool
If true when reading the csv file containing the statistics the data is sorted by date. Default False
- rewrite:Bool
If true the csv file containing the statistics is rewritten
- add_data_in_fname:Bool
If true and the data used is cumulative the year is written in the csv file name and the plot file name
- npoints_min:int
Minimum number of points to use the data point in the plotting and to send an alarm. Default 0
- vmin,vmax: float or None
Limits of the Y-axis (data value). If None the limits are obtained from the Py-ART config file
- alarm:Bool
If true an alarm is sent
- tol_abs:float
Margin of tolerance from the reference value. If the current value is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- tol_trend:float
Margin of tolerance from the reference value. If the trend of the last X events is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- plot_until_year_end:Bool
If true will always set the xmax of the timeseries to the end of the current year
- nevents_min:int
Minimum number of events with sufficient points to send an alarm related to the trend. If not specified it is not possible to send any alarm
- sender:str
The mail of the alarm sender. If not specified it is not possible to send any alarm
- receiver_list:list of str
The list of emails of the people that will receive the alarm.. If not specified it is not possible to send any alarm
PPI_HISTOGRAM#
- description
- Plots a histogram of data at a particularelevation angle.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- anglenr:int
The elevation angle number to plot
SAVEVOL#
- description
- Saves the monitoring data in a C/F radar file. The datafield contains histograms of data for each pair of azimuth andelevation angles
VOL_HISTOGRAM#
- description
- Plots a histogram of data collected from all theradar volume.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- write_data:bool
If true the resultant histogram is also saved in a csv file. Default True.
VOL_TS#
- description
- Computes statistics of the gathered data and writes them ina csv file and plots a time series of those statistics.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- quantiles:list of 3 floats
the quantiles to compute. Default 25., 50., 75.
- ref_value:float
The reference value. Default 0
- sort_by_date:Bool
If true when reading the csv file containing the statistics the data is sorted by date. Default True
- rewrite:Bool
If true the csv file containing the statistics is rewritten
- add_data_in_fname:Bool
If true and the data used is cumulative the year is written in the csv file name and the plot file name
- npoints_min:int
Minimum number of points to use the data point in the plotting and to send an alarm. Default 0
- vmin,vmax: float or None
Limits of the Y-axis (data value). If None the limits are obtained from the Py-ART config file
- alarm:Bool
If true an alarm is sent
- tol_abs:float
Margin of tolerance from the reference value. If the current value is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- tol_trend:float
Margin of tolerance from the reference value. If the trend of the last X events is above this margin an alarm is sent. If the margin is not specified it is not possible to send any alarm
- plot_until_year_end:Bool
If true will always set the xmax of the timeseries to the end of the current year
- nevents_min:int
Minimum number of events with sufficient points to send an alarm related to the trend. If not specified it is not possible to send any alarm
- sender:str
The mail of the alarm sender. If not specified it is not possible to send any alarm
- receiver_list:list of str
The list of emails of the people that will receive the alarm.. If not specified it is not possible to send any alarm
OCCURRENCE#
Note
Supports all products of type ‘VOL’
WRITE_EXCESS_GATES#
- description
- Write the data that identifies radar gateswith clutter that has a frequency of occurrence above a certainthreshold.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- quant_min:float
Minimum frequency of occurrence in percentage to keep the gate as valid. Default 95. All the products of the ‘VOL’ dataset group
QVP#
Note
Supports all products of type ‘VOL’
SPARSE_GRID#
SURFACE_IMAGE#
- description
- Generates a surface image
- parameters
- ‘field_limits’:list of floats
The limits of the surface to plot [deg] lon0, lon1, lat0, lat1
SUN_HITS#
Note
Supports all products of type ‘VOL’
PLOT_SUN_HITS#
- description
- Plots in a sun-radar azimuth difference-sun-radarelevation difference grid the values of all sun hits obtainedduring the processing period
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
PLOT_SUN_RETRIEVAL#
- description
- Plots in a sun-radar azimuth difference-sun-radar elevation difference grid the retrieved sun pattern
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
PLOT_SUN_RETRIEVAL_TS#
- description
- Plots time series of the retrieved sunpattern parameters
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- dpi:int
The pixel density of the plot. Default 72
- add_date_in_fname:Bool
If true the year is added in the plot file name
PLOT_SUNSCAN#
- description
- Plots a constant range radar azimuth-elevation of thesunscan field data
WRITE_SUN_HITS#
- description
- Writes the information concerning possible sun hitsin a csv file. The written data has the following columns“time”,“ray”,“NPrng”,“rad_el”,“rad_az”,“sun_el”,“sun_az”,“dBm_sun_hit”,“std(dBm_sun_hit)”,“NPh”,“NPhval”,“dBmv_sun_hit”,“std(dBmv_sun_hit)”,“NPv”,“NPvval”,“ZDR_sun_hit”,“std(ZDR_sun_hit)”,“NPzdr”,“NPzdrval”
WRITE_SUN_RETRIEVAL#
- description
- Writes the retrieved sun pattern parameters ina csv file.
- parameters
- add_date_in_fname:Bool
If true the year is added in the csv file name
WRITE_SUNSCAN#
- description
- Writes the sunscan parameters in a csv file. The written data has the following columns“sun_az”: [deg] Azimuth sun position,“sun_el”: [deg] Elevation sun position,“noise_pwr”: [dBm] Noise power”,“sun_maxpwr_noise”: [dBm] sun maximal power sample (including noise),“sun_maxpwr_nonoise”: [dBm] sun maximal power sample without noise,“sun_maxpwr_fit”: [dBm] sun maximal fitted power (without noise),“sun_maxpwr_toa”: [dBm] sun maximal power at top of atmosphere,“az_offset”: [deg] Azimuth shift of fitted maxima to sun azimuth,“el_offset”: [deg] Elevation shift of fitted maxima to sun elevation,“az_phi3db”: [deg] Half-power beam width in azimuth,“el_phi3db”: [deg] Half-power beam width in elevation,“fit_stddev”: [dBm] Standard deviation (fit to samples),“num_samples”: [#] Number of samples used for the sun power fitting
TIMEAVG#
Note
Supports all products of type ‘VOL’
TIMESERIES#
COMPARE_CUMULATIVE_POINT#
- description
- Plots in the same graph 2 time series ofdata accumulation (tipically rainfall rate). One time series isa point measurement of radar data while the other is from aco-located instrument (rain gauge or disdrometer)
- parameters
- dpi:int
The pixel density of the plot. Default 72
- vmin,vmax: float
The limits of the Y-axis. If none they will be obtained from the Py-ART config file.
- sensor:str
The sensor type. Can be ‘rgage’, ‘rgage_knmi’, ‘disdro’ or ‘disdro_parsivel’
- sensorid:str
The sensor ID.
- location:str
A string identifying the location of the disdrometer
- freq:float
The frequency used to retrieve the polarimetric variables of a disdrometer
- ele:float
The elevation angle used to retrieve the polarimetric variables of a disdrometer
- ScanPeriod:float
The scaning period of the radar in seconds. This parameter is defined in the ‘loc’ config file
COMPARE_POINT#
- description
- Plots in the same graph 2 time series ofdata . One time series is a point measurement of radar data whilethe other is from a co-located instrument (rain gauge ordisdrometer)
- parameters
- dpi:int
The pixel density of the plot. Default 72
- vmin,vmax: float
The limits of the Y-axis. If none they will be obtained from the Py-ART config file.
- sensor:str
The sensor type. Can be ‘rgage’, ‘rgage_knmi’, ‘disdro’ or ‘disdro_parsivel’
- sensorid:str
The sensor ID.
- location:str
A string identifying the location of the disdrometer
- freq:float
The frequency used to retrieve the polarimetric variables of a disdrometer
- ele:float
The elevation angle used to retrieve the polarimetric variables of a disdrometer
COMPARE_TIME_AVG#
- description
- Creates a scatter plot of average radar dataversus average sensor data.
- parameters
- dpi:int
The pixel density of the plot. Default 72
- sensor:str
The sensor type. Can be ‘rgage’, ‘rgage_knmi’, ‘disdro’ or ‘disdro_parsivel’
- sensorid:str
The sensor ID.
- location:str
A string identifying the location of the disdrometer
- freq:float
The frequency used to retrieve the polarimetric variables of a disdrometer
- ele:float
The elevation angle used to retrieve the polarimetric variables of a disdrometer
- cum_time:float
Data accumulation time [s]. Default 3600.
- base_time:float
Starting moment of the accumulation [s from midnight]. Default 0.
PLOT_AND_WRITE#
- description
- Writes and plots a trajectory time series.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- ymin,ymax: float
The minimum and maximum value of the Y-axis. If none it will be obtained from the Py-ART config file.
PLOT_AND_WRITE_POINT#
- description
- Plots and writes a time series of radar dataat a particular point
- parameters
- dpi:int
The pixel density of the plot. Default 72
- vmin,vmax: float
The limits of the Y-axis. If none they will be obtained from the Py-ART config file.
PLOT_CUMULATIVE_POINT#
- description
- Plots a time series of radar dataaccumulation at a particular point.
- parameters
- dpi:int
The pixel density of the plot. Default 72
- vmin,vmax: float
The limits of the Y-axis. If none they will be obtained from the Py-ART config file.
- ScanPeriod:float
The scaning period of the radar in seconds. This parameter is defined in the ‘loc’ config file
PLOT_HIST#
- description
- plots and writes a histogram of all the data gatheredduring the trajectory processing
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- step:float or None
The quantization step of the data. If None it will be obtained from the Py-ART config file
TRAJ_CAPPI_IMAGE#
- description
- Creates a CAPPI image with the trajectory positionoverplot on it.
- parameters
- voltype:str
name of the pyrad variable to use, it must be available in the dataset
- color_ref:str
The meaning of the color code with which the trajectory is plotted. Can be ‘None’, ‘altitude’ (the absolute altitude), ‘rel_altitude’ (altitude relative to the CAPPI altitude), ‘time’ (trajectory time respect of the start of the radar scan leading to the CAPPI)
- altitude:float
The CAPPI altitude [m]
- wfunc:str
Function used in the gridding of the radar data. The function types are defined in pyart.map.grid_from_radars. Default ‘NEAREST’
- res:float
The CAPPI resolution [m]. Default 500.
WRITE_MULTIPLE_POINTS#
- description
- Writes a csv file containing data frommultiple points obtained from a radar object
TRAJ_ONLY#
TRAJ_MAP#
- description
- Plots the trajectory on a lat-lon map with the altitudecolor coded
TRAJ_PLOT#
- description
- Plots time series of the trajectory respect to the radarelevation, azimuth or range
- parameters
‘datatype’: : str
The : type of parameter: ‘EL’, ‘AZ’, or ‘RANGE’
VPR#
Note
Supports all products of type ‘VOL’
PLOT_VPR_THEO#
- description
- Plots and writes the retrieved theoretical VPR
- parameters
- dpi:int
The pixel density of the plot. Default 72
WRITE_VPR_THEO_PARAMS#
- description
- Writes the parameters of the theoretical VPRin a text file
WRITE_VPR_INFO#
- description
- Writes a dictionary containing relevant parametersof the VPR profile retrieval into a text file
- parameters
- voltype:name of the pyrad variable to use, it must be available
All the products of the ‘VOL’ dataset group