Products#
DISDRODB transforms raw disdrometer data into standardized products through a sequential processing chain, from sensor output to physically meaningful microphysical and radar-derived quantities.
Each product has a well-defined scope, quality-control procedures, and output format. This uniform structure across all stations enables reproducible analysis and consistent downstream processing.
The processing chain is fully customizable. See the Products Configuration for more details.
DISDRODB L0A Product#
The DISDRODB L0A product converts heterogeneous raw disdrometer files into a standardized tabular dataset.
- Purpose
Transform raw text files into cleaned, DISDRODB-compliant data.
- Input
Raw disdrometer text files
Optional issue files defining problematic time periods
- Description
A station-specific reader function (specified in metadata) processes raw files to produce a tabular dataset where each row is a measurement timestep and each column is a logged variable following DISDRODB naming conventions.
Array variables (particle spectra, velocity-diameter distributions) are stored as delimited strings, later reshaped into multidimensional arrays in L0B.
- Quality Control
Removes rows with missing or duplicated timestamps
Excludes periods flagged in issue files
Converts corrupted numeric entries to NaN
Enforces data types and valid ranges
Logs all detected issues
- Output
L0A dataset in Apache Parquet format
Variables depend on sensor type; raw spectrum always included
Detailed processing logs
DISDRODB L0B Product#
The DISDRODB L0B product converts tabular L0A data into the netCDF4 data model.
- Purpose
Provide a self-describing dataset with explicit physical dimensions and standardized metadata.
- Input
L0A dataset
- Description
The L0B processing:
Parses string-encoded arrays into numerical arrays
Constructs an
xarray.Datasetwith dimensions:time,diameter_bin_center, andvelocity_bin_center(when available)Adds bin centers and bounds for diameter and velocity
Attaches station geolocation (longitude, latitude, altitude)
- Metadata
Climate and Forecast (CF) compliant variable attributes
Attribute Convention for Data Discovery (ACDD) global attributes
Optimized NetCDF encodings to minimize disk usage
- Output
NetCDF4 files suitable for scientific analysis
Variables depend on sensor type; raw spectrum always included
DISDRODB L0C Product#
The DISDRODB L0C product ensures temporal consistency and consolidates L0B files into fixed-period outputs (daily by default; configurable as weekly or monthly).
- Purpose
Create time-consistent datasets with fixed measurement intervals, unique timesteps, and standardized file grouping.
- Description
The L0C processing:
Removes duplicated timesteps from file concatenation
Discards measurements with inconsistent intervals
Separates data into distinct datasets if multiple measurement intervals exist
Corrects small timestamp drifts to exact interval boundaries
Stores the verified measurement interval as a coordinate
- Quality Control
Computes
qc_timeto assess temporal continuityLogs irregular sampling patterns and intermittent measurements
- Output
Time-consistent L0C datasets grouped by fixed periods
Variables depend on sensor type; raw spectrum always included
For configuration options, see DISDRODB L0C Product Configuration.
DISDRODB L1 Product#
The DISDRODB L1 product aggregates observations at multiple temporal resolutions and performs hydrometeor classification. Starting from the DISDRODB L1 product, all stations have the same variables and data structure. The DISDRODB L1 product serves as a common foundation for existing and future DISDRODB L2 products.
Temporal Resampling#
- Purpose
Aggregate particle spectra and auxiliary variables to user-defined temporal resolutions.
- Features
Fixed-interval and rolling-window aggregation
Typical resolutions: 1, 5, and 10 minutes
Rolling windows reduce data loss and increase sample density
- Quality Control
qc_resamplingreports the fraction of missing data within each window
Hydrometeor Classification#
- Purpose
Identify the dominant hydrometeor type and precipitation phase at each timestep.
- Description
Operates on the diameter-velocity particle spectrum
Applies sensor-specific noise filtering
Uses physically based size-velocity masks
Adjusts fall-velocity relationships for air density (altitude)
Optionally refines classification using temperature
- Output
Hydrometeor and precipitation-type labels
Classification-related quality-control flags
For configuration options, see DISDRODB L1 Product Configuration.
DISDRODB L2E Product (Empirical)#
The DISDRODB L2E product derives microphysical parameters and radar observables directly from observed particle spectra. Currently, L2E provides geophysical quantities for rainfall observations only. The default DISDRODB L2E configuration process only timesteps with precipitation, resulting in temporally discontinuous data.
- Purpose
Compute integral drop size distribution (DSD) parameters and simulate polarimetric radar variables for rainfall.
- Description
Selects liquid precipitation timesteps
Filters particles by diameter and fall-velocity
Estimates drop number concentration
Computes DSD moments and rainfall variables
Simulates polarimetric radar observables via T-matrix
- Customization
User-defined thresholds on minimum particle counts, populated bins, and rain rate
User-defined spectrum filtering criteria
For configuration options, see DISDRODBL2E Product Configuration.
DISDRODB L2M Product (Modelled)#
The DISDRODB L2M product fits parametric DSD models to observed drop number concentrations from L2E and derives microphysical and radar variables from the fitted distributions. The default DISDRODB L2E configuration process only timesteps with precipitation, resulting in temporally discontinuous data.
- Purpose
Support microphysical studies, radar retrieval development, and model evaluation.
- Description
Fits multiple parametric DSD models (lognormal, exponential, gamma, generalized gamma, and normalized variants)
Supports grid search, maximum likelihood, and method-of-moments estimation
Computes goodness-of-fit diagnostics
Derives integral DSD parameters and radar observables from modeled DSDs
- Applications
Evaluation of bulk microphysics parameterizations
Development and validation of radar-based DSD retrievals
For configuration options, see DISDRODB L2M Product Configuration and L2M Models Configuration.
Polarimetric Radar Variables#
Polarimetric radar variables are simulated using electromagnetic scattering calculations based on the T-matrix method. pytmatrix must be installed to enable radar simulations (see pytmatrix installation).
For configuration options, see DISDRODB Radar Configuration Options.
- Features
Compatible with L2E (empirical) and L2M (modeled) products
Simulates reflectivity, attenuation, phase, and polarimetric variables
Flexible configuration of radar and microphysical assumptions
Parallelized execution with caching for efficiency