optimise_region: Computes and regionalizes optimal estimate from multiple...

In mkkallio/hydrostreamer: A Package for Interpolating Distributed Runoff Products on to Explicit River Segments

Computes and regionalizes optimal estimate from multiple discharge timeseries against observed streamflow

Description

Algorithm routes runoff using user specified routing algorithm, for each observation point in sequence starting from the most upstream point. The optimum weight combination is regionalized to the river segments upstream from the optimisation point which do not contain observation information.

Usage

optimise_region(
  HS,
  routing = "instant",
  train = 0.5,
  optim_method = "CLS",
  combination = "ts",
  sampling = "random",
  region_type = "upstream",
  no_station = "em",
  drop = TRUE,
  ...,
  verbose = FALSE
)

Arguments

HS	An HS object with observation_ts and runoff_ts
routing	Routing algorithm to use. See accumulate_runoff for options.
train	The share of timeseries used for training period.
optim_method	A character object giving the optimisation method to be used, or a function to be passed to optim. See details.
combination	Whether to do the forecast combination for the entire timeseries, or each month of the year individually, or for full calendar years. Accepts "timeseries", "ts", or "monthly", "mon", or "annual", "ann".
sampling	How to sample training and testing periods. "series" for training serially from beginning, or "random" for a random sample for both training and testing periods.
region_type	How to regionalize combination weights. See details.
no_station	How to handle river segments with no downstream stations. See details.
drop	Drop existing timeseries (columns) in runoff_ts, discharge_ts, or not.
...	Additional parameters passed to the routing algorithm and/or to optimisation..
verbose	Whether or not print progress indicators.

Details

See optimise_point for help with optimisation options. Note: unlike optimise_point, runoff does not need to be routed in advance, but it is done by the function automatically.

Currently only one regionalization type is implemented: upstream uses the weights obtained for the nearest downstream station for the river segment.

Options for no_station is currently only one: "em", which stands for "ensemble mean". For those river segments with no weights assigned from a station (segments with no downstream observation station), an ensemble mean (each discharge prediction is given equal weight) is computed.

Value

Returns an HS object with routed and optimised discharge_ts, and additional optimisation information in Optimisation_info and Optimised_at.

mkkallio/hydrostreamer documentation built on Oct. 14, 2023, 9:38 p.m.