easysnowdata.remote_sensing.get_nlcd_landcover#

easysnowdata.remote_sensing.get_nlcd_landcover(bbox_input: GeoDataFrame | tuple | BaseGeometry | None = None, layer: str = 'landcover', initialize_ee: bool = True, **kwargs) → DataArray[source]#

Deprecated since version 0.1.0: easysnowdata.remote_sensing.get_nlcd_landcover is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.land.nlcd.load instead. The new loader defaults to Annual NLCD (1985-2024); this shim keeps the official 2021 release. Class tables are CF flag attrs now.

Fetches National Land Cover Database (NLCD) data for a given bounding box.

Deprecated since version 0.1.0: Use easysnowdata.land.nlcd.load(). Its default source is the Annual NLCD collection (1985-2024, time= selects years); pass source="gee" for the official 2021 release this shim uses.

Parameters:

bbox_input (geopandas.GeoDataFrame or tuple or shapely.Geometry) – GeoDataFrame containing the bounding box, or a tuple of (xmin, ymin, xmax, ymax), or a Shapely geometry.
layer (str, optional) – The NLCD layer to retrieve. Options are: - ‘landcover’ - ‘impervious’ - ‘impervious_descriptor’ - ‘science_products_land_cover_change_count’ - ‘science_products_land_cover_change_first_disturbance_date’ - ‘science_products_land_cover_change_index’ - ‘science_products_land_cover_science_product’ - ‘science_products_forest_disturbance_date’ Default is ‘landcover’.
initialize_ee (bool, optional) – Ignored: Earth Engine is initialised on first use (§2.8).
**kwargs – Additional keyword arguments passed to easysnowdata.land.nlcd.load() (and on to xarray.open_dataset(engine="ee")).

Returns:

xarray.DataArray – NLCD DataArray for the specified region and layer.

Notes

Requires Google Earth Engine authentication; see esd.auth.status().

NLCD data is only available for the contiguous United States
Resolution is 30 meters

Data citation: Dewitz, J., 2023, National Land Cover Database (NLCD) 2021 Products: U.S. Geological Survey data release, doi:10.5066/P9JZ7AO3