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.

File Operations#

Transform ARL files: crop a subset, sample at points, or join files together. See the Cropping ARL Data, Sampling Points, and Concatenating ARL Files guides.

`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.
`concat`	Concatenate multiple ARL files into a single ARL file.
`concat_by_time`	Group every ARL file in a directory by valid time and concatenate each group.

Vertical Coordinates#

Derive pressure and height coordinates from an open Dataset. See the Vertical Coordinates guide for coordinate-system details and limitations.

`pressure`	Pressure (hPa) at each level.
`z_agl`	Height above ground level (m) at each level.
`z_msl`	Height above mean sea level (m) at each level.

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`	Abstract base class for ARL vertical coordinate axes.

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).