earth2studio.data.GOES#

class earth2studio.data.GOES(satellite='goes16', scan_mode='F', max_workers=24, cache=True, verbose=True, async_timeout=600)[source]#

GOES (Geostationary Operational Environmental Satellite) data source.

This data source provides access to GOES-16 and GOES-18 satellite data from AWS S3. The data is exclusively ABI (Advanced Baseline Imager) data for now.

Parameters:

  • satellite (str, optional) – Which GOES satellite to use (‘goes16’ or ‘goes18’), by default ‘goes16’

  • scan_mode (str, optional) – For ABI: Scan mode (‘F’ for Full Disk, ‘C’ for Continental US) Mesoscale data is currently not supported due to the changing scan position.

  • max_workers (int, optional) – Maximum number of workers for parallel downloads, by default 24

  • cache (bool, optional) – Whether to cache downloaded files, by default True

  • verbose (bool, optional) – Whether to print progress information, by default True

  • async_timeout (int, optional) – Timeout for async operations in seconds, by default 600

Note

Beginners Guide to GOES-R Series Data: https://noaa-goes16.s3.amazonaws.com/Beginners_Guide_to_GOES-R_Series_Data.pdf

AWS S3 Bucket: https://aws.amazon.com/marketplace/pp/prodview-ngejrbcumyjtu#usage

ABI Data: - 16 spectral bands (C01-C16):

  • C01, C02 (Visible)

  • C03, C04, C05, C06 (Near IR)

  • C07-C16 (IR)

  • Scan modes:

    • Full Disk (F): Entire Earth view

    • Continental US (C): Continental US (20°N-50°N, 125°W-65°W)

__call__(time, variable)[source]#

Function to get data

Parameters:

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

  • variable (str | list[str] | VariableArray) – String, list of strings or array of strings that refer to variables to return. Must be in the GOES lexicon.

Returns:

Data array containing the requested GOES data

Return type:

xr.DataArray

async fetch(time, variable)[source]#

Async function to get data

Parameters:

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

  • variable (str | list[str] | VariableArray) – Variables to return using standardized names

Returns:

GOES data array

Return type:

xr.DataArray

classmethod available(time, satellite='goes16', scan_mode='F')[source]#

Checks if given date time is available in the GOES object store

Parameters:

  • time (datetime | np.datetime64) – Date time to access

  • satellite (str, optional) – Which GOES satellite to check, by default “goes16”

  • scan_mode (str, optional) – Which scan mode to check, by default “F”

Returns:

If date time is available

Return type:

bool