easysnowdata.remote_sensing.get_seasonal_snow_classification#

easysnowdata.remote_sensing.get_seasonal_snow_classification(bbox_input: GeoDataFrame | tuple | BaseGeometry | None = None, mask_nodata: bool = False, **kwargs) → DataArray[source]#

Deprecated since version 0.1.0: easysnowdata.remote_sensing.get_seasonal_snow_classification is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.snow.snow_classification.load instead. The new loader defaults to NSIDC-0768 (Earthdata Login); this shim keeps the hosted COG. The class table is CF flag attrs now.

Fetches 10arcsec (~300m) Sturm & Liston 2021 seasonal snow classification data for a given bounding box.

Deprecated since version 0.1.0: Use easysnowdata.snow.snow_classification.load(). Its default source is the authoritative NSIDC-0768 archive (Earthdata Login, and the coarser grids); this shim keeps reading the hosted COG, whose location is likely to change.

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.

  • mask_nodata (bool, optional) – Whether to mask no data values. Default is False. If False: (dtype=uint8, rio.nodata=9, rio.encoded_nodata=None) If True: (dtype=float32, rio.nodata=nan, rio.encoded_nodata=9)

  • **kwargs – Additional keyword arguments passed to easysnowdata.snow.snow_classification.load() (and on to rioxarray.open_rasterio).

Returns:

xarray.DataArray – Seasonal snow class DataArray with CF flag attributes.

Notes

Data citation: Liston, G. E. and M. Sturm. (2021). Global Seasonal-Snow Classification, Version 1 [Data Set]. Boulder, Colorado USA. National Snow and Ice Data Center. https://doi.org/10.5067/99FTCYYYLAQ0.