Add a column of daily volumetric flows to a daily streamflow data set, in units of cubic metres. Converts the discharge to a volume.

add_daily_volume(data, values = Value, station_number)

Arguments

data

Data frame of daily data that contains columns of dates, flow values, and (optional) groups (e.g. station numbers). Leave blank or set to NULL if using station_number argument.

values

Name of column in data that contains numeric flow values, in units of cubic metres per second. Only required if values column name is not 'Value' (default). Leave blank if using station_number argument.

station_number

Character string vector of seven digit Water Survey of Canada station numbers (e.g. "08NM116") of which to extract daily streamflow data from a HYDAT database. Requires tidyhydat package and a HYDAT database. Leave blank if using data argument.

Value

A tibble data frame of the source data with an additional column:

Volume_m3

daily total volumetric flow, in units of cubic metres

Examples

# Run if HYDAT database has been downloaded (using tidyhydat::download_hydat())
if (file.exists(tidyhydat::hy_downloaded_db())) {

# Add a column of daily flow volumes
add_daily_volume(station_number = "08NM116")

}
#> # A tibble: 23,079 × 6
#>    STATION_NUMBER Date       Parameter Value Symbol Volume_m3
#>    <chr>          <date>     <chr>     <dbl> <chr>      <dbl>
#>  1 08NM116        1949-04-01 Flow       1.13 E         97632.
#>  2 08NM116        1949-04-02 Flow       1.53 E        132192.
#>  3 08NM116        1949-04-03 Flow       2.07 E        178848.
#>  4 08NM116        1949-04-04 Flow       2.07 E        178848.
#>  5 08NM116        1949-04-05 Flow       2.21 E        190944.
#>  6 08NM116        1949-04-06 Flow       2.21 NA       190944.
#>  7 08NM116        1949-04-07 Flow       2.27 NA       196128.
#>  8 08NM116        1949-04-08 Flow       2.35 NA       203040.
#>  9 08NM116        1949-04-09 Flow       2.78 NA       240192.
#> 10 08NM116        1949-04-10 Flow       2.94 NA       254016.
#> # … with 23,069 more rows