How to open NEXRAD Level II radar data in a Jupyter notebook without downloading it
Read a Level II volume file with Py-ART: pyart.io.read_nexrad_archive(path) returns a Radar object holding every sweep and field. In a Scigantic notebook the unidata-nexrad-level2 bucket is mounted as a folder, so the path is /mnt/archive/YYYY/MM/DD/SITE/<file> and nothing is downloaded first.
The code on this page runs in a Scigantic hosted notebook, where the dataset is mounted read-only at /mnt/archive. The same path is in the SCIGANTIC_MOUNT_PATH environment variable and linked from ~/archive. The public source is s3://unidata-nexrad-level2 (AWS us-east-1, public, no account needed).
Open NEXRAD Level II on Scigantic
Code
Read one volume and plot the lowest sweep
# Start here: one full radar volume from the Utah radar, read off the mount.
# Change PLACE to any town within about 200 km of the radar.
import os, time
import numpy as np
import matplotlib.pyplot as plt
import pyart
%config InlineBackend.figure_formats = ["jpeg"]
%config InlineBackend.print_figure_kwargs = {"pil_kwargs": {"quality": 70}}
plt.rcParams["figure.dpi"] = 80
ROOT = os.environ.get("SCIGANTIC_MOUNT_PATH", "/mnt/archive")
SITE = "KMTX" # Promontory Point, Utah
VOLUME = "2026/08/31/KMTX/KMTX20260831_235948_V06"
PLACE = ("Ogden", 41.223, -111.973)
t = time.time()
radar = pyart.io.read_nexrad_archive(os.path.join(ROOT, VOLUME))
print(f"read {VOLUME} in {time.time() - t:.1f} s: {radar.nsweeps} sweeps, fields: {', '.join(sorted(radar.fields))}")
name, plat, plon = PLACE
display = pyart.graph.RadarDisplay(radar)
fig, ax = plt.subplots(figsize=(8, 7))
display.plot("reflectivity", 0, ax=ax, vmin=-10, vmax=65, cmap="ChaseSpectral",
title=f"{SITE} lowest sweep reflectivity, 2026-08-31 23:59 UTC", colorbar_label="dBZ")
display.set_limits(xlim=(-150, 150), ylim=(-150, 150), ax=ax)
# The place, in km east and north of the radar.
x, y = pyart.core.geographic_to_cartesian_aeqd(plon, plat, radar.longitude["data"][0], radar.latitude["data"][0])
ax.plot(x / 1000, y / 1000, "k^", ms=9)
ax.annotate(name, (x[0] / 1000, y[0] / 1000), xytext=(6, 6), textcoords="offset points", fontsize=11)
plt.show()
s = radar.get_slice(0)
dbz = radar.fields["reflectivity"]["data"][s]
glat, glon = radar.gate_latitude["data"][s], radar.gate_longitude["data"][s]
near = (np.hypot((glat - plat) * 111.2, (glon - plon) * 111.2 * np.cos(np.radians(plat))) < 15) & ~np.ma.getmaskarray(dbz)
print(f"within 15 km of {name}: max {dbz[near].max():.1f} dBZ, {int((dbz[near] > 30).sum()):,} gates above 30 dBZ (moderate rain)")
Copied from this dataset's starter notebook on Scigantic, the one that opens when you start a notebook from the archive page (one cell, unchanged).
What the files are
Level II is the base data of the US WSR-88D weather radar network: every sweep at full resolution (250 m gates, 0.5 degree beams) with reflectivity, Doppler velocity, spectrum width and the three dual-polarization fields.
One file is one volume, the full set of sweeps a radar makes in about five minutes, starting at its lowest tilt and stepping up. Level III, a separate archive, holds the derived products made from these files.
How the files are laid out
| Path under the mount | What it holds |
|---|---|
| YYYY/MM/DD/SITE/ | One folder per day and radar. SITE is the four-letter ICAO code, for example KMTX (Promontory Point, Utah) or KTLX (Oklahoma City). |
| SITEYYYYMMDD_HHMMSS_V06 | One volume. The name carries the radar and the UTC start time of the scan. |
| ..._MDM | Small metadata messages, not volumes. Skip them when listing a folder. |
Size, format and license
| Format | NEXRAD Level II archive files (binary), read with Py-ART or MetPy |
|---|---|
| Size | About 160 radars, with data back to 1991. One radar-day is about 2 GB: KMTX wrote 225 volumes of 5 to 15 MB each on 2026-08-31. |
| License | Custom; see the provider documentation linked from the archive page |
| Provider | Unidata, on AWS Open Data |
| Public source | s3://unidata-nexrad-level2 (AWS us-east-1, public, no account needed) |
| Notebook image | Geospatial (Py-ART, MetPy and cartopy preinstalled) |
Things to know before you read it
- List one day and radar folder at a time. The bucket is too large to walk.
pyart.io.read_nexrad_archive(path, scans=[0, 1])reads only the sweeps you name, which is faster when you need the lowest tilts.- New volumes reach the bucket within a few minutes of the sweep, so listing today's folder for a radar gives the current scan.
Run it
Start a notebook from the NEXRAD Level II archive page. The data is mounted when the notebook opens, so the code above runs as written and nothing is downloaded first.
Related guides
- How to read NEXRAD Level III products in Python in a Jupyter notebook
- How to open ECMWF IFS S2S reforecasts stored as Icechunk in a Jupyter notebook
- How to open OME-Zarr volumes in a Jupyter notebook
- How to query 1000 Genomes VCF files on S3 from a Jupyter notebook
Last checked 2026-11-21. All dataset guides.