API Reference

spatiotemporal_data_library.fetch_data(dataset_short_name: str, variables: List[str], start_time: str | datetime, end_time: str | datetime, bbox: List[float] = None, point: List[float] = None, **kwargs) → xarray.Dataset[source]

Fetch spatiotemporal data from a specified dataset and return a standardized xarray.Dataset.

Supports ERA5, PO.DAAC (CYGNSS, OSCAR), SMAP RSS, SFMR, etc. via a unified interface.

Parameters:

  • dataset_short_name (str) – Short name of the dataset (e.g., “ECMWF_ERA5”, “NOAA_CYGNSS_L2_V1.2”).

  • variables (list[str]) – List of standardized variable names to fetch.

  • start_time (str or datetime.datetime) – Start time (ISO string or datetime object).

  • end_time (str or datetime.datetime) – End time (ISO string or datetime object).

  • bbox (list[float], optional) – Geographic bounding box [min_lon, min_lat, max_lon, max_lat].

  • point (list[float], optional) – Single point [lon, lat].

  • **kwargs – Adapter-specific parameters (e.g., pressure_level, storm_name, mission_id, etc.).

Returns:

Standardized dataset containing the requested variables and coordinates.

Return type:

xarray.Dataset

Raises:

  • ValueError – If the dataset_short_name is not supported.

  • Exception – For any errors during data fetching or processing.

Example

>>> ds = fetch_data(
...     dataset_short_name="ECMWF_ERA5",
...     variables=["10m_u_component_of_wind", "10m_v_component_of_wind"],
...     start_time="2023-01-01T00:00:00Z",
...     end_time="2023-01-01T03:00:00Z",
...     bbox=[-5, 50, 0, 52]
... )
>>> print(ds)