mrrpropy 0.3.0

Load, process, plot and analyse METEK MRR-PRO data

mrrpropy is a scientific Python package for working with METEK MRR-PRO radar observations. It provides a high-level API to load raw NetCDF files, run or load RaProMPro products, inspect Doppler spectra, generate quicklooks, and analyse rain microphysical processes.

Quick start API reference

What the package does

  • Load CF/Radial-style MRR-PRO NetCDF files into an MRRProData object.
  • Run the RaProMPro processing workflow or load previously generated products.
  • Plot reflectivity quicklooks, spectra, spectrograms, DSD views and profile diagnostics.
  • Analyse layer-scale rain-process signatures from Dm, Nw and LWC.
  • Classify process evolution on the RGB hexagram using non-parametric trend diagnostics by default.
Quicklook of Ze generated from mrrpropy
Representative reflectivity quicklook produced by the package.

Quick start

The public API is centered on mrrpropy.raw_class.MRRProData. A typical workflow is to open a raw file, load or compute the processed product, and plot one diagnostic field. 

from pathlib import Path

from mrrpropy.raw_class import MRRProData

raw_path = Path("tests/data/RAW/mrrpro81/2025/03/08/20250308_120000_10min.nc")
processed_path = Path("tests/data/PRODUCTS/mrrpro81/2025/03/08/20250308_120000_10min_raprompro.nc")

mrr = MRRProData.from_file(raw_path)

# Fast path if a generated processed product already exists locally
mrr.load_raprompro(processed_path)

# Alternatively, generate a processed dataset into PRODUCTS/
# mrr.process_raprompro(save=False)

fig, ax = mrr.quicklook(variable="Ze", source="raprompro", vmin=0, vmax=40)

Open the full getting started guide

Processing workflow

The package keeps the scientific RaProMPro implementation available while exposing a higher-level, xarray-based interface for processing, diagnostics, and robust microphysical trend analysis. Public velocity outputs and plots use negative values for downward hydrometeor motion.

Open workflow guide

Examples

Examples cover reflectivity quicklooks, Doppler spectrum views and microphysical-process analysis using the current public API.

Open examples

References

The documentation includes the core scientific references for the retained RaProMPro implementation used with METEK MRR-PRO data, together with the related MRR-2 methodology and the original upstream code repository.

Open references

Developer material

Contributor workflow, typing scope and documentation build details remain available, but they are secondary to the user-facing documentation.

Open contributing guide