metobs_toolkit.dataset.Dataset.get_static_gee_buffer_fraction_data#

Dataset.get_static_gee_buffer_fraction_data(gee_static_manager: GEEStaticDatasetManager, buffers: list = [100], aggregate: bool = False, update_metadata: bool = True, initialize_gee: bool = True) DataFrame[source]#

Extract circular buffer fractions of a GEE dataset at Stations locations.

Retrieve and optionally store static GEE buffer fraction data for the stations. This method interacts with a GEEStaticDatasetManager to fetch buffer fraction data for the station’s location from Google Earth Engine (GEE). The results can be aggregated, stored, and optionally overwrite existing data.

Parameters:
  • gee_static_manager (GEEStaticDatasetManager) – An instance of GEEStaticDatasetManager used to retrieve static GEE data.

  • buffers (list, optional) – A list of buffer radii (in meters) for which to compute the buffer fractions. Default is [100].

  • aggregate (bool, optional) – If True, aggregate the buffer fraction data. Aggregation schemes are stored per ´GEEStaticDatasetManager´. Default is False.

  • update_metadata (bool, optional) – If True, updates existing fraction data stored in the ´Site´ attribute of the ´Station´s. Default is True.

  • initialize_gee (bool, optional) – If True, initialize the GEE environment before retrieving data. Default is True.

Returns:

A DataFrame containing the buffer fraction data for the stations, with the station names as index.

Return type:

pandas.DataFrame

Warning

This method makes use of GEE API. Make sure that you have access and user rights to use the GEE API.

Warning

It can happen that for stations located on small islands, or close to the coast, the sea-mask is not used as a landcover fraction.