API Reference#

Use this reference when you want the exact signature, parameters, return values, and class interfaces for arl-met. Most workflows start with open_dataset(), write_dataset(), extract_subset(), or sample_points().

High-Level I/O#

open_dataset

Open an ARL meteorology file as an xarray Dataset.

write_dataset

Write a simple flat Dataset representation to an ARL file.

Cropping And Sampling#

extract_subset

Extract a spatial/vertical subset from an ARL file into a new ARL file.

sample_points

Sample meteorological variables at arbitrary (lon, lat, z, time) points.

Low-Level File Model#

File

Read or write an ARL meteorology file.

RecordSet

Records for one valid time within an ARL file.

DataRecord

One ARL data record representing a single 2D variable slice.

Grid And Vertical Metadata#

Projection

Horizontal projection metadata from an ARL index record.

Grid

Two-dimensional horizontal grid definition for ARL data.

VerticalAxis

Vertical coordinate metadata for an ARL file.

Binary Metadata And Packing#

Header

Fixed-width 50-byte header present at the start of every ARL record.

IndexRecord

Index record describing one ARL time step and its contained variables.

calculate_checksum

Compute the ARL checksum for a packed payload.

pack

Pack a 2D field using the ARL differential byte encoding.

unpack

Unpack an ARL differential byte stream into a 2D field.

Remote Archive Sources#

MeteorologySource

Abstract base class for NOAA ARL meteorological archive sources.

HRRRSource

HRRR 3 km analysis (CONUS, June 2019–present).

HRRRv1Source

HRRR 3 km analysis, version 1 (CONUS, June 2015–2019).

NAMSource

NAM 12 km analysis (North America, May 2007–present).

NAMSSource

NAMS hybrid sigma-pressure analysis (CONUS/Alaska/Hawaii, 2010–present).

GDASSource

GDAS 1-degree global analysis (December 2004–present).

GDAS0p5Source

GDAS 0.5-degree global analysis (September 2007–mid 2019).

GFSSource

GFS 0.25-degree global analysis (June 2019–present).

NARRSource

NCEP North American Regional Reanalysis (January 1979–2019).

ReanalysisSource

NCEP/NCAR Reanalysis 2.5-degree global (1948–present).