Build a limnigraph

generate_limnigraph() builds external limnigraphs that are used as boundary conditions for interior hydraulic simulation. It also gives the corresponding openings to each limnigraph

Usage

generate_limnigraph(
  time,
  depth,
  external,
  verbose = getOption("floodam_building_verbose")
)

Arguments

time

numeric, time steps (in seconds) at which a specific floodwater depth is reached

depth

numeric, depths (in meters) reached at time steps given by time

external

character or list of characters, names of the walls concerned by external limnigraphs

verbose

boolean, will floodam tells what it is doing, default to getOption("floodam_building_verbose")

Value

list, with a matrix containing limnigraphs, and a list of the matching openings

Details

time gives the different time steps used for all limnigraphs. Its length is used as the standard.

depth can be a vector of the same length as time. In that case only one limnigraph will be produced. For more limnigraphs a matrix with colnames shall be used.

external gives corresponding openings to each limnigraphs (columns of depth). In case only one limingraph is given, external can be directly a character vector of corresponding opnenings.

Examples

# Simpliest limnigraph (one external)
limnigraph = generate_limnigraph(
  time = c(0, 1000, 2000),
  depth = c(0, 1, 0),
  external = "wall"
)
#> generating limnigraph ...
#>  limnigraph successfully generated

# Limnigraph
limnigraph = generate_limnigraph(
  time = c(0, 300, 900),
  depth = cbind(external_1 = c(0, 3, 0)),
  external = list(
    external_1 = c("wall_A", "wall_B", "wall_C", "wall_D", "wall_E", "wall_F", "wall_G", "wall_H"))
)
#> generating limnigraph ...
#>  limnigraph successfully generated