Skip to content

data.HimawariAHI

ASAU

Import path: earth2studio.data.HimawariAHI

View source on GitHub

Documentation

Himawari-8/9 AHI (Advanced Himawari Imager) data source.

This data source provides access to Himawari-8 and Himawari-9 satellite imagery from the NOAA ISatSS L2 Full Disk product on AWS S3. The data uses the same geostationary fixed grid projection as GOES, with the satellite positioned at 140.7°E.

Each AHI channel is stored as tiled NetCDF files (88 tiles per channel). Higher-resolution channels (C01/C02/C04 at 1 km, C03 at 0.5 km) are downsampled to the 2 km grid via block averaging, producing a uniform 5500×5500 pixel Full Disk output for all 16 channels.

Parameters:

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

    Which Himawari satellite to use ('himawari8' or 'himawari9'), by default 'himawari9'

  • lat_lon_bbox (tuple[float, float, float, float] | None, default: None ) –

    Bounding box (lat_min, lon_min, lat_max, lon_max) in degrees to crop the full-disk image. Only tiles that overlap the requested region are downloaded. When None the full disk is returned, by default None

  • cache (bool, default: True ) –

    Cache data source on local memory, by default True

  • verbose (bool, default: True ) –

    Print download progress, by default True

  • async_timeout (int, default: 600 ) –

    Total timeout in seconds for the entire fetch operation, by default 600

  • async_workers (int, default: 32 ) –

    Maximum number of concurrent async fetch tasks. Fetches are many small tile objects, so throughput is round-trip-latency bound; by default 32

  • retries (int, default: 3 ) –

    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. Each full disk image consists of 88 tile files per channel.

Note

Additional information on the data repository:

__call__ 

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

Function to get Himawari AHI data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) –

    Timestamps to return data for (UTC). Timezone-aware datetimes are converted to UTC automatically.

  • variable (str | list[str] | VariableArray) –

    String, list of strings or array of strings that refer to variables to return. Must be in the Himawari lexicon (ahi01-ahi16).

Returns:

  • DataArray –

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

fetch async 

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

Async function to get Himawari AHI data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) –

    Timestamps to return data for (UTC).

  • variable (str | list[str] | VariableArray) –

    Variables to return using standardized names (ahi01-ahi16).

Returns:

  • DataArray –

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

available classmethod 

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

Check if given date time is available in the Himawari object store.

Performs a lightweight S3 listing to verify that data files actually exist for the requested time, accounting for potential data gaps.

Parameters:

  • time (datetime | datetime64) –

    Date time to check

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

    Which satellite to check, by default 'himawari9'

Returns:

  • bool –

    If date time is available