MeteosatFCI#

class earth2studio.data.MeteosatFCI(
resolution='2km',
lat_lon_bbox=None,
cache=True,
verbose=True,
async_timeout=1200,
retries=3,
)[source]#
EUAF

EUMETSAT MTG-I FCI Level-1C Full Disk calibrated radiance data source.

This data source provides access to Meteosat Third Generation (MTG) Flexible Combined Imager (FCI) Level-1C Full Disk products via the EUMETSAT Data Store. The 12 spectral channels cover visible, near-IR, water-vapour and infrared bands at 1 km or 2 km nadir resolution.

Parameters:

  • resolution (str, optional) – Grid resolution, either '2km' or '1km', by default '2km'

  • lat_lon_bbox (tuple[float, float, float, float] | None, optional) – Bounding box (lat_min, lon_min, lat_max, lon_max) in degrees to crop the full-disk image. Only BODY segments that overlap the requested latitude range are read, saving disk and memory. When None the full disk is returned, by default None

  • cache (bool, optional) – Cache data source on local memory, by default True

  • verbose (bool, optional) – Print download progress, by default True

  • async_timeout (int, optional) – Total timeout in seconds for the entire fetch operation, by default 1200

  • retries (int, optional) – Number of retry attempts per failed fetch task with exponential backoff, by default 3

Warning

This is a remote data source and can potentially download a large amount of data to your local machine for large requests.

Note

Requires EUMETSAT Data Store credentials. Set the following environment variables:

  • EUMETSAT_CONSUMER_KEY: Your EUMETSAT API consumer key

  • EUMETSAT_CONSUMER_SECRET: Your EUMETSAT API consumer secret

Register at https://eoportal.eumetsat.int/ to obtain credentials.

Note

Additional information on the data repository:

__call__(time, variable)[source]#

Retrieve MTG FCI data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) – Timestamps to return data for (UTC).

  • variable (str | list[str] | VariableArray) – Variables to return. Must be in the MeteosatFCILexicon.

Returns:

Data array with dimensions [time, variable, y, x].

Return type:

xr.DataArray

async fetch(time, variable)[source]#

Async function to retrieve MTG FCI data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) – Timestamps to return data for (UTC).

  • variable (str | list[str] | VariableArray) – Variables to return.

Returns:

Data array with dimensions [time, variable, y, x].

Return type:

xr.DataArray

classmethod available(time)[source]#

Check if a given date time is available.

Parameters:

time (datetime | np.datetime64) – Date time to check

Returns:

If date time is available

Return type:

bool