mrrpropy 0.1.1

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.

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