SciganticGuidesTopicsExplore

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 mountWhat 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_V06One volume. The name carries the radar and the UTC start time of the scan.
..._MDMSmall metadata messages, not volumes. Skip them when listing a folder.

Size, format and license

FormatNEXRAD Level II archive files (binary), read with Py-ART or MetPy
SizeAbout 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.
LicenseCustom; see the provider documentation linked from the archive page
ProviderUnidata, on AWS Open Data
Public sources3://unidata-nexrad-level2 (AWS us-east-1, public, no account needed)
Notebook imageGeospatial (Py-ART, MetPy and cartopy preinstalled)

Things to know before you read it

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

Last checked 2026-11-21. All dataset guides.