SCCWRP / rainfall_flow_calculator_shiny

Shiny app developed to enable consistent, transparent, easily applied calculations to generate statistics commonly use to describe rainfall and flow characteristics during stormwater best management practice (BMP) monitoring studies.

Rainfall and Flow Calculator API

Purpose

This web application has been developed to enable consistent, transparent, easily applied calculations to generate statistics commonly use to describe rainfall and flow characteristics during stormwater best management practice (BMP) monitoring studies. The web app provides 2 types of analysis: rainfall and flow. For the rainfall analysis, the app provides the cumulative rainfall depth, rainfall duration, average rainfall intensity, and the maximum rainfall intensity over a 5-min or 10-min duration within a monitored event based on a user-uploaded hyetograph. For the flow analysis, hydrograph statistics determined by the web app include the total runoff volume, runoff duration, and peak (maximum) flow rate. If multiple hydrographs are provided for a single event, for example representing BMP inflow, outflow, and bypass, additional statistics are determined.

Method

Rainfall Statistics

The total rainfall is the cumulative precipitation depth measured for each event. The average rainfall intensity is the ratio of the total rainfall to the total rainfall duration. The peak 5-min or 10-min rainfall intensity is given by the maximum depth of rainfall over any 5-min or 10-min interval, respectively. Precipitation statistics are calculated as:

$$ P= \sum_{j=1}^{t} P_j \Delta t $$

Equation 1

$$i_{ave}=\frac{P}{t_P} $$

Equation 2

$$i_{P5}=\max \left( \frac{\sum\limits_{i}^{(i+5)} P_i}{5-min} \right)$$

Equation 3

Where P = total rainfall during an event (length, e.g., mm or in), $\Delta t$ = rain gauge data logging interval (e.g., min), $t_P$ = total rainfall duration, determined as the elapsed time from the first rain tip to the last rain tip (time), $i_{ave}$ = average rainfall intensity over the duration of the event (length/time), $P_5$ = 5-min precipitation depth (length), $i_{P5}$ = maximum rainfall intensity over a 5-min period (length/time).

Flow Statistics

Urban BMP monitoring studies typically generate runoff hydrographs where flow is measured at 1-15 min intervals. Runoff volume is determined from the integral of the hydrograph; this accomplished by using a numerical approximation to calculate the area under the hydrograph curve. In this application, area under the curve between two known flow measurements (i.e., the runoff volume for the interval) is computed using a trapezoid. The cumulative runoff volume is determined from the sum of the areas of each trapezoid.

$$ V=\int_0^t Q dt \approx \sum_{n=1}^i \frac{(Q_i+Q_{i-1})}{2}(t_i-t_{i-1}) $$

Equation 4

Where V = runoff volume $(length^3)$, $Q_i$ = flow rate $(length^3/time)$ recorded at time $t_i$, and t = time.

The runoff duration is the elapsed time between the beginning and end of the runoff hydrograph. The beginning and end of the hydrograph are currently user-specified timestamps.

The peak flow is the maximum flow rate reported over a 5-min period. If data are reported in less than 5-min intervals, the peak flow is determined as the maximum 5-min moving average .

$$ Q_p=max(Q_i )$$

Equation 5

Where $Q_p$ = peak flow $(length^3/time)$.

Hydrologic mitigation or alteration provided by BMPs is often reported as a percent change in characteristic (flow rate or volume) between the inflow and the outflow, as illustrated for the simplest data collection scenario in

$$\text{Figure 1. Typical, simple BMP hydrologic measurement scenario.}$$

Equation 6

The associated calculation is:

$$ \text{percent change} = \frac{\text{(Inflow value-Outflow value)}}{\text{(Inflow value)}} × 100% $$

Where the “value” is either $Q_p$ or V determined by the calculator. Inflow and outflow hydrographs must be provided by the user in order to calculate % change.

The web app can calculate a % change in volume during events where runoff bypass or overflow occur, if the relevant hydrograph is provided. The terms “bypass” and “overflow” are used interchangeably here, indicating flow that is not managed by the BMP. Physically this may be flow that exceeds the inlet capacity and is routed around the BMP, or it may enter the BMP but flow directly to the outlet structure because the BMP capture capacity is exceeded (Figure 1). Either physical case is treated the same way for calculating the volume change statistic:

$$\text{Figure 2. Typical BMP hydrologic measurement scenario with bypass.}$$

The associated calculation is:

$$ \text{percent change} = \frac{(V_{in}+V_{byp}-V_{out})}{(V_{in} + V_{byp})} \times 100 % $$

Equation 7

The web app can also calculate a % change in volume if there is more than one inflow to the BMP, including bypass (Equation 8), as illustrated in Figure 2.

$$\text{Figure 3. BMP hydrology with multiple inlets and bypass}$$

The associated calculation is:

$$ \text{percent change} = \frac{(V_{in1}+V_{in2}+V_{byp} - V_{out})}{(V_{in1}+V_{in2}+V_{byp})} \times 100% $$

Equation 8