From 8ec8e8b23dbacc6d5fc34bc8c6e5915f2bcb97e1 Mon Sep 17 00:00:00 2001 From: Bruce Crevensten Date: Wed, 22 Jul 2026 12:46:38 -0700 Subject: [PATCH 1/5] Share streamflow statistics table between hydrology docs pages Replace the two separately maintained "Available Streamflow Statistics" tables in the CONUS and Arctic hydrology documentation with a single shared Jinja fragment (streamflow_stats_table.html) included by both pages. The shared table incorporates the full statistic definitions from the hydroviz preprocessing stat_vars_dict: complete descriptions, category (duration/frequency/magnitude/rate of change/timing), difference method (ratio vs. absolute, relevant to interpreting ?source=gcm_diff output), and units. The ma99 row, which is served by the API but absent from stat_vars_dict, is retained using its description from the CSV metadata. Two source-text glitches were fixed in passing: a duplicated sentence in the dh4 description and a copy/paste error in spr_mag that referred to MH20. Co-Authored-By: Claude Opus 4.8 --- templates/documentation/arctic_hydrology.html | 329 +--------- templates/documentation/conus_hydrology.html | 76 +-- .../documentation/streamflow_stats_table.html | 586 ++++++++++++++++++ 3 files changed, 588 insertions(+), 403 deletions(-) create mode 100644 templates/documentation/streamflow_stats_table.html diff --git a/templates/documentation/arctic_hydrology.html b/templates/documentation/arctic_hydrology.html index 0123755a..1858aceb 100644 --- a/templates/documentation/arctic_hydrology.html +++ b/templates/documentation/arctic_hydrology.html @@ -684,334 +684,7 @@

Modeled daily water temperature climatologies

} -

Available Streamflow Statistics

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IDDescriptionUnits
dh1Mean annual maximum 1-day average flowcubic feet per second
dh2Mean annual maximum 3-day average flowcubic feet per second
dh3Mean annual maximum 7-day average flowcubic feet per second
dh4Mean annual maximum 30-day average flowcubic feet per second
dh5Mean annual maximum 90-day average flowcubic feet per second
dh15 - Median annual average duration of high flow pulses (above 75th - percentile) - days per year
dl1Mean annual minimum 1-day average flowcubic feet per second
dl2Mean annual minimum 3-day average flowcubic feet per second
dl3Mean annual minimum 7-day average flowcubic feet per second
dl4Mean annual minimum 30-day average flowcubic feet per second
dl5Mean annual minimum 90-day average flowcubic feet per second
dl16 - Median annual average duration of low flow pulses (below 25th - percentile) - days per year
lf1 - Median annual number of days below threshold of 0.1 cfs per square mile - days per year
spr_dur3 - Median spring (April–June) maximum 3-day moving average flow - cubic feet per second
spr_dur7 - Median spring (April–June) maximum 7-day moving average flow - cubic feet per second
sum_dur3 - Median summer (July–September) minimum 3-day moving average flow - cubic feet per second
sum_dur7 - Median summer (July–September) minimum 7-day moving average flow - cubic feet per second
fh1Mean annual count of high flow pulses above 75th percentileevents per year
fh5Mean annual flood frequency above median flowevents per year
fh6Mean annual flood frequency above 3× median flowevents per year
fh7Mean annual flood frequency above 7× median flowevents per year
fl1Mean annual count of low flow pulses below 25th percentileevents per year
fl3Mean annual count of events below 5 percent of mean flowevents per year
spr_freq - Median spring (April–June) count of flow events above 10th - percentile of full record - events per year
sum_freq - Median summer (July–September) count of flow events below 90th - percentile of full record - events per year
ma3 - Coefficient of variation (std/mean) of annual daily flows; mean of - annual CVs - percent
ma4 - Standard deviation of percentiles of log-transformed flow divided by - mean of those percentiles - percent
ma12Mean of monthly flow values for Januarycubic feet per second
ma13Mean of monthly flow values for Februarycubic feet per second
ma14Mean of monthly flow values for Marchcubic feet per second
ma15Mean of monthly flow values for Aprilcubic feet per second
ma16Mean of monthly flow values for Maycubic feet per second
ma17Mean of monthly flow values for Junecubic feet per second
ma18Mean of monthly flow values for Julycubic feet per second
ma19Mean of monthly flow values for Augustcubic feet per second
ma20Mean of monthly flow values for Septembercubic feet per second
ma21Mean of monthly flow values for Octobercubic feet per second
ma22Mean of monthly flow values for Novembercubic feet per second
ma23Mean of monthly flow values for Decembercubic feet per second
ma99Mean annual flow: average of monthly mean flows (ma12–ma23)cubic feet per second
mh14Median of (annual maximum flow / median annual flow) ratiosdimensionless
mh20 - Mean annual maximum flow divided by drainage area (specific discharge) - cubic feet per second per square mile
ml17 - Base flow index: mean of annual (7-day minimum flow / mean annual flow) - ratios - dimensionless
spr_mag - Median spring (April–June) maximum flow divided by drainage area - cubic feet per second per square mile
sum_cv - Median annual coefficient of variation of summer (July–September) - flows - percent
sum_mag - Median summer (July–September) minimum flow divided by drainage - area - cubic feet per second per square mile
ra1Mean rise rate: mean of positive daily flow changescubic feet per second per day
ra3Mean fall rate: mean of negative daily flow changescubic feet per second per day
ra8Median annual number of flow direction reversalsdays per year
spr_ordMedian Julian date of spring (April–June) maximum flowJulian day
sum_ordMedian Julian date of summer (July–September) minimum flowJulian day
th1Median Julian date of annual maximum flowJulian day
tl1Median Julian date of annual minimum flowJulian day
+{% include "documentation/streamflow_stats_table.html" %}

Available Water Temperature Statistics

diff --git a/templates/documentation/conus_hydrology.html b/templates/documentation/conus_hydrology.html index e1ae78be..a286ad36 100644 --- a/templates/documentation/conus_hydrology.html +++ b/templates/documentation/conus_hydrology.html @@ -525,81 +525,7 @@

Observed daily streamflow climatologies

} -

Available Streamflow Statistics

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IDDescriptionUnits
dh1Annual maximum daily flowcubic feet per second
dh2Annual maximum of 3-day moving average flowscubic feet per second
dh3Annual maximum of 7-day moving average flowscubic feet per second
dh4Annual maximum of 30-day moving average flowscubic feet per second
dh5Annual maximum of 90-day moving average flowscubic feet per second
dh15High flow pulse durationdays per year
dl1Annual minimum daily flowcubic feet per second
dl2Annual minimum of 3-day moving average flowcubic feet per second
dl3Annual minimum of 7-day moving average flowcubic feet per second
dl4Annual minimum of 30-day moving average flowcubic feet per second
dl5Annual minimum of 90-day moving average flowcubic feet per second
dl16Low flow pulse durationdays per year
lf1Number of days per year below a low-flow thresholddays per year
spr_dur3Spring (April–June) maximum of 3-day moving average flowscubic feet per second
spr_dur7Spring (April–June) maximum of 7-day moving average flowscubic feet per second
sum_dur3Summer (July–September) minimum of 3-day moving average flowcubic feet per second
sum_dur7Summer (July–September) minimum of 7-day moving average flowcubic feet per second
fh1High flood pulse countevents per year
fh5Flood frequency (above median flow)events per year
fh6Flood frequency (above 3× median flow)events per year
fh7Flood frequency (above 7× median flow)events per year
fl1Low flood pulse countevents per year
fl3Frequency of low pulse spellsevents per year
spr_freqSpring flood frequency (April–June)events per year
sum_freqSummer flood frequency (July–September)events per year
ma3Coefficient of variation of annual daily flowspercent
ma4Standard deviation divided by mean of log-flow percentilespercent
ma12Mean of monthly flow values for Januarycubic feet per second
ma13Mean of monthly flow values for Februarycubic feet per second
ma14Mean of monthly flow values for Marchcubic feet per second
ma15Mean of monthly flow values for Aprilcubic feet per second
ma16Mean of monthly flow values for Maycubic feet per second
ma17Mean of monthly flow values for Junecubic feet per second
ma18Mean of monthly flow values for Julycubic feet per second
ma19Mean of monthly flow values for Augustcubic feet per second
ma20Mean of monthly flow values for Septembercubic feet per second
ma21Mean of monthly flow values for Octobercubic feet per second
ma22Mean of monthly flow values for Novembercubic feet per second
ma23Mean of monthly flow values for Decembercubic feet per second
ma99Annual mean streamflow, calculated as the mean of the monthly mean flowscubic feet per second
mh14Median ratio of annual maximum flow to median annual flowdimensionless
mh20Specific mean annual maximum flowcubic feet per second per square mile
ml17Base flow indexdimensionless
spr_magSpecific mean spring (April–June) maximum flowcubic feet per second per square mile
sum_cvCoefficient of variation of summer daily flowspercent
sum_magMinimum summer flow divided by drainage areacubic feet per second per square mile
ra1Rise ratecubic feet per second per day
ra3Fall ratecubic feet per second per day
ra8Number of flow reversalsdays
spr_ordJulian date of spring maximum flowJulian day
sum_ordJulian date of summer minimum flowJulian day
th1Julian date of annual maximum flowJulian day
tl1Julian date of annual minimum flowJulian day
+{% include "documentation/streamflow_stats_table.html" %}

