Clarify WildFIRE-FM input channel contract

models/wildfire_fm/input_channels.json

@@ -1,112 +1,247 @@
 {
   "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."
+    "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."
   ],
   "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",
-      "role": "convective available potential energy"
+      "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": "mask",
+      "normalization": "none",
       "role": "dynamic/input validity mask for this regional cache"
     },
     {
       "index": 11,
       "name": "static_valid",
       "source": "static reprojection mask",
+      "units": "mask",
+      "normalization": "none",
       "role": "fraction of static layers valid at the grid cell"
     },
     {
       "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"
     }
   ]