easysnowdata.remote_sensing.get_forest_cover_fraction#

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

Deprecated since version 0.1.0: easysnowdata.remote_sensing.get_forest_cover_fraction is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.land.forest_cover.load instead. The example_plot attr is gone; the data carries units and a long_name.

Fetches ~100m forest cover fraction data for a given bounding box.

Deprecated since version 0.1.0: Use easysnowdata.land.forest_cover.load(), which masks the 255 sentinel by default and adds the Earth Engine epochs (source="gee", time=).

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=255, rio.encoded_nodata=None) If True: (dtype=float32, rio.nodata=nan, rio.encoded_nodata=255)

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

Returns:

xarray.DataArray – Forest cover fraction DataArray, in percent.

Notes

Data citation: Marcel Buchhorn, Bruno Smets, Luc Bertels, Bert De Roo, Myroslava Lesiv, Nandin-Erdene Tsendbazar, Martin Herold, & Steffen Fritz. (2020). Copernicus Global Land Service: Land Cover 100m: collection 3: epoch 2019: Globe (V3.0.1) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.3939050