Source data

diff --git a/templates/documentation/streamflow_stats_table.html b/templates/documentation/streamflow_stats_table.html new file mode 100644 index 00000000..dff2b28d --- /dev/null +++ b/templates/documentation/streamflow_stats_table.html @@ -0,0 +1,586 @@ + +

Available Streamflow Statistics

+ +

+ The table below defines each streamflow statistic. The difference method + column indicates how ?source=gcm_diff values are expressed for + that statistic: as a ratio (projected divided by historical) or as an + absolute difference (projected minus historical). +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
IDCategoryDescriptionDifference methodUnits
dh1Duration + Annual maximum daily flow. Compute the maximum of a 1-day moving + average flow for each year. DH1 is the mean of these values (cubic feet + per second - temporal). + ratiocubic feet per second
dh2Duration + Annual maximum of 3-day moving average flows. Compute the maximum of a + 3-day moving average flow for each year. DH2 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dh3Duration + Annual maximum of 7-day moving average flows. Compute the maximum of a + 7-day moving average flow for each year. DH3 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dh4Duration + Annual maximum of 30-day moving average flows. Compute the maximum of a + 30-day moving average flow for each year. DH4 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dh5Duration + Annual maximum of 90-day moving average flows. Compute the maximum of a + 90-day moving average flow for each year. DH5 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dh15Duration + High flow pulse duration. Compute the average duration for flow events + with flows above a threshold equal to the 75th percentile value for + each year in the flow record. DH15 is the median of the yearly average + durations (days/year - temporal). + ratiodays per year
dl1Duration + Annual minimum daily flow. Compute the minimum 1-day average flow for + each year. DL1 is the mean of these values (cubic feet per second - + temporal). + ratiocubic feet per second
dl2Duration + Annual minimum of 3-day moving average flow. Compute the minimum of a + 3-day moving average flow for each year. DL2 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dl3Duration + Annual minimum of 7-day moving average flow. Compute the minimum of a + 7-day moving average flow for each year. DL3 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dl4Duration + Annual minimum of 30-day moving average flow. Compute the minimum of a + 30-day moving average flow for each year. DL4 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dl5Duration + Annual minimum of 90-day moving average flow. Compute the minimum of a + 90-day moving average flow for each year. DL5 is the mean of these + values (cubic feet per second - temporal). + ratiocubic feet per second
dl16Duration + Low flow pulse duration. Compute the average pulse duration for each + year for flow events below a threshold equal to the 25th percentile + value for the entire flow record. DL16 is the median of the yearly + average durations (days/year - temporal). + ratiodays per year
lf1Duration + Number of days per year below a threshold of 0.1 cubic feet per second + per square mile. LF1 is the median annual number of days below the + threshold (number of days/year - temporal). + absolutedays per year
spr_dur3Duration + Spring (April–June) maximum of 3-day moving average flows. + Compute the maximum of a 3-day moving average flow for each year. + SPR_DUR3 is the median of these values (cubic feet per second - + temporal). + ratiocubic feet per second
spr_dur7Duration + Spring (April–June) maximum of 7-day moving average flows. + Compute the maximum of a 7-day moving average flow for each year. + SPR_DUR7 is the median of these values (cubic feet per second - + temporal). + ratiocubic feet per second
sum_dur3Duration + Summer (July–September) minimum of 3-day moving average flow. + Compute the minimum of a 3-day moving average flow for each year. + SUM_DUR3 is the median of these values (cubic feet per second - + temporal). + ratiocubic feet per second
sum_dur7Duration + Summer (July–September) minimum of 7-day moving average flow. + Compute the minimum of a 7-day moving average flow for each year. + SUM_DUR7 is the median of these values (cubic feet per second - + temporal). + ratiocubic feet per second
fh1Frequency + High flood pulse count. Compute the average number of flow events with + flows above a threshold equal to the 75th percentile value for the + entire flow record. FH1 is the mean number of events (number of + events/year - temporal). + absoluteevents per year
fh5Frequency + Flood frequency. Compute the average number of flow events with flows + above a threshold equal to the median flow value for the entire flow + record. FH5 is the mean number of events (number of events/year - + temporal). + absoluteevents per year
fh6Frequency + Flood frequency. Compute the average number of flow events with flows + above a threshold equal to three times the median flow value for the + entire flow record. FH6 is the mean number of events (number of + events/year - temporal). + absoluteevents per year
fh7Frequency + Flood frequency. Compute the average number of flow events with flows + above a threshold equal to seven times the median flow value for the + entire flow record. FH7 is the mean number of events (number of + events/year - temporal). + absoluteevents per year
fl1Frequency + Low flood pulse count. Compute the average number of flow events with + flows below a threshold equal to the 25th percentile value for the + entire flow record. FL1 is the mean number of events (number of + events/year - temporal). + absoluteevents per year
fl3Frequency + Frequency of low pulse spells. Compute the average number of flow + events with flows below a threshold equal to 5 percent of the mean flow + value for the entire flow record. FL3 is the mean number of events + (number of events/year - temporal). + absoluteevents per year
spr_freqFrequency + Flood frequency for April–June. Compute the average number of + flow events with flows above a threshold equal to the 10th percentile + for the entire flow record. SPR_FREQ is the median number of events + (number of events/year - temporal). + absoluteevents per year
sum_freqFrequency + Flood frequency for July–September. Compute the average number of + flow events with flows below a threshold equal to the 90th percentile + for the entire flow record. SUM_FREQ is the median number of events + (number of events/year - temporal). + absoluteevents per year
ma3Magnitude + Coefficient of variation (standard deviation/mean) for each year. + Compute the coefficient of variation for each year of daily flows. + Compute the mean of the annual coefficients of variation (percent - + temporal). + ratiopercent
ma4Magnitude + Standard deviation of the percentiles of the logs of the entire flow + record divided by the mean of percentiles of the logs. Compute the + log10 of the daily flows for the entire record. Compute the 5th, 10th, + 15th, 20th, 25th, 30th, 35th, 40th, 45th, 50th, 55th, 60th, 65th, 70th, + 75th, 80th, 85th, 90th, and 95th percentiles for the logs of the entire + flow record. Percentiles are computed by interpolating between the + ordered (ascending) logs of the flow values. Compute the standard + deviation and mean for the percentile values. Divide the standard + deviation by the mean (percent - spatial). + ratiopercent
ma12MagnitudeMean of monthly flow values for January.ratiocubic feet per second
ma13MagnitudeMean of monthly flow values for February.ratiocubic feet per second
ma14MagnitudeMean of monthly flow values for March.ratiocubic feet per second
ma15MagnitudeMean of monthly flow values for April.ratiocubic feet per second
ma16MagnitudeMean of monthly flow values for May.ratiocubic feet per second
ma17MagnitudeMean of monthly flow values for June.ratiocubic feet per second
ma18MagnitudeMean of monthly flow values for July.ratiocubic feet per second
ma19MagnitudeMean of monthly flow values for August.ratiocubic feet per second
ma20MagnitudeMean of monthly flow values for September.ratiocubic feet per second
ma21MagnitudeMean of monthly flow values for October.ratiocubic feet per second
ma22MagnitudeMean of monthly flow values for November.ratiocubic feet per second
ma23MagnitudeMean of monthly flow values for December.ratiocubic feet per second
ma99Magnitude + Mean of monthly flow values for the entire year. Compute the mean of + the monthly mean flows for each month of the year. MA99 is the mean of + these 12 values (cubic feet per second - temporal). + ratiocubic feet per second
mh14Magnitude + Median of annual maximum flows. Compute the annual maximum flows from + monthly maximum flows. Compute the ratio of annual maximum flow to + median annual flow for each year. MH14 is the median of these ratios + (dimensionless - temporal). + ratiodimensionless
mh20Magnitude + Specific mean annual maximum flow. MH20 is the mean of the annual + maximum flows divided by the drainage area (cubic feet per second/ + square mile - temporal). + ratiocubic feet per second per square mile
ml17Magnitude + Base flow. Compute the mean annual flows. Compute the minimum of a + 7-day moving average flow for each year and divide them by the mean + annual flow for that year. ML17 is the median of those ratios + (dimensionless - temporal). + ratiodimensionless
spr_magMagnitude + Specific mean spring (April–June) maximum flow. SPR_MAG is the + median of the annual maximum flows divided by the drainage area (cubic + feet per second/square mile - temporal). + ratiocubic feet per second per square mile
sum_cvMagnitude + Coefficient of variation (standard deviation/mean) for each year for + the summer (July–September). Compute the coefficient of variation + for each year of daily flows. Compute the median of the annual + coefficients of variation (percent - temporal). + ratiopercent
sum_magMagnitude + Minimum of the summer (July–September) flows divided by the + drainage area (cubic feet per second/square mile - temporal). + absolutecubic feet per second per square mile
ra1Rate of change + Rise rate. Compute the change in flow for days in which the change is + positive for the entire flow record. RA1 is the mean of these values + (cubic feet per second/day - temporal). + ratiocubic feet per second per day
ra3Rate of change + Fall rate. Compute the change in flow for days in which the change is + negative for the entire flow record. RA3 is the mean of these values + (cubic feet per second/day - temporal). + ratiocubic feet per second per day
ra8Rate of change + Number of reversals. Compute the number of days in each year when the + change in flow from one day to the next changes direction. RA8 is the + mean of the yearly values (days - temporal). + ratiodays per year
spr_ordTiming + Julian date of spring (April–June) maximum. Determine the Julian + date that the maximum flow occurs for each year. SPR_ORD is the median + of these values (Julian day - temporal). + absoluteJulian day
sum_ordTiming + Julian date of summer (July–September) minimum. Determine the + Julian date that the minimum flow occurs for each water year. SUM_ORD + is the median of these values (Julian day - temporal). + absoluteJulian day
th1Timing + Julian date of annual maximum. Determine the Julian date that the + maximum flow occurs for each year. TH1 is the median of these values + (Julian day - temporal). + absoluteJulian day
tl1Timing + Julian date of annual minimum. Determine the Julian date that the + minimum flow occurs for each water year. TL1 is the median of these + values (Julian day - temporal). + absoluteJulian day
From 93d97071b376e43381a17756343a37eb6165d29b Mon Sep 17 00:00:00 2001 From: Bruce Crevensten Date: Wed, 22 Jul 2026 13:23:11 -0700 Subject: [PATCH 2/5] Move statistics tables to top of hydrology docs pages Relocate the shared streamflow statistics table (and the Arctic water temperature statistics table) from the bottom of the page to directly after the introduction, ahead of the endpoint and output documentation. Also reformats both templates with prettier. Co-Authored-By: Claude Opus 4.8 --- templates/documentation/arctic_hydrology.html | 1062 ++++++++--------- templates/documentation/conus_hydrology.html | 145 ++- 2 files changed, 597 insertions(+), 610 deletions(-) diff --git a/templates/documentation/arctic_hydrology.html b/templates/documentation/arctic_hydrology.html index 1858aceb..531a10f5 100644 --- a/templates/documentation/arctic_hydrology.html +++ b/templates/documentation/arctic_hydrology.html @@ -22,6 +22,326 @@

Arctic Hydrology

source datasets included at the bottom of this page.

+{% include "documentation/streamflow_stats_table.html" %} + +

Available Water Temperature Statistics

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
IDDescriptionUnits
wt_days_gt13_meanMean annual count of days with stream temperature > 13°Cdays per year
wt_days_gt18_meanMean annual count of days with stream temperature > 18°Cdays per year
wt_days_gt20_meanMean annual count of days with stream temperature > 20°Cdays per year
wt_mean_janMean of monthly mean stream temperatures for Januarydegrees Celsius
wt_mean_febMean of monthly mean stream temperatures for Februarydegrees Celsius
wt_mean_marMean of monthly mean stream temperatures for Marchdegrees Celsius
wt_mean_aprMean of monthly mean stream temperatures for Aprildegrees Celsius
wt_mean_mayMean of monthly mean stream temperatures for Maydegrees Celsius
wt_mean_junMean of monthly mean stream temperatures for Junedegrees Celsius
wt_mean_julMean of monthly mean stream temperatures for Julydegrees Celsius
wt_mean_augMean of monthly mean stream temperatures for Augustdegrees Celsius
wt_mean_sepMean of monthly mean stream temperatures for Septemberdegrees Celsius
wt_mean_octMean of monthly mean stream temperatures for Octoberdegrees Celsius
wt_mean_novMean of monthly mean stream temperatures for Novemberdegrees Celsius
wt_mean_decMean of monthly mean stream temperatures for Decemberdegrees Celsius
wt_min_jan + Minimum monthly mean stream temperature for January across all years in + era + degrees Celsius
wt_min_feb + Minimum monthly mean stream temperature for February across all years in + era + degrees Celsius
wt_min_mar + Minimum monthly mean stream temperature for March across all years in + era + degrees Celsius
wt_min_apr + Minimum monthly mean stream temperature for April across all years in + era + degrees Celsius
wt_min_may + Minimum monthly mean stream temperature for May across all years in era + degrees Celsius
wt_min_jun + Minimum monthly mean stream temperature for June across all years in era + degrees Celsius
wt_min_jul + Minimum monthly mean stream temperature for July across all years in era + degrees Celsius
wt_min_aug + Minimum monthly mean stream temperature for August across all years in + era + degrees Celsius
wt_min_sep + Minimum monthly mean stream temperature for September across all years + in era + degrees Celsius
wt_min_oct + Minimum monthly mean stream temperature for October across all years in + era + degrees Celsius
wt_min_nov + Minimum monthly mean stream temperature for November across all years in + era + degrees Celsius
wt_min_dec + Minimum monthly mean stream temperature for December across all years in + era + degrees Celsius
wt_max_jan + Maximum monthly mean stream temperature for January across all years in + era + degrees Celsius
wt_max_feb + Maximum monthly mean stream temperature for February across all years in + era + degrees Celsius
wt_max_mar + Maximum monthly mean stream temperature for March across all years in + era + degrees Celsius
wt_max_apr + Maximum monthly mean stream temperature for April across all years in + era + degrees Celsius
wt_max_may + Maximum monthly mean stream temperature for May across all years in era + degrees Celsius
wt_max_jun + Maximum monthly mean stream temperature for June across all years in era + degrees Celsius
wt_max_jul + Maximum monthly mean stream temperature for July across all years in era + degrees Celsius
wt_max_aug + Maximum monthly mean stream temperature for August across all years in + era + degrees Celsius
wt_max_sep + Maximum monthly mean stream temperature for September across all years + in era + degrees Celsius
wt_max_oct + Maximum monthly mean stream temperature for October across all years in + era + degrees Celsius
wt_max_nov + Maximum monthly mean stream temperature for November across all years in + era + degrees Celsius
wt_max_dec + Maximum monthly mean stream temperature for December across all years in + era + degrees Celsius
wt_ann_max_temp_mean + Mean (over era years) of the annual maximum daily stream temperature + degrees Celsius
wt_ann_max_temp_doy_mean + Mean (over era years) Julian day of the annual maximum daily stream + temperature + Julian day
wt_7d_max_temp_mean + Mean (over era years) of the annual maximum 7-day rolling average stream + temperature + degrees Celsius
wt_7d_max_temp_doy_mean + Mean (over era years) Julian day of the center of the annual maximum + 7-day rolling average + Julian day
wt_cdd_may_sept_mean + Mean (over era years) annual cumulative degree days above 0°C, May + through September + degree-days Celsius
+

Service endpoints

Modeled hydrologic statistics by stream ID

@@ -60,8 +380,8 @@

Modeled hydrologic statistics by stream ID

  • gcm_diff_applied_to_blaskey (default) — - GCM-projected changes applied to the historical Blaskey baseline. PGW - models are not included. + GCM-projected changes applied to the historical Blaskey baseline. + PGW models are not included.
  • original_gcm — raw output from the original GCM @@ -117,8 +437,8 @@

    Modeled daily streamflow climatologies by stream ID

    • gcm_diff_applied_to_blaskey (default) — - GCM-projected changes applied to the historical Blaskey baseline. PGW - models are not included. + GCM-projected changes applied to the historical Blaskey baseline. + PGW models are not included.
    • original_gcm — raw output from the original GCM @@ -168,8 +488,8 @@

      Modeled water temperature statistics by stream ID

      • gcm_diff_applied_to_blaskey (default) — - GCM-projected changes applied to the historical Blaskey baseline. PGW - models are not included. + GCM-projected changes applied to the historical Blaskey baseline. + PGW models are not included.
      • original_gcm — raw output from the original GCM @@ -225,8 +545,8 @@

        Modeled daily water temperature climatologies by stream ID

        • gcm_diff_applied_to_blaskey (default) — - GCM-projected changes applied to the historical Blaskey baseline. PGW - models are not included. + GCM-projected changes applied to the historical Blaskey baseline. + PGW models are not included.
        • original_gcm — raw output from the original GCM @@ -427,210 +747,8 @@

          Modeled daily streamflow climatologies

          "units": "cfs" }, "doy_min": { - "description": "Minimum streamflow value (cfs) on the specified day of year, aggregated over all years in the era.", - "units": "cfs" - }, - "water_year_index": { - "description": "Water year day index (1-366), where the water year starts on October 1 (DOY 275) and ends on September 30 (DOY 274).", - "units": "water year day index" - } - } - }, - "watershed": "19060206", - "watershed_outlet": true -} - - -

          - Note that latitude and longitude values represent the approximate centroid of - the stream segment. Modeled data uses a 366 day year. The above output is - structured like this: -

          - -
          -{
-  "data": {
-    <model>: {
-      <era>: [
-        {
-          <variable>: <value>,
-          ...
-        },
-        ...
-      ],
-      ...
-    },
-    ...
-  },
-  "id": <stream ID>,
-  "latitude": <latitude of stream segment>,
-  "longitude": <longitude of stream segment>,
-  "metadata": {
-    "source": {
-      "citation": <academic reference for source data>
-    },
-    "variables": {
-      <variable>: {
-        "description": <description of variable>,
-        "units": <units of variable>
-      },
-      ...
-    }
-  },
-  "watershed": <HUC8 or Yukon watershed ID>,
-  "watershed_outlet": <true if segment is a watershed outlet>
-}
-
          - -

          Modeled water temperature statistics

          - -

          Results from stream ID queries will look like this:

          - -
          -{
-  "data": {
-    "C2LE2": {
-      "2034-2065": {
-        "wt_7d_max_temp_doy_mean": 192.47,
-        "wt_7d_max_temp_mean": 13.44,
-        ...
-        "wt_min_sep": 3.05
-      }
-    },
-    ...
-    "historical": {
-      "1990-2021": {
-        "wt_7d_max_temp_doy_mean": 196.03,
-        "wt_7d_max_temp_mean": 11.92,
-        ...
-        "wt_min_sep": 2.35
-      }
-    }
-  },
-  "id": "81000004",
-  "latitude": 70.8292,
-  "longitude": -155.42,
-  "metadata": {
-    "source": {
-      "citation": "Dylan Blaskey, Keith Musselman, Andrew Newman, & Yifan Cheng. (2024). Alaskan river discharge, temperature, and climate data for a climate reference (1990-2021) and at mid-century (2034-2065). Arctic Data Center. doi:10.18739/A25M62870."
-    },
-    "variables": {
-      "wt_7d_max_temp_mean": {
-        "description": "Mean (over era years) of the annual maximum 7-day rolling average stream temperature.",
-        "units": "degC"
-      },
-      ...
-    }
-  },
-  "watershed": "19060206",
-  "watershed_outlet": true
-}
-
          - -

          - Note that latitude and longitude values represent the approximate centroid of - the stream segment. Unlike the streamflow statistics endpoint, this response - does not include a summary key. The above output is structured - like this: -

          - -
          -{
-  "data": {
-    <model>: {
-      <era>: {
-        <variable>: <value>,
-        ...
-      },
-      ...
-    },
-    ...
-  },
-  "id": <stream ID>,
-  "latitude": <latitude of stream segment>,
-  "longitude": <longitude of stream segment>,
-  "metadata": {
-    "source": {
-      "citation": <academic reference for source data>
-    },
-    "variables": {
-      <variable>: {
-        "description": <description of variable>,
-        "units": <units of variable>
-      },
-      ...
-    }
-  },
-  "watershed": <HUC8 or Yukon watershed ID>,
-  "watershed_outlet": <true if segment is a watershed outlet>
-}
-
          - -

          Modeled daily water temperature climatologies

          - -

          Results from stream ID queries will look like this:

          - -
          -{
-  "data": {
-    "C2LE2": {
-      "2034-2065": [
-        {
-          "doy": 1,
-          "doy_max": 2.52,
-          "doy_mean": 0.552,
-          "doy_min": 0.1,
-          "water_year_index": 93
-        },
-        {
-          "doy": 2,
-          "doy_max": 3.05,
-          "doy_mean": 0.558,
-          "doy_min": 0.1,
-          "water_year_index": 94
-        },
-        ...
-        {
-          "doy": 365,
-          "doy_max": 1.02,
-          "doy_mean": 0.224,
-          "doy_min": 0.1,
-          "water_year_index": 91
-        },
-        {
-          "doy": 366,
-          "doy_max": 0.16,
-          "doy_mean": 0.143,
-          "doy_min": 0.1,
-          "water_year_index": 92
-        }
-      ]
-    },
-    ...
-  },
-  "id": "81000004",
-  "latitude": 70.8292,
-  "longitude": -155.42,
-  "metadata": {
-    "source": {
-      "citation": "Dylan Blaskey, Keith Musselman, Andrew Newman, & Yifan Cheng. (2024). Alaskan river discharge, temperature, and climate data for a climate reference (1990-2021) and at mid-century (2034-2065). Arctic Data Center. doi:10.18739/A25M62870."
-    },
-    "variables": {
-      "doy": {
-        "description": "Day of year (1-366); all years are treated as leap years for consistency.",
-        "units": "day of year"
-      },
-      "doy_max": {
-        "description": "Maximum stream temperature on the specified day of year, aggregated over all years in the era.",
-        "units": "degC"
-      },
-      "doy_mean": {
-        "description": "Mean stream temperature on the specified day of year, aggregated over all years in the era.",
-        "units": "degC"
-      },
-      "doy_min": {
-        "description": "Minimum stream temperature on the specified day of year, aggregated over all years in the era.",
-        "units": "degC"
+        "description": "Minimum streamflow value (cfs) on the specified day of year, aggregated over all years in the era.",
+        "units": "cfs"
       },
       "water_year_index": {
         "description": "Water year day index (1-366), where the water year starts on October 1 (DOY 275) and ends on September 30 (DOY 274).",
@@ -684,325 +802,207 @@ 
          Modeled daily water temperature climatologies
          
 }
          -{% include "documentation/streamflow_stats_table.html" %} +

          Modeled water temperature statistics

          -

          Available Water Temperature Statistics

          +

          Results from stream ID queries will look like this:

          - - - - - - - - - - - - - - - - - - - - - - - - +
          +{
+  "data": {
+    "C2LE2": {
+      "2034-2065": {
+        "wt_7d_max_temp_doy_mean": 192.47,
+        "wt_7d_max_temp_mean": 13.44,
+        ...
+        "wt_min_sep": 3.05
+      }
+    },
+    ...
+    "historical": {
+      "1990-2021": {
+        "wt_7d_max_temp_doy_mean": 196.03,
+        "wt_7d_max_temp_mean": 11.92,
+        ...
+        "wt_min_sep": 2.35
+      }
+    }
+  },
+  "id": "81000004",
+  "latitude": 70.8292,
+  "longitude": -155.42,
+  "metadata": {
+    "source": {
+      "citation": "Dylan Blaskey, Keith Musselman, Andrew Newman, & Yifan Cheng. (2024). Alaskan river discharge, temperature, and climate data for a climate reference (1990-2021) and at mid-century (2034-2065). Arctic Data Center. doi:10.18739/A25M62870."
+    },
+    "variables": {
+      "wt_7d_max_temp_mean": {
+        "description": "Mean (over era years) of the annual maximum 7-day rolling average stream temperature.",
+        "units": "degC"
+      },
+      ...
+    }
+  },
+  "watershed": "19060206",
+  "watershed_outlet": true
+}
+
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

          + Note that latitude and longitude values represent the approximate centroid of + the stream segment. Unlike the streamflow statistics endpoint, this response + does not include a summary key. The above output is structured + like this: +

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
          +{
+  "data": {
+    <model>: {
+      <era>: {
+        <variable>: <value>,
+        ...
+      },
+      ...
+    },
+    ...
+  },
+  "id": <stream ID>,
+  "latitude": <latitude of stream segment>,
+  "longitude": <longitude of stream segment>,
+  "metadata": {
+    "source": {
+      "citation": <academic reference for source data>
+    },
+    "variables": {
+      <variable>: {
+        "description": <description of variable>,
+        "units": <units of variable>
+      },
+      ...
+    }
+  },
+  "watershed": <HUC8 or Yukon watershed ID>,
+  "watershed_outlet": <true if segment is a watershed outlet>
+}
+
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

          Modeled daily water temperature climatologies

          - - - - - - - - - - - - - - - - - - - - - - - - - - -
          IDDescriptionUnits
          wt_days_gt13_meanMean annual count of days with stream temperature > 13°Cdays per year
          wt_days_gt18_meanMean annual count of days with stream temperature > 18°Cdays per year
          wt_days_gt20_meanMean annual count of days with stream temperature > 20°Cdays per year
          wt_mean_janMean of monthly mean stream temperatures for Januarydegrees Celsius
          wt_mean_febMean of monthly mean stream temperatures for Februarydegrees Celsius
          wt_mean_marMean of monthly mean stream temperatures for Marchdegrees Celsius
          wt_mean_aprMean of monthly mean stream temperatures for Aprildegrees Celsius
          wt_mean_mayMean of monthly mean stream temperatures for Maydegrees Celsius
          wt_mean_junMean of monthly mean stream temperatures for Junedegrees Celsius
          wt_mean_julMean of monthly mean stream temperatures for Julydegrees Celsius
          wt_mean_augMean of monthly mean stream temperatures for Augustdegrees Celsius
          wt_mean_sepMean of monthly mean stream temperatures for Septemberdegrees Celsius
          wt_mean_octMean of monthly mean stream temperatures for Octoberdegrees Celsius
          wt_mean_novMean of monthly mean stream temperatures for Novemberdegrees Celsius
          wt_mean_decMean of monthly mean stream temperatures for Decemberdegrees Celsius
          wt_min_jan - Minimum monthly mean stream temperature for January across all years in - era - degrees Celsius
          wt_min_feb - Minimum monthly mean stream temperature for February across all years in - era - degrees Celsius
          wt_min_mar - Minimum monthly mean stream temperature for March across all years in - era - degrees Celsius
          wt_min_apr - Minimum monthly mean stream temperature for April across all years in - era - degrees Celsius
          wt_min_may - Minimum monthly mean stream temperature for May across all years in era - degrees Celsius
          wt_min_jun - Minimum monthly mean stream temperature for June across all years in era - degrees Celsius
          wt_min_jul - Minimum monthly mean stream temperature for July across all years in era - degrees Celsius
          wt_min_aug - Minimum monthly mean stream temperature for August across all years in - era - degrees Celsius
          wt_min_sep - Minimum monthly mean stream temperature for September across all years - in era - degrees Celsius
          wt_min_oct - Minimum monthly mean stream temperature for October across all years in - era - degrees Celsius
          wt_min_nov - Minimum monthly mean stream temperature for November across all years in - era - degrees Celsius
          wt_min_dec - Minimum monthly mean stream temperature for December across all years in - era - degrees Celsius
          wt_max_jan - Maximum monthly mean stream temperature for January across all years in - era - degrees Celsius
          wt_max_feb - Maximum monthly mean stream temperature for February across all years in - era - degrees Celsius
          wt_max_mar - Maximum monthly mean stream temperature for March across all years in - era - degrees Celsius
          wt_max_apr - Maximum monthly mean stream temperature for April across all years in - era - degrees Celsius
          wt_max_may - Maximum monthly mean stream temperature for May across all years in era - degrees Celsius
          wt_max_jun - Maximum monthly mean stream temperature for June across all years in era - degrees Celsius
          wt_max_jul - Maximum monthly mean stream temperature for July across all years in era - degrees Celsius
          wt_max_aug - Maximum monthly mean stream temperature for August across all years in - era - degrees Celsius
          wt_max_sep - Maximum monthly mean stream temperature for September across all years - in era - degrees Celsius
          wt_max_oct - Maximum monthly mean stream temperature for October across all years in - era - degrees Celsius
          wt_max_nov - Maximum monthly mean stream temperature for November across all years in - era - degrees Celsius
          wt_max_dec - Maximum monthly mean stream temperature for December across all years in - era - degrees Celsius
          wt_ann_max_temp_mean - Mean (over era years) of the annual maximum daily stream temperature - degrees Celsius
          wt_ann_max_temp_doy_mean - Mean (over era years) Julian day of the annual maximum daily stream - temperature - Julian day
          wt_7d_max_temp_mean - Mean (over era years) of the annual maximum 7-day rolling average stream - temperature - degrees Celsius
          wt_7d_max_temp_doy_mean - Mean (over era years) Julian day of the center of the annual maximum - 7-day rolling average - Julian day
          wt_cdd_may_sept_mean - Mean (over era years) annual cumulative degree days above 0°C, May - through September - degree-days Celsius
          +

          Results from stream ID queries will look like this:

          + +
          +{
+  "data": {
+    "C2LE2": {
+      "2034-2065": [
+        {
+          "doy": 1,
+          "doy_max": 2.52,
+          "doy_mean": 0.552,
+          "doy_min": 0.1,
+          "water_year_index": 93
+        },
+        {
+          "doy": 2,
+          "doy_max": 3.05,
+          "doy_mean": 0.558,
+          "doy_min": 0.1,
+          "water_year_index": 94
+        },
+        ...
+        {
+          "doy": 365,
+          "doy_max": 1.02,
+          "doy_mean": 0.224,
+          "doy_min": 0.1,
+          "water_year_index": 91
+        },
+        {
+          "doy": 366,
+          "doy_max": 0.16,
+          "doy_mean": 0.143,
+          "doy_min": 0.1,
+          "water_year_index": 92
+        }
+      ]
+    },
+    ...
+  },
+  "id": "81000004",
+  "latitude": 70.8292,
+  "longitude": -155.42,
+  "metadata": {
+    "source": {
+      "citation": "Dylan Blaskey, Keith Musselman, Andrew Newman, & Yifan Cheng. (2024). Alaskan river discharge, temperature, and climate data for a climate reference (1990-2021) and at mid-century (2034-2065). Arctic Data Center. doi:10.18739/A25M62870."
+    },
+    "variables": {
+      "doy": {
+        "description": "Day of year (1-366); all years are treated as leap years for consistency.",
+        "units": "day of year"
+      },
+      "doy_max": {
+        "description": "Maximum stream temperature on the specified day of year, aggregated over all years in the era.",
+        "units": "degC"
+      },
+      "doy_mean": {
+        "description": "Mean stream temperature on the specified day of year, aggregated over all years in the era.",
+        "units": "degC"
+      },
+      "doy_min": {
+        "description": "Minimum stream temperature on the specified day of year, aggregated over all years in the era.",
+        "units": "degC"
+      },
+      "water_year_index": {
+        "description": "Water year day index (1-366), where the water year starts on October 1 (DOY 275) and ends on September 30 (DOY 274).",
+        "units": "water year day index"
+      }
+    }
+  },
+  "watershed": "19060206",
+  "watershed_outlet": true
+}
+
          + +

          + Note that latitude and longitude values represent the approximate centroid of + the stream segment. Modeled data uses a 366 day year. The above output is + structured like this: +

          + +
          +{
+  "data": {
+    <model>: {
+      <era>: [
+        {
+          <variable>: <value>,
+          ...
+        },
+        ...
+      ],
+      ...
+    },
+    ...
+  },
+  "id": <stream ID>,
+  "latitude": <latitude of stream segment>,
+  "longitude": <longitude of stream segment>,
+  "metadata": {
+    "source": {
+      "citation": <academic reference for source data>
+    },
+    "variables": {
+      <variable>: {
+        "description": <description of variable>,
+        "units": <units of variable>
+      },
+      ...
+    }
+  },
+  "watershed": <HUC8 or Yukon watershed ID>,
+  "watershed_outlet": <true if segment is a watershed outlet>
+}
+

          Source data

          @@ -1060,21 +1060,17 @@

          Source data

          Musselman (2024). A high-resolution, daily hindcast (1990–2021) of Alaskan river discharge and temperature from coupled and optimized physical models. Water Resources Research. doi: - 10.1029/2023WR036217. + 10.1029/2023WR036217. - Cheng Y., A. Craig, K. Musselman, A. Bennett, M. Seefeldt, J. Hamman, - & A. J. Newman (2024). Coupled high-resolution land-atmosphere modeling + Cheng Y., A. Craig, K. Musselman, A. Bennett, M. Seefeldt, J. Hamman, & + A. J. Newman (2024). Coupled high-resolution land-atmosphere modeling for hydroclimate and terrestrial hydrology in Alaska and the Yukon River Basin (1990–2021). Journal of Geophysical Research: Atmospheres. doi: - 10.1029/2024JD041185. + 10.1029/2024JD041185. diff --git a/templates/documentation/conus_hydrology.html b/templates/documentation/conus_hydrology.html index a286ad36..87ba18de 100644 --- a/templates/documentation/conus_hydrology.html +++ b/templates/documentation/conus_hydrology.html @@ -11,6 +11,8 @@

          CONUS Hydrology

          calibration) is available for the 1976–2005 period.

          +{% include "documentation/streamflow_stats_table.html" %} + @@ -21,9 +23,9 @@

          CONUS Hydrology

          We also include endpoints to access daily streamflow climatologies from - associated USGS stream gage data collected over the 1976–2005 - historical period, for use in comparing with the modeled data. Note that not - all modeled stream segments have associated gage data. See the + associated USGS stream gage data collected over the 1976–2005 historical + period, for use in comparing with the modeled data. Note that not all modeled + stream segments have associated gage data. See the /conus_hydrology/gage_info endpoint for a list of all stream IDs with gage data.

          @@ -35,8 +37,7 @@

          Modeled hydrologic statistics by stream ID

          Query hydrologic statistics for all models and scenarios. Statistics are computed over historical (1976–2005) and future (2016–2045, - 2046–2075, and 2071–2100) eras. These statistics are defined - below. + 2046–2075, and 2071–2100) eras.

          @@ -63,8 +64,8 @@

          Modeled hydrologic statistics by stream ID

          parameter. Accepted values are:
          • - gcm_diff_applied_to_maurer (default) — GCM-projected - changes applied to the historical Maurer baseline. + gcm_diff_applied_to_maurer (default) — + GCM-projected changes applied to the historical Maurer baseline.
          • original_gcm — raw output from the original GCM @@ -72,9 +73,9 @@

            Modeled hydrologic statistics by stream ID

          • gcm_diff — ratio or absolute difference between - the projected and historical GCM runs. These are not actual statistic - values; apply them to your own historical baseline to approximate future - values. + the projected and historical GCM runs. These are not actual + statistic values; apply them to your own historical baseline to + approximate future values.
          Chaining of multiple arguments is supported (e.g., @@ -119,8 +120,8 @@

          Modeled daily streamflow climatologies by stream ID

          parameter. Accepted values are:
          • - gcm_diff_applied_to_maurer (default) — GCM-projected - changes applied to the historical Maurer baseline. + gcm_diff_applied_to_maurer (default) — + GCM-projected changes applied to the historical Maurer baseline.
          • original_gcm — raw output from the original GCM @@ -525,72 +526,62 @@

            Observed daily streamflow climatologies

            } -{% include "documentation/streamflow_stats_table.html" %} - +

            Source data

            -

            Source data

            - -
          - - - - - - - - - - - - - - - - - - - -
          Academic reference
          - LaFontaine, J.H., and Riley, J.W., 2023, Model Input and Output - for Hydrologic Simulations for the Conterminous United States for - Historical and Future Conditions Using the National Hydrologic - Model Infrastructure (NHM) and the Coupled Model Intercomparison - Project Phase 5 (CMIP5), 1950–2100: U.S. Geological Survey - data release, - https://doi.org/10.5066/P9EBKREQ. -
          - Regan, R.S., Markstrom, S.L., Hay, L.E., Viger, R.J., Norton, - P.A., Driscoll, J.M., LaFontaine, J.H., 2018, Description of the - National Hydrologic Model for use with the - Precipitation–Runoff Modeling System (PRMS): U.S. Geological - Survey Techniques and Methods, book 6, chap B9, 38 p., - https://doi.org/10.3133/tm6B9. -
          - LaFontaine, J.H., Hay, L.E., and Riley, J.R., 2023, Application of - the National Hydrologic Model Infrastructure with the - Precipitation–Runoff Modeling System (NHM-PRMS), - 1950–2010, Maurer Calibration: U.S. Geological Survey data - release, - https://doi.org/10.5066/P9CVHLMB. -
          - U.S. Geological Survey, 2025, U.S. Geological Survey National - Water Information System database, at - https://doi.org/10.5066/F7P55KJN. Data download directly accessible at - https://api.waterdata.usgs.gov/ogcapi/v0/collections/daily. -
          - - {% endblock %} + + + + + + + + + + + + + + + + + +
          Academic reference
          + LaFontaine, J.H., and Riley, J.W., 2023, Model Input and Output for + Hydrologic Simulations for the Conterminous United States for Historical + and Future Conditions Using the National Hydrologic Model Infrastructure + (NHM) and the Coupled Model Intercomparison Project Phase 5 (CMIP5), + 1950–2100: U.S. Geological Survey data release, + https://doi.org/10.5066/P9EBKREQ. +
          + Regan, R.S., Markstrom, S.L., Hay, L.E., Viger, R.J., Norton, P.A., + Driscoll, J.M., LaFontaine, J.H., 2018, Description of the National + Hydrologic Model for use with the Precipitation–Runoff Modeling + System (PRMS): U.S. Geological Survey Techniques and Methods, book 6, + chap B9, 38 p., + https://doi.org/10.3133/tm6B9. +
          + LaFontaine, J.H., Hay, L.E., and Riley, J.R., 2023, Application of the + National Hydrologic Model Infrastructure with the + Precipitation–Runoff Modeling System (NHM-PRMS), 1950–2010, + Maurer Calibration: U.S. Geological Survey data release, + https://doi.org/10.5066/P9CVHLMB. +
          + U.S. Geological Survey, 2025, U.S. Geological Survey National Water + Information System database, at + https://doi.org/10.5066/F7P55KJN. Data download directly accessible at + https://api.waterdata.usgs.gov/ogcapi/v0/collections/daily. +
          + +{% endblock %} From 43974859f8c5ad7011d5e14aabf624639ad512cb Mon Sep 17 00:00:00 2001 From: Bruce Crevensten Date: Wed, 22 Jul 2026 13:24:05 -0700 Subject: [PATCH 3/5] Add climate models table to CONUS hydrology docs Add a fragment listing the 13 CMIP5 GCMs used for the CONUS hydrology dataset, included directly above the shared streamflow statistics table. Model names, modeling centers, and available RCP scenarios come from the gcm_metadata_dict in the hydroviz preprocessing pipeline (the Maurer historical baseline is described in the page intro and is not listed as a climate model). Two typos in the source dict were fixed in passing (Administration, Geophysical). Co-Authored-By: Claude Opus 4.8 --- templates/documentation/conus_hydrology.html | 2 + .../documentation/conus_models_table.html | 113 ++++++++++++++++++ 2 files changed, 115 insertions(+) create mode 100644 templates/documentation/conus_models_table.html diff --git a/templates/documentation/conus_hydrology.html b/templates/documentation/conus_hydrology.html index 87ba18de..258def72 100644 --- a/templates/documentation/conus_hydrology.html +++ b/templates/documentation/conus_hydrology.html @@ -11,6 +11,8 @@

          CONUS Hydrology

          calibration) is available for the 1976–2005 period.

          +{% include "documentation/conus_models_table.html" %} + {% include "documentation/streamflow_stats_table.html" %} diff --git a/templates/documentation/conus_models_table.html b/templates/documentation/conus_models_table.html new file mode 100644 index 00000000..11d5177d --- /dev/null +++ b/templates/documentation/conus_models_table.html @@ -0,0 +1,113 @@ + +

          Climate models

          + +

          + Streamflow was modeled using climate inputs from the following 13 CMIP5 + general circulation models (GCMs). Each model also includes a historical run + covering the 1976–2005 era. +

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          ModelModeling centerEmissions scenarios
          ACCESS1-0 + Commonwealth Scientific and Industrial Research Organization and Bureau + of Meteorology, Australia + RCP 4.5, RCP 8.5
          BCC-CSM1-1Beijing Climate Center, China Meteorological Administration, ChinaRCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          BNU-ESM + College of Global Change and Earth System Science, Beijing Normal + University, China + RCP 4.5, RCP 8.5
          CCSM4National Center for Atmospheric Research, USARCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          GFDL-ESM2G + National Oceanic and Atmospheric Administration Geophysical Fluid + Dynamics Laboratory, USA + RCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          GFDL-ESM2M + National Oceanic and Atmospheric Administration Geophysical Fluid + Dynamics Laboratory, USA + RCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          IPSL-CM5A-LRInstitut Pierre-Simon Laplace, FranceRCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          IPSL-CM5A-MRInstitut Pierre-Simon Laplace, FranceRCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          MIROC5 + Japan Agency for Marine-Earth Science and Technology, Atmospheric and + Ocean Research Institute (The University of Tokyo), and National + Institute for Environmental Studies, Japan + RCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          MIROC-ESM + Japan Agency for Marine-Earth Science and Technology, Atmospheric and + Ocean Research Institute (The University of Tokyo), and National + Institute for Environmental Studies, Japan + RCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          MIROC-ESM-CHEM + Japan Agency for Marine-Earth Science and Technology, Atmospheric and + Ocean Research Institute (The University of Tokyo), and National + Institute for Environmental Studies, Japan + RCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          MRI-CGCM3Meteorological Research Institute, JapanRCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          NorESM1-MNorwegian Climate Centre, NorwayRCP 2.6, RCP 4.5, RCP 6.0, RCP 8.5
          From e0f6bd537e9d14b1a5e91aaa374b8be14d55f04c Mon Sep 17 00:00:00 2001 From: Bruce Crevensten Date: Wed, 22 Jul 2026 13:29:55 -0700 Subject: [PATCH 4/5] Add climate models table to Arctic hydrology docs Add a fragment listing the six downscaled model runs used for the Arctic hydrology dataset (four CESM2 Large Ensemble members under SSP3-7.0 and two pseudo-global warming runs derived from SSP2-4.5), included directly above the shared streamflow statistics table, mirroring the CONUS docs page structure. Run names and descriptions come from the model axis metadata of the ak_hydro_segments rasdaman coverages. The ERA5-forced Blaskey hindcast (the "historical" model key) is described in the fragment intro rather than listed as a climate model. Co-Authored-By: Claude Opus 4.8 --- templates/documentation/arctic_hydrology.html | 2 + .../documentation/arctic_models_table.html | 65 +++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 templates/documentation/arctic_models_table.html diff --git a/templates/documentation/arctic_hydrology.html b/templates/documentation/arctic_hydrology.html index 531a10f5..6794391e 100644 --- a/templates/documentation/arctic_hydrology.html +++ b/templates/documentation/arctic_hydrology.html @@ -22,6 +22,8 @@

          Arctic Hydrology

          source datasets included at the bottom of this page.

          +{% include "documentation/arctic_models_table.html" %} + {% include "documentation/streamflow_stats_table.html" %}

          Available Water Temperature Statistics

          diff --git a/templates/documentation/arctic_models_table.html b/templates/documentation/arctic_models_table.html new file mode 100644 index 00000000..15e6dc1f --- /dev/null +++ b/templates/documentation/arctic_models_table.html @@ -0,0 +1,65 @@ + +

          Climate models

          + +

          + Streamflow and water temperature were modeled using climate inputs + dynamically downscaled from the following six model runs, all produced at the + National Center for Atmospheric Research (NCAR). The historical baseline + (reported under the historical key, the Blaskey hindcast) was + instead produced by dynamically downscaling ERA5 reanalysis data over the + same domain for 1990–2021. +

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          ModelDescriptionEmissions scenario
          C2LE2Dynamically downscaled CESM2 Large Ensemble member 2SSP3-7.0
          C2LE4Dynamically downscaled CESM2 Large Ensemble member 4SSP3-7.0
          C2LE7Dynamically downscaled CESM2 Large Ensemble member 7SSP3-7.0
          C2LE9Dynamically downscaled CESM2 Large Ensemble member 9SSP3-7.0
          PGWh + High hydroclimate change scenario using the pseudo-global warming (PGW) + method, derived from the mean perturbations of the 75th–100th + percentile of SSP2-4.5 CMIP6 models + SSP2-4.5 (PGW)
          PGWm + Median hydroclimate change scenario using the pseudo-global warming + (PGW) method, derived from the mean perturbations of the + 25th–75th percentile of SSP2-4.5 CMIP6 models + SSP2-4.5 (PGW)
          From 3d3665bd1277794eb45f1a5c8bfb0588f3391bc5 Mon Sep 17 00:00:00 2001 From: Craig Stephenson Date: Wed, 22 Jul 2026 13:46:00 -0800 Subject: [PATCH 5/5] Replace dashes with commas in unit descriptions to avoid misinterpretation. --- .../documentation/streamflow_stats_table.html | 84 +++++++++---------- 1 file changed, 42 insertions(+), 42 deletions(-) diff --git a/templates/documentation/streamflow_stats_table.html b/templates/documentation/streamflow_stats_table.html index dff2b28d..85d76e75 100644 --- a/templates/documentation/streamflow_stats_table.html +++ b/templates/documentation/streamflow_stats_table.html @@ -30,7 +30,7 @@

          Available Streamflow Statistics

          Annual maximum daily flow. Compute the maximum of a 1-day moving average flow for each year. DH1 is the mean of these values (cubic feet - per second - temporal). + per second, temporal). ratio cubic feet per second @@ -41,7 +41,7 @@

          Available Streamflow Statistics

          Annual maximum of 3-day moving average flows. Compute the maximum of a 3-day moving average flow for each year. DH2 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -52,7 +52,7 @@

          Available Streamflow Statistics

          Annual maximum of 7-day moving average flows. Compute the maximum of a 7-day moving average flow for each year. DH3 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -63,7 +63,7 @@

          Available Streamflow Statistics

          Annual maximum of 30-day moving average flows. Compute the maximum of a 30-day moving average flow for each year. DH4 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -74,7 +74,7 @@

          Available Streamflow Statistics

          Annual maximum of 90-day moving average flows. Compute the maximum of a 90-day moving average flow for each year. DH5 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -86,7 +86,7 @@

          Available Streamflow Statistics

          High flow pulse duration. Compute the average duration for flow events with flows above a threshold equal to the 75th percentile value for each year in the flow record. DH15 is the median of the yearly average - durations (days/year - temporal). + durations (days/year, temporal). ratio days per year @@ -96,7 +96,7 @@

          Available Streamflow Statistics

          Duration Annual minimum daily flow. Compute the minimum 1-day average flow for - each year. DL1 is the mean of these values (cubic feet per second - + each year. DL1 is the mean of these values (cubic feet per second, temporal). ratio @@ -108,7 +108,7 @@

          Available Streamflow Statistics

          Annual minimum of 3-day moving average flow. Compute the minimum of a 3-day moving average flow for each year. DL2 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -119,7 +119,7 @@

          Available Streamflow Statistics

          Annual minimum of 7-day moving average flow. Compute the minimum of a 7-day moving average flow for each year. DL3 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -130,7 +130,7 @@

          Available Streamflow Statistics

          Annual minimum of 30-day moving average flow. Compute the minimum of a 30-day moving average flow for each year. DL4 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -141,7 +141,7 @@

          Available Streamflow Statistics

          Annual minimum of 90-day moving average flow. Compute the minimum of a 90-day moving average flow for each year. DL5 is the mean of these - values (cubic feet per second - temporal). + values (cubic feet per second, temporal). ratio cubic feet per second @@ -153,7 +153,7 @@

          Available Streamflow Statistics

          Low flow pulse duration. Compute the average pulse duration for each year for flow events below a threshold equal to the 25th percentile value for the entire flow record. DL16 is the median of the yearly - average durations (days/year - temporal). + average durations (days/year, temporal). ratio days per year @@ -164,7 +164,7 @@

          Available Streamflow Statistics

          Number of days per year below a threshold of 0.1 cubic feet per second per square mile. LF1 is the median annual number of days below the - threshold (number of days/year - temporal). + threshold (number of days/year, temporal). absolute days per year @@ -175,7 +175,7 @@

          Available Streamflow Statistics

          Spring (April–June) maximum of 3-day moving average flows. Compute the maximum of a 3-day moving average flow for each year. - SPR_DUR3 is the median of these values (cubic feet per second - + SPR_DUR3 is the median of these values (cubic feet per second, temporal). ratio @@ -187,7 +187,7 @@

          Available Streamflow Statistics

          Spring (April–June) maximum of 7-day moving average flows. Compute the maximum of a 7-day moving average flow for each year. - SPR_DUR7 is the median of these values (cubic feet per second - + SPR_DUR7 is the median of these values (cubic feet per second, temporal). ratio @@ -199,7 +199,7 @@

          Available Streamflow Statistics

          Summer (July–September) minimum of 3-day moving average flow. Compute the minimum of a 3-day moving average flow for each year. - SUM_DUR3 is the median of these values (cubic feet per second - + SUM_DUR3 is the median of these values (cubic feet per second, temporal). ratio @@ -211,7 +211,7 @@

          Available Streamflow Statistics

          Summer (July–September) minimum of 7-day moving average flow. Compute the minimum of a 7-day moving average flow for each year. - SUM_DUR7 is the median of these values (cubic feet per second - + SUM_DUR7 is the median of these values (cubic feet per second, temporal). ratio @@ -224,7 +224,7 @@

          Available Streamflow Statistics

          High flood pulse count. Compute the average number of flow events with flows above a threshold equal to the 75th percentile value for the entire flow record. FH1 is the mean number of events (number of - events/year - temporal). + events/year, temporal). absolute events per year @@ -235,7 +235,7 @@

          Available Streamflow Statistics

          Flood frequency. Compute the average number of flow events with flows above a threshold equal to the median flow value for the entire flow - record. FH5 is the mean number of events (number of events/year - + record. FH5 is the mean number of events (number of events/year, temporal). absolute @@ -248,7 +248,7 @@

          Available Streamflow Statistics

          Flood frequency. Compute the average number of flow events with flows above a threshold equal to three times the median flow value for the entire flow record. FH6 is the mean number of events (number of - events/year - temporal). + events/year, temporal). absolute events per year @@ -260,7 +260,7 @@

          Available Streamflow Statistics

          Flood frequency. Compute the average number of flow events with flows above a threshold equal to seven times the median flow value for the entire flow record. FH7 is the mean number of events (number of - events/year - temporal). + events/year, temporal). absolute events per year @@ -272,7 +272,7 @@

          Available Streamflow Statistics

          Low flood pulse count. Compute the average number of flow events with flows below a threshold equal to the 25th percentile value for the entire flow record. FL1 is the mean number of events (number of - events/year - temporal). + events/year, temporal). absolute events per year @@ -284,7 +284,7 @@

          Available Streamflow Statistics

          Frequency of low pulse spells. Compute the average number of flow events with flows below a threshold equal to 5 percent of the mean flow value for the entire flow record. FL3 is the mean number of events - (number of events/year - temporal). + (number of events/year, temporal). absolute events per year @@ -296,7 +296,7 @@

          Available Streamflow Statistics

          Flood frequency for April–June. Compute the average number of flow events with flows above a threshold equal to the 10th percentile for the entire flow record. SPR_FREQ is the median number of events - (number of events/year - temporal). + (number of events/year, temporal). absolute events per year @@ -308,7 +308,7 @@

          Available Streamflow Statistics

          Flood frequency for July–September. Compute the average number of flow events with flows below a threshold equal to the 90th percentile for the entire flow record. SUM_FREQ is the median number of events - (number of events/year - temporal). + (number of events/year, temporal). absolute events per year @@ -319,7 +319,7 @@

          Available Streamflow Statistics

          Coefficient of variation (standard deviation/mean) for each year. Compute the coefficient of variation for each year of daily flows. - Compute the mean of the annual coefficients of variation (percent - + Compute the mean of the annual coefficients of variation (percent, temporal). ratio @@ -337,7 +337,7 @@

          Available Streamflow Statistics

          flow record. Percentiles are computed by interpolating between the ordered (ascending) logs of the flow values. Compute the standard deviation and mean for the percentile values. Divide the standard - deviation by the mean (percent - spatial). + deviation by the mean (percent, spatial). ratio percent @@ -432,7 +432,7 @@

          Available Streamflow Statistics

          Mean of monthly flow values for the entire year. Compute the mean of the monthly mean flows for each month of the year. MA99 is the mean of - these 12 values (cubic feet per second - temporal). + these 12 values (cubic feet per second, temporal). ratio cubic feet per second @@ -444,7 +444,7 @@

          Available Streamflow Statistics

          Median of annual maximum flows. Compute the annual maximum flows from monthly maximum flows. Compute the ratio of annual maximum flow to median annual flow for each year. MH14 is the median of these ratios - (dimensionless - temporal). + (dimensionless, temporal). ratio dimensionless @@ -455,7 +455,7 @@

          Available Streamflow Statistics

          Specific mean annual maximum flow. MH20 is the mean of the annual maximum flows divided by the drainage area (cubic feet per second/ - square mile - temporal). + square mile, temporal). ratio cubic feet per second per square mile @@ -467,7 +467,7 @@

          Available Streamflow Statistics

          Base flow. Compute the mean annual flows. Compute the minimum of a 7-day moving average flow for each year and divide them by the mean annual flow for that year. ML17 is the median of those ratios - (dimensionless - temporal). + (dimensionless, temporal). ratio dimensionless @@ -478,7 +478,7 @@

          Available Streamflow Statistics

          Specific mean spring (April–June) maximum flow. SPR_MAG is the median of the annual maximum flows divided by the drainage area (cubic - feet per second/square mile - temporal). + feet per second/square mile, temporal). ratio cubic feet per second per square mile @@ -490,7 +490,7 @@

          Available Streamflow Statistics

          Coefficient of variation (standard deviation/mean) for each year for the summer (July–September). Compute the coefficient of variation for each year of daily flows. Compute the median of the annual - coefficients of variation (percent - temporal). + coefficients of variation (percent, temporal). ratio percent @@ -500,7 +500,7 @@

          Available Streamflow Statistics

          Magnitude Minimum of the summer (July–September) flows divided by the - drainage area (cubic feet per second/square mile - temporal). + drainage area (cubic feet per second/square mile, temporal). absolute cubic feet per second per square mile @@ -511,7 +511,7 @@

          Available Streamflow Statistics

          Rise rate. Compute the change in flow for days in which the change is positive for the entire flow record. RA1 is the mean of these values - (cubic feet per second/day - temporal). + (cubic feet per second/day, temporal). ratio cubic feet per second per day @@ -522,7 +522,7 @@

          Available Streamflow Statistics

          Fall rate. Compute the change in flow for days in which the change is negative for the entire flow record. RA3 is the mean of these values - (cubic feet per second/day - temporal). + (cubic feet per second/day, temporal). ratio cubic feet per second per day @@ -533,7 +533,7 @@

          Available Streamflow Statistics

          Number of reversals. Compute the number of days in each year when the change in flow from one day to the next changes direction. RA8 is the - mean of the yearly values (days - temporal). + mean of the yearly values (days, temporal). ratio days per year @@ -544,7 +544,7 @@

          Available Streamflow Statistics

          Julian date of spring (April–June) maximum. Determine the Julian date that the maximum flow occurs for each year. SPR_ORD is the median - of these values (Julian day - temporal). + of these values (Julian day, temporal). absolute Julian day @@ -555,7 +555,7 @@

          Available Streamflow Statistics

          Julian date of summer (July–September) minimum. Determine the Julian date that the minimum flow occurs for each water year. SUM_ORD - is the median of these values (Julian day - temporal). + is the median of these values (Julian day, temporal). absolute Julian day @@ -566,7 +566,7 @@

          Available Streamflow Statistics

          Julian date of annual maximum. Determine the Julian date that the maximum flow occurs for each year. TH1 is the median of these values - (Julian day - temporal). + (Julian day, temporal). absolute Julian day @@ -577,10 +577,10 @@

          Available Streamflow Statistics

          Julian date of annual minimum. Determine the Julian date that the minimum flow occurs for each water year. TL1 is the median of these - values (Julian day - temporal). + values (Julian day, temporal). absolute Julian day - + \ No newline at end of file