Skip to content

data.GOES

NA

Import path: earth2studio.data.GOES

View source on GitHub

Documentation

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, default: 'goes16' ) –

    Which GOES satellite to use ('goes16', 'goes17', 'goes18', or 'goes19'), by default 'goes16'

  • scan_mode (str, default: 'F' ) –

    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, default: 24 ) –

    Maximum number of workers for parallel downloads, by default 24

  • cache (bool, default: True ) –

    Whether to cache downloaded files, by default True

  • verbose (bool, default: True ) –

    Whether to print progress information, by default True

  • async_timeout (int, default: 600 ) –

    Timeout for async operations in seconds, by default 600

Note

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

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

ABI Data:

  • 16 spectral bands (abi01c-abi16c):

    • abi01c, abi02c (Visible: Blue, Red)
    • abi03c-abi06c (Near IR: Vegetation, Cirrus, Snow/Ice, Cloud particles)
    • abi07c-abi16c (IR: Thermal and water vapor channels)

  • Scan modes:

    • Full Disk (F): Entire Earth view
    • Continental US (C): Continental US (20°N-50°N, 125°W-65°W)

__call__ 

__call__(
    time: datetime | list[datetime] | TimeArray,
    variable: str | list[str] | VariableArray,
) -> DataArray

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:

  • DataArray –

    Data array containing the requested GOES data

fetch async 

fetch(
    time: datetime | list[datetime] | TimeArray,
    variable: str | list[str] | VariableArray,
) -> DataArray

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:

available classmethod 

available(
    time: datetime | datetime64,
    satellite: str = "goes16",
    scan_mode: str = "F",
) -> bool

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

Parameters:

  • time (datetime | datetime64) –

    Date time to access

  • satellite (str, default: 'goes16' ) –

    Which GOES satellite to check, by default "goes16"

  • scan_mode (str, default: 'F' ) –

    Which scan mode to check, by default "F"

Returns:

  • bool –

    If date time is available