Nexrad Mosaic Access

NEXRAD Mosaic Access

Overview

Retrieve an existing NOAA/NCEP Multi-Radar/Multi-Sensor (MRMS) product without confusing it with a single NEXRAD volume or a locally constructed mosaic. MRMS provides timestamped 2D radar-only and multisensor products for regional analysis. Select the exact product, domain, time, and file before downloading, then validate the decoded grid and provenance. This skill covers access to existing MRMS products; it does not build a custom multi-radar composite.

Use nexrad-product-access when the user needs one radar site's Level II or Level III data. Use this skill when the requested object is already a mosaic or multisensor analysis such as QPE, VIL, VII, or MESH.

When to Use This Skill

• Access an official NEXRAD-derived national or regional mosaic.
• Retrieve MRMS radar-derived or multisensor precipitation products.
• Access VIL, VII, MESH, or MultiSensor QPE for a specified UTC time.
• Obtain a completed product for mapping or analysis without downloading every contributing radar volume.
• Compare mosaic products while preserving product identity, generation time, domain, and grid metadata.

Do not use this skill for a single-site sweep, a Level II moment, or a custom mosaic that must be constructed from several radars. Route those tasks to nexrad-product-access or a dedicated mosaicking workflow.

Official MRMS 2D Access

NOAA/NCEP exposes the 2D product archive at:

https://mrms.ncep.noaa.gov/2D/

The public index includes directories such as:

https://mrms.ncep.noaa.gov/2D/MultiSensor_QPE_01H_Pass1/
https://mrms.ncep.noaa.gov/2D/VIL/
https://mrms.ncep.noaa.gov/2D/VII/
https://mrms.ncep.noaa.gov/2D/MESH/

These are representative examples, not a complete product catalog. NOAA/NSSL describes the MRMS suite as containing 100+ products; available products and distribution formats vary by product, version, domain, and feed. Consult the current NOAA/NSSL MRMS overview, product guide, and live NCEP index rather than treating this short list as an allowlist.

Directories can contain a convenience link such as MRMS_<Product>.latest.grib2.gz and timestamped compressed GRIB2 files. Some products may also have regional directories such as CONUS, GUAM, or CARIB; verify the selected product directory rather than assuming a domain.

For reproducible analysis, prefer an exact timestamped file. Use the latest link only for a live snapshot, then record the exact timestamp, URL, redirect target if any, content length, and retrieval time.

Choose the Composite Product

Do not select a directory from a color image or a familiar abbreviation alone. Read the current product description and metadata enough to confirm:

• product name and version;
• whether it is radar-only, multisensor, gauge corrected, or analysis based;
• accumulation or integration period;
• valid or scan time semantics;
• update cadence and latency;
• spatial domain and grid;
• missing, no-data, and quality semantics;
• units, scale, and packed-data representation.

Important distinctions include:

• QPE: accumulated precipitation estimate, not a reflectivity image.
• VIL: vertically integrated liquid from radar structure, not surface rain rate or hail mass.
• VII: vertically integrated ice from radar structure, not total precipitation.
• MESH: maximum expected size of hail for the product interval, not the current cloud-top temperature or a verified hail observation.

Use the current product documentation to confirm exact meaning. Do not infer a product from its directory name alone.

Define the Mosaic Request

Record:

• exact MRMS product and version;
• national, regional, or other available domain;
• exact valid time or bounded historical interval;
• latest or timestamped-file policy;
• variables, units, accumulation period, and quality fields;
• desired geographic crop and output grid policy;
• maximum lookback, file-size limit, and acceptable latency;
• whether the product is being treated as official mosaic truth, an analysis input, or a comparison target;
• required provenance and artifact policy.

If the user requests one storm's single-radar structure, this is the wrong skill. A mosaic is useful for broad coverage and regional products but can obscure site-level vertical or velocity structure.

Access Workflow

1. Open or list the documented product directory under /2D/.
2. Match the exact product, domain, and timestamp policy.
3. Select an exact timestamped compressed GRIB2 file for retrospective work.
4. For latest, follow the convenience link only after recording the final URL and resolving its timestamped identity.
5. Request file metadata with a bounded HTTP HEAD or equivalent read-only check when the server supports it.
6. Download to a request-owned temporary path without executing content from the server path.
7. Verify received size and a provider checksum when present; otherwise compute and record a local SHA-256.
8. Decompress the .gz into a new temporary .grib2 file. Do not decompress in place over a shared cache entry.
9. Open the GRIB2 with a format-aware decoder and verify product, reference time, forecast or valid time, grid, variables, units, and missing values.
10. Promote the verified product and record its source identity.

Keep compressed bytes, decoded values, and any reprojected or cropped artifact as separate stages with separate hashes or identities.

Handle Latest and Historical Time Correctly

latest is a moving convenience name. A later request can return different bytes even though its URL is unchanged. For analysis and publication:

• resolve latest to the actual timestamped file;
• record retrieval time and product valid or scan time separately;
• use the timestamped file for replay;
• do not use the latest URL as immutable provenance;
• report latency between product time and retrieval time.

If the directory contains multiple passes, revisions, or accumulation windows, select the exact contract required by the task. Do not choose the newest file merely because its name sorts last.

Validate the Mosaic Grid

Before interpreting or plotting, verify:

• domain and expected geographic extent;
• projection or GRIB coordinate definition;
• x/y orientation and scan mode;
• latitude and longitude coordinates after decoding;
• cell size, dimensions, and row or column ordering;
• time coordinate, units, and interval semantics;
• no-data, missing, and quality values;
• packed scale and offset or other calibration;
• consistency with the product's documented grid contract.

Do not transpose, flip, or relabel a grid based on visual appearance alone. A plausible-looking map can still be spatially reversed or attached to the wrong time.