easysnowdata.remote_sensing.get_esa_worldcover#

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

Deprecated since version 0.1.0: easysnowdata.remote_sensing.get_esa_worldcover is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.land.landcover.load instead. The class table is now CF flag attrs (esd.plotting.categorical draws them); the class_info, cmap and example_plot attrs are gone.

Fetches 10m ESA WorldCover global land cover data (2020 v100 or 2021 v200) for a given bounding box.

Deprecated since version 0.1.0: Use easysnowdata.land.landcover.load(), which adds the unsigned AWS bucket (source="aws-open-data") and carries the class table as CF flag attributes.

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.

  • version (str, optional) – Version of the WorldCover data. The two versions are v100 (2020) and v200 (2021). Default is ‘v200’.

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

  • **kwargs – Additional keyword arguments passed to easysnowdata.land.landcover.load() (and on to odc.stac.load).

Returns:

xarray.DataArray – WorldCover DataArray with CF flag attributes.

Notes

Data citation: Zanaga, D., Van De Kerchove, R., De Keersmaecker, W., Souverijns, N., Brockmann, C., Quast, R., Wevers, J., Grosu, A., Paccini, A., Vergnaud, S., Cartus, O., Santoro, M., Fritz, S., Georgieva, I., Lesiv, M., Carter, S., Herold, M., Li, Linlin, Tsendbazar, N.E., Ramoino, F., Arino, O. (2021). ESA WorldCover 10 m 2020 v100. doi:10.5281/zenodo.5571936.