GRASS logo

NAME

r.lake.series - Fills lake at given point(s) to given levels.

KEYWORDS

raster, hydrology, hazard, flood

SYNOPSIS

r.lake.series
r.lake.series --help
r.lake.series [-nc] elevation=name output=name start_water_level=float end_water_level=float water_level_step=float [coordinates=east,north] [seed_raster=name] [time_step=integer] [time_unit=string] [nproc=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-n
Use negative depth values for lake raster map
This flag is passed to r.lake module.
-c
Use map number instead of the water level in map name (currently ignored)
This names are always in the right alphabetical order and are also valid vector map names.
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

elevation=name [required]
Name of input elevation raster map
output=name [required]
Name of the output space time raster dataset
The name of the dataset is used as a base name for created output maps. Map names will consist of a base name, underscore and water level value or number depending on -c flag.
start_water_level=float [required]
Start water level
Units should be meters?
end_water_level=float [required]
Final (maximal) water level
Units should be meters?
water_level_step=float [required]
Water level step
Units should be meters?
coordinates=east,north
Seed point coordinates
Either this coordinates pair or a seed map name have to be specified.
seed_raster=name
Name of input raster map with given starting point(s) (at least 1 cell > 0)
Either this parameter or a coordinates pair have to be specified.
time_step=integer
Time increment
Time increment between two states (maps) used to register output maps in space-time raster dataset. Used together with time_units parameter.
Options: 0-
Default: 30
time_unit=string
Time units
Time units used to register output maps in space-time raster dataset. Used together with time_step parameter.
Options: years, months, days, hours, minutes, seconds
Default: minutes
nproc=integer
Number of processes to run in parallel (currently ignored)
Options: 1-
Default: 1

Table of contents

DESCRIPTION

r.lake.series fills a lake or any area from a given start point or areas specified by raster map (seed_raster option). The module generates one map containing filled areas for each water level specified by water level options (start_water_level, end_water_level, water_level_step). This module uses r.lake module to generate individual maps for the map series. See r.lake manual for further discussion. Note that water level is absolute height, so it should be in same range as you digital elevation model. On the other hand, water depth in output maps is relative to the water level.

This module outputs:

EXAMPLE

The following example presents a bigger flooding in rural area of North Carolina sample dataset and included also visualization examples.
# using unix-like shell syntax

# set computational region
g.region raster=elev_lid792_1m
# prepare input data
v.to.rast -d input=streams output=rural_streams use=val val=1

# compute a flooding scenario
r.lake.series elevation=elev_lid792_1m seed=rural_streams \
              start_wl=104.0 end_wl=115.0 wl_step=0.2 output=flooding

# visualize the flooding space-time raster dataset
g.gui.animation strds=flooding

# alternatively explore maps from dataset
# prepare shaded relief map
r.relief input=elev_lid792_1m output=elev_lid792_1m_shade
# set color table for streams
r.colors map=rural_streams rules=- <<EOF
1 blue
EOF

# open d.mon or map display
d.mon wx1

# show base maps
d.rast elev_lid792_1m_shade
d.rast rural_streams

# show particular flooding maps
d.rast flooding_105.0
d.rast flooding_108.0
d.rast flooding_114.0

Figure: A bigger flooding in rural area of North Carolina sample dataset with water level at 105, 108 and 114 meters (water depth differs in different areas).

SEE ALSO

r.lake

AUTHORS

Vaclav Petras, NCSU OSGeoREL,
Maris Nartiss (author of r.lake)

SOURCE CODE

Available at: r.lake.series source code (history)

Latest change: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730


Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 8.2.2dev Reference Manual