Wildfire-FM / models /wildfire_fm /input_channels.json
yx21e's picture
Clarify WildFIRE-FM validity mask channels
4e0c49c verified
Raw
History Blame Contribute Delete
7.64 kB
{
"tensor_order": "[channel, y, x]",
"channel_order_matters": true,
"value_normalization": {
"applied": false,
"description": "The released checkpoints expect the same native physical units used during training. No mean/std normalization, min/max scaling, or unit conversion is applied to input values before inference.",
"missing_or_invalid_values": "Training replaces values <= -9000, NaN, +inf, and -inf with 0.0. The fixed input also carries dynamic and static validity-mask channels."
},
"grid": {
"region": "California",
"crs": "EPSG:5070",
"resolution_m": 5000,
"target_lead_hours": 12
},
"dynamic_weather_source": {
"dataset": "NOAA HRRR",
"product": "wrfsfcf00",
"forecast_hour": "f00",
"issue_hours_utc": [0, 6, 12, 18],
"reprojection": "Nearest-neighbor resampling from the HRRR grid to the 5 km EPSG:5070 regional grid.",
"cfgrib_selection_groups": {
"level2": {
"filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 2
},
"variables": ["t2m", "d2m"]
},
"level10": {
"filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 10
},
"variables": ["u10", "v10"]
},
"surface_instant": {
"filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"variables": ["cape", "sp", "blh", "vis", "prate"]
},
"surface_accum": {
"filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "accum"
},
"variables": ["tp"]
}
}
},
"notes": [
"FIRMS active-fire detections are used to derive the occupancy target, not as an input channel.",
"WFIGS and MTBS are supporting event-level resources and are not part of the pretrained occupancy input.",
"The regional cache contains zero firewx feature channels and one firewx_valid channel, so the released input has 16 channels total.",
"CAPE is selected from the HRRR surface instantaneous cfgrib group: typeOfLevel=surface and stepType=instant. It is not the most-unstable or layer CAPE channel.",
"firewx_valid is a cache-level dynamic input presence mask. In the released California regional cache it is 1.0 for every grid cell and is not a per-variable HRRR missing-data mask.",
"static_valid is the fraction of the four static layers that are valid at a grid cell after reprojection. It can take values 0.0, 0.25, 0.5, 0.75, or 1.0."
],
"channels": [
{
"index": 0,
"name": "t2m",
"source": "NOAA HRRR",
"cfgrib_group": "level2",
"cfgrib_filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 2
},
"level_or_height": "2 m above ground",
"units": "K",
"normalization": "none",
"role": "2 m temperature"
},
{
"index": 1,
"name": "d2m",
"source": "NOAA HRRR",
"cfgrib_group": "level2",
"cfgrib_filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 2
},
"level_or_height": "2 m above ground",
"units": "K",
"normalization": "none",
"role": "2 m dew point"
},
{
"index": 2,
"name": "u10",
"source": "NOAA HRRR",
"cfgrib_group": "level10",
"cfgrib_filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 10
},
"level_or_height": "10 m above ground",
"units": "m s-1",
"normalization": "none",
"role": "10 m east-west wind component"
},
{
"index": 3,
"name": "v10",
"source": "NOAA HRRR",
"cfgrib_group": "level10",
"cfgrib_filter_by_keys": {
"typeOfLevel": "heightAboveGround",
"level": 10
},
"level_or_height": "10 m above ground",
"units": "m s-1",
"normalization": "none",
"role": "10 m north-south wind component"
},
{
"index": 4,
"name": "cape",
"source": "NOAA HRRR",
"cfgrib_group": "surface_instant",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"level_or_height": "surface",
"units": "J kg-1",
"normalization": "none",
"role": "surface instantaneous convective available potential energy"
},
{
"index": 5,
"name": "sp",
"source": "NOAA HRRR",
"cfgrib_group": "surface_instant",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"level_or_height": "surface",
"units": "Pa",
"normalization": "none",
"role": "surface pressure"
},
{
"index": 6,
"name": "blh",
"source": "NOAA HRRR",
"cfgrib_group": "surface_instant",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"level_or_height": "surface diagnostic",
"units": "m",
"normalization": "none",
"role": "boundary-layer height"
},
{
"index": 7,
"name": "vis",
"source": "NOAA HRRR",
"cfgrib_group": "surface_instant",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"level_or_height": "surface diagnostic",
"units": "m",
"normalization": "none",
"role": "visibility"
},
{
"index": 8,
"name": "prate",
"source": "NOAA HRRR",
"cfgrib_group": "surface_instant",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "instant"
},
"level_or_height": "surface",
"units": "kg m-2 s-1",
"normalization": "none",
"role": "precipitation rate"
},
{
"index": 9,
"name": "tp",
"source": "NOAA HRRR",
"cfgrib_group": "surface_accum",
"cfgrib_filter_by_keys": {
"typeOfLevel": "surface",
"stepType": "accum"
},
"level_or_height": "surface accumulation",
"units": "kg m-2",
"normalization": "none",
"role": "accumulated precipitation"
},
{
"index": 10,
"name": "firewx_valid",
"source": "cache validity channel",
"units": "binary mask",
"normalization": "none",
"values": [1.0],
"role": "cache-level dynamic input presence mask for this regional cache; not a per-variable HRRR missing-data mask"
},
{
"index": 11,
"name": "static_valid",
"source": "static reprojection mask",
"units": "fraction",
"normalization": "none",
"values": [0.0, 0.25, 0.5, 0.75, 1.0],
"role": "fraction of static layers valid at the grid cell after reprojection"
},
{
"index": 12,
"name": "fuel_fbfm40",
"source": "LANDFIRE FBFM40",
"units": "categorical code",
"normalization": "none",
"role": "fire-behavior fuel model"
},
{
"index": 13,
"name": "canopy_cover",
"source": "LANDFIRE CC",
"units": "provider-native canopy-cover value",
"normalization": "none",
"role": "canopy cover"
},
{
"index": 14,
"name": "housing_density",
"source": "Wildfire Risk to Communities",
"units": "provider-native housing-density value",
"normalization": "none",
"role": "housing-unit density"
},
{
"index": 15,
"name": "population",
"source": "LandScan Global 2024",
"units": "provider-native population value",
"normalization": "none",
"role": "population exposure"
}
]
}