arlmet.open_dataset#

arlmet.open_dataset(filename_or_obj, drop_variables=None, bbox=None, levels=None)[source]#

Open an ARL meteorology file as an xarray Dataset.

Surface-only variables (e.g. SHGT, T02M, PRSS) have dimensions (time, lat, lon) with no level dimension. Upper-air variables (e.g. UWND, VWND, TEMP) have dimensions (time, level, lat, lon). There is no NaN padding.

ARL metadata is accessible via the .arl accessor:

ds = arlmet.open_dataset("met.arl")
ds.arl.grid  # Grid object (survives isel/sel)
ds.arl.vertical_axis  # VerticalAxis
ds.isel(level=0)  # selects level 0 for upper vars; sfc vars unchanged
Parameters:

  • filename_or_obj (path-like) – Path to the ARL file.

  • drop_variables (iterable of str, optional) – Variable names to omit from the resulting dataset.

  • bbox (tuple[float, float, float, float], optional) – Geographic bounding box (west, south, east, north) in degrees.

  • levels (list[int] or tuple[int, ...], optional) – ARL level indices to keep.

Return type:

xarray.Dataset