easysnowdata.land.nlcd.load#

easysnowdata.land.nlcd.load(aoi: Any = None, *, source: str | None = None, layer: str = 'landcover', time: Any = None, chunks: Any = 'easysnowdata-default', mask: bool = False, **kwargs: Any) → DataArray[source]#

Load one NLCD layer for aoi on the asset’s native 30 m Albers grid.

Parameters:

  • aoi – Any form easysnowdata.aoi.parse_aoi() accepts. NLCD covers CONUS.

  • source – "gee-annual" (default; Annual NLCD 1985-2024) or "gee" (the official 2021 release, which has the science products).

  • layer – For the annual route one of ANNUAL_ASSETS, for the release one of RELEASE_LAYERS.

  • time – Any form easysnowdata.temporal.parse_time() accepts. None (default) returns the newest year as a 2-D map with the year as a scalar coordinate; a range keeps the time dimension.

  • chunks – Dask chunks; None loads eagerly.

  • mask – False (default, §2.5 for categorical products) keeps the source values; True masks the layer’s nodata to NaN.

  • **kwargs – Passed to xarray.open_dataset(engine="ee").

Returns:

xarray.DataArray – The layer on its native grid (dims y/x, plus time when a range was asked for), with CF flag attributes when the asset ships a class table.

Raises:

easysnowdata.auth.CredentialError – When Earth Engine is not configured.