NEXRAD Radar Visualization

Overview

Create scientifically legible plots from verified NEXRAD single-site products and decoded radar mosaics. Preserve site or domain, product, observation or valid time, units, geometry, quality masking, and color meaning so a visually compelling image cannot hide a wrong quantity or misleading spatial interpretation.

Use this skill after nexrad-product-access or another trusted source has provided a decoded site product. Use nexrad-mosaic-access to retrieve an official MRMS composite before plotting it. This skill does not discover or download radar files.

When to Use This Skill

• Plot base reflectivity, radial velocity, spectrum width, or another decoded Level II moment for one NEXRAD site.
• Plot a Level III product selected by product code and scan time.
• Plot a decoded NOAA/NCEP MRMS or other documented NEXRAD-derived gridded composite while preserving its grid, coverage, and product semantics.
• Create a lowest-elevation PPI, a specified-elevation PPI, or a sweep chosen for a target height.
• Plot dual-polarization moments with appropriate units and masks.
• Create RHI, cross-section, tilt, storm-relative, or multi-sweep views.
• Build a time sequence or animation from a verified scan series.
• Export the plot with a stable color scale, map context, metadata, and provenance.

Do not use a plot to hide a missing sweep, unverified product, invalid gate mask, geolocation error, or unsupported extrapolation.

Define the Visualization Contract

Record:

• radar site and site coordinates;
• data level and exact product or moment;
• observation, volume, or product time in UTC;
• source identity and local content hash when required;
• intended view: PPI, RHI, cross-section, tilt, comparison, or animation;
• sweep or angle policy;
• map projection, bounds, range rings, and landmark context;
• physical units, color scale, display range, and normalization policy;
• invalid, missing, folded, clutter, or otherwise masked gates;
• for gridded mosaics, the provider, product/domain, grid projection and orientation, valid-time semantics, and source/coverage or quality fields;
• output format, dimensions, background, and whether figures are for analysis or publication.

If the user asks only for “a radar image,” produce a useful default: a single-site PPI with site marker, UTC time, product, units, color bar, range rings, and missing-data treatment visible. For a decoded mosaic, use a map view with the product, domain, valid time, units, legend, and missing-data treatment visible. Ask only when product, site/domain, or time would materially change the result and cannot be inferred safely.

Validate Before Plotting

1. Confirm the decoded site, product or moment, time, units, dimensions, and projection.
2. Apply scale, offset, calibration, fill values, and quality flags before interpolation, contouring, or thresholding.
3. Confirm that the requested sweep exists. For a target-height sweep, compute or obtain beam height as a function of range and show which elevation is nearest.
4. Preserve no-data and invalid-data cells as masked values. Do not replace them with zero, minimum reflectivity, or an opaque background that resembles weak echo.
5. Confirm that map coordinates and radar polar coordinates share the correct projection and origin.
6. Record whether velocity is dealiased and whether dual-polarization fields have their documented quality masks.

Plot a PPI

For a plan-position indicator:

1. Select the requested sweep or the lowest usable sweep under a stated policy.
2. Convert range and azimuth to the selected map projection.
3. Mask invalid, below-threshold display, folded, clutter-contaminated, and missing gates according to an explicit policy.
4. Render the measured product with a documented, perceptually ordered color scale appropriate to the quantity.
5. Overlay radar location, requested site label, range rings or distance scale, north arrow when orientation could be ambiguous, and optional geographic context.
6. Put product, site, UTC time, units, sweep or product code, range, and color bar in the figure itself.

For reflectivity, do not imply that every dBZ color boundary is a categorical precipitation type. Keep the measured reflectivity label visible and put any rain-rate relation in a separate, explicitly derived layer.

For velocity, use a diverging scale centered on zero unless the product's

…