{
 "title": "Metadata: StormSense Comma Separated Values (CSV) and JavaScript Object Notation (JSON) for 72-Hour Forecasts (fore72)",
 "product": "fore72",
 "datum": "NAVD88",
 "units": "feet",
 "time_zone": "UTC (Z)",
 "interval_minutes": 6,
 "introduction": "Figure 1 shows a StormSense 72-hour forecast chart and Table 1 the first rows of the matching download. Each field below is tied to the series it is drawn as in Figure 1 and to its column in Table 1.",
 "figure_1": "Example StormSense Chart of 72-hour forecast data (NAVD) at NOAA’s Sewells Point tide gauge, in Norfolk, VA, issued October 15, 2026 at 16:36 EDT (2026-10-15T20:36:00Z) from the P-ETSS 12Z cycle. The red-shaded period is the observed hindcast leading up to the forecast; the blue-shaded period is the 72-hour forecast.",
 "table_1": "Example StormSense Table of the first rows of 72-hour forecast data (NAVD) at NOAA’s Sewells Point tide gauge, in Norfolk, VA, issued October 15, 2026 at 16:36 EDT (2026-10-15T20:36:00Z).",
 "fields_scope": "fore72 downloads only include data series for the 72-hour forecast period (the dashed lines and shaded cone in the blue-shaded period of Figure 1; sample rows in Table 1)",
 "fields": [
  {
   "name": "date_time_z",
   "units": "UTC",
   "chart_series": null,
   "description": "Date and time in Zulu/GMT (UTC), formatted as a string leading with the date as “YYYY-MM-DD” followed by the time (T) as “hh:mm:ss” and Z for Zulu time. Recorded in regular 6-minute intervals (0, 6, 12 … 54 minutes past the hour), listed in chronological order (Table 1, first column)."
  },
  {
   "name": "astro_tide_ft",
   "units": "ft",
   "chart_series": "Astronomic Tide Forecast",
   "description": "Harmonically predicted astronomical tide for the next 72 hours from the NWS P-ETSS model (solid blue line in the forecast period of Figure 1). Formatted in units of feet rounded to three decimal places (thousandth of a foot) relative to the North American Vertical Datum of 1988 (NAVD88)."
  },
  {
   "name": "surge_ft",
   "units": "ft",
   "chart_series": null,
   "description": "Ensemble-mean storm surge from P-ETSS (the Probabilistic Extra-Tropical Storm Surge model of the NWS Meteorological Development Laboratory, run with an ensemble of weather forecasts): the water level change driven by forecast wind and air pressure. Hourly guidance interpolated to 6 minutes and smoothed with a 3-hour low-pass filter. Feet; a height difference, so the same in MLLW and NAVD88."
  },
  {
   "name": "bias_ft",
   "units": "ft",
   "chart_series": null,
   "description": "The observation-based correction P-ETSS adds to its surge, from the recent difference between the gauge’s observations and the modeled tide plus surge; it is held or decays through the forecast, and is 0.000 where P-ETSS applies no correction. Feet; the same in MLLW and NAVD88."
  },
  {
   "name": "residual_ft",
   "units": "ft",
   "chart_series": "Residual",
   "description": "Forecast residual: the non-tidal part of the forecast, SSforecast_ft − astro_tide_ft (surge_ft + bias_ft), drawn as the dashed cyan line in Figure 1. Feet; the same in MLLW and NAVD88."
  },
  {
   "name": "SSforecast_ft",
   "units": "ft",
   "chart_series": "StormSense Forecast",
   "description": "The StormSense 72-hour storm tide forecast, the ensemble-mean total water level: astro_tide_ft + surge_ft + bias_ft (dashed red line in Figure 1). Formatted in units of feet rounded to three decimal places (thousandth of a foot) relative to the North American Vertical Datum of 1988 (NAVD88)."
  },
  {
   "name": "SSforecast_p10_ft",
   "units": "ft",
   "chart_series": "Forecast Uncertainty (10%–90%)",
   "description": "10th percentile of the ensemble total water level (P-ETSS’s 90% exceedance level): the lower edge of the shaded cone of uncertainty in Figure 1. Formatted in units of feet rounded to three decimal places (thousandth of a foot) relative to the North American Vertical Datum of 1988 (NAVD88)."
  },
  {
   "name": "SSforecast_p90_ft",
   "units": "ft",
   "chart_series": null,
   "description": "Upper edge of the cone in Figure 1: the 90th percentile of the ensemble total water level (P-ETSS’s 10% exceedance level). Nine in ten ensemble members fall at or below it. Formatted in units of feet rounded to three decimal places (thousandth of a foot) relative to the North American Vertical Datum of 1988 (NAVD88)."
  },
  {
   "name": "surge_p10_ft, surge_p90_ft",
   "units": "ft",
   "chart_series": null,
   "description": "10th and 90th percentiles of the ensemble storm surge (P-ETSS 90% and 10% exceedance). Feet; the same in MLLW and NAVD88."
  }
 ],
 "notes": [
  "P-ETSS levels are tied to each gauge’s own record: the median difference between the observations and P-ETSS over the 24 hours before the forecast starts is added to astro_tide_ft, SSforecast_ft and its percentiles (0.00 ft at most NOAA gauges). At stations without a P-ETSS point, the files keep the same fields with the 36-hour forecast in astro_tide_ft, residual_ft and SSforecast_ft and the P-ETSS-only fields left blank (null in the JSON).",
  "Each CSV has a JSON twin at the same address with .json in place of .csv: station, product, datum, units, time_zone, updated, source, fields and a link to this metadata, then a data list with one record per CSV row keyed by the field names above (numbers in feet, blanks as null)."
 ],
 "nws_flood_thresholds": {
  "description": "The flood categories on NAVD88 charts (colored lines labeled at the right of Figure 1) are defined by the National Weather Service (NWS), not by StormSense. NWS forecast offices set them for each forecast gauge together with local emergency managers, based on the impacts observed near that gauge, and publish them through the National Water Prediction Service. StormSense refreshes them from NWPS with every update and shows them only at stations tied to an NWS gauge; thresholds that NWS publishes in MLLW are shifted to NAVD88 with the station’s MLLW–NAVD88 separation.",
  "source": "https://water.noaa.gov/",
  "thresholds": [
   {
    "name": "Action (yellow)",
    "color": "#FFFF00",
    "definition": "The level at which the NWS and its partners begin preparing for possible flooding; water may reach the edges of low-lying areas, but significant impacts are not yet expected."
   },
   {
    "name": "Minor (orange)",
    "color": "#FF9900",
    "definition": "Minor flooding: minimal or no property damage, but possibly some public threat, such as water over low-lying roads, parking lots and parks near the shore."
   },
   {
    "name": "Moderate (red)",
    "color": "#FF0000",
    "definition": "Moderate flooding: some inundation of structures and roads near the water, with some evacuations of people or moving of property to higher ground."
   },
   {
    "name": "Major (purple)",
    "color": "#CC33FF",
    "definition": "Major flooding: extensive inundation of structures and roads, with significant evacuations of people and transfer of property to higher elevations."
   }
  ]
 },
 "mllw_translation_datum": {
  "definition": "Mean Lower Low Water: the average of the lower of each day’s two low tides over the National Tidal Datum Epoch (1983–2001). The gray MLLW line in Figure 1 marks where the MLLW zero (the chart datum used on nautical charts and in tide tables) sits on the NAVD88 scale, labeled with its NAVD88 elevation.",
  "source": "For most NOAA-operated tide gauges the MLLW–NAVD88 separation is NOAA’s published value for that station. USGS, VDEM and StormSense sensors natively report live water levels in NAVD88 only, so their MLLW translation datum is derived from NOAA VDatum.",
  "vdatum": "https://vdatum.noaa.gov/vdatumweb/"
 },
 "companion_pdf": "stormsense-metadata-for-fore72-csv-data-NAVD.pdf"
}