data.GOESGLMGrid¶
NA
Import path: earth2studio.data.GOESGLMGrid
Documentation¶
Gridded GOES GLM (Geostationary Lightning Mapper) lightning product for StormScope.
Wraps GOESGLM (a per-event LCFA source) and accumulates events
into a regular 0.1-degree lat/lon grid via 5-minute binning and 2D
histogramming, matching the GLM grid the StormScope MRMS+GLM nowcast model
was trained on.
Available variables:
glm_density: raw event count per cell (unweighted, matching training).glm_energy_density: summed event energy (J) per cell.
Counts are not mean/std normalized; the StormScope model applies log1p
internally. This source emits raw counts/sums on the 0.1-degree grid; the
model bilinearly regrids to its own native grid.
Parameters:
-
satellite(str, default:'east') –GOES platform selector passed to
GOESGLM("east"default). -
cache(bool, default:True) –Cache downloaded NetCDFs, by default True.
-
verbose(bool, default:True) –Show progress, by default True.
-
async_timeout(int, default:600) –Total timeout in seconds for each fetch operation, by default 600.
-
async_workers(int, default:24) –Maximum number of concurrent S3 fetch tasks, by default 24.
-
retries(int, default:3) –Number of retry attempts per failed fetch task, by default 3.
Note
Grid geometry (must match training): regular 0.1-degree grid over
lat [20, 55] / lon [-130, -60] (350 x 700 cells), with cell centres at
edge + 0.5 * resolution. Output longitudes are returned in the Earth2Studio
[0, 360) convention. The accumulation window is fixed at 5 minutes,
bin-start labeled (the training cadence); do not substitute a 10-minute window.
__call__ ¶
__call__(
time: datetime | list[datetime] | TimeArray,
variable: str | list[str] | VariableArray,
) -> DataArray
Fetch the gridded GLM product for the requested times and variables.
Parameters:
-
time(datetime | list[datetime] | TimeArray) –5-minute-aligned timestamps (UTC). Each labels a
[t, t+5min)bin. -
variable(str | list[str] | VariableArray) –One or more of
"glm_density"/"glm_energy_density".
Returns:
-
DataArray–Array with dims
[time, variable, lat, lon]on the 0.1-degree grid.
fetch
async
¶
fetch(
time: datetime | list[datetime] | TimeArray,
variable: str | list[str] | VariableArray,
) -> DataArray
Async function to fetch the gridded GLM product.
Parameters:
-
time(datetime | list[datetime] | TimeArray) –5-minute-aligned timestamps (UTC). Each labels a
[t, t+5min)bin. -
variable(str | list[str] | VariableArray) –One or more of
"glm_density"/"glm_energy_density".
Returns:
-
DataArray–Array with dims
[time, variable, lat, lon]on the 0.1-degree grid.
