ScaleFloodData: Scale 'FloodData.txt' files to different model time steps

In rcapell/RHYPE: Tools for Processing and Analyzing Files from the Hydrological Catchment Model HYPE

Scale 'FloodData.txt' files to different model time steps

Description

ScaleFloodData scales the time step-dependent recession coefficients in an imported HYPE 'FloodData.txt' file to a new target time step. See HYPE wiki tutorial on sub-daily time steps.

Usage

ScaleFloodData(
  x = NULL,
  timestep.ratio = 1/24,
  digits = 3,
  verbose = TRUE,
  print.par = FALSE
)

Arguments

x	Data frame containing HYPE FloodData contents. Typically imported with ReadFloodData().
timestep.ratio	Numeric, time step scaling factor. Defaults to (1/24) to scale from daily to hourly time steps. To scale from hourly to daily time steps use 24.
digits	Integer, number of significant digits in scaled parameter values to export. See signif().
verbose	Logical, if TRUE, then information will be printed.
print.par	Logical, print known time-scale dependent recession coefficients instead of scaling a FloodData data frame.

Details

ScaleFloodData applies a user-specified scaling factor timestep.ratio to the time step-dependent recession coefficients in a HYPE FloodData data frame. ' Recession coefficients are matched against an inbuilt set of column names. To see these names, call ScaleFloodData(print.par = TRUE). Please notify us if you find any missing coefficients.

Timestep-dependent recession coefficients are scaled using the relationship described in: Nalbantis, Ioannis (1995). “Use of multiple-time-step information in rainfall-runoff modelling”, Journal of Hydrology 165, 1-4, pp. 135–159.

new_coefficient_value = 1 - (1 - old_coefficient_value)^time_step_ratio

Use the ScalePar and ScaleAquiferData functions to scale the time-dependent parameters and recession coefficients in par.txt and AquiferData.txt files, respectively. Note that ScalePar does not scale the values for the "gratk", "ilratk", "olratk", or "wetrate" rating curve recession coefficients in par.txt because they are not limited to the range 0-1. Likewise, HYPEtools does not provide any scaling function for the "RATE" columns in DamData.txt and LakeData.txt because these values are not limited to the range 0-1. We recommend looking at the results from the lakes/wetlands and recalibrating these parameters and their related power coefficients as needed.

Value

A data.frame() object as supplied in x, with re-scaled recession coefficients, or nothing if print.par = TRUE.

See Also

ScaleAquiferData ScalePar

Examples

# Import daily HYPE FloodData file
fd <- ReadFloodData(filename = system.file("demo_model",
"FloodData_Example.txt", package = "HYPEtools"))
# Scale to hourly time steps
ScaleFloodData(x = fd)
# Print all time scale-dependent coefficients known to the function
ScaleFloodData(print.par = TRUE)

rcapell/RHYPE documentation built on Feb. 28, 2024, 3:11 p.m.