v.gsflow.segments
Prepares stream segments for PRMS and GSFLOW
v.gsflow.segments input=name output=name [icalc=integer] [cdpth=float] [fdpth=float] [awdth=float] [bwdth=float] [iupseg=string] [flow=string] [runoff=string] [etsw=string] [pptsw=string] [roughch_value=float] [roughch_raster=string] [roughch_points=string] [roughch_pt_col=string] [roughbk_value=float] [roughbk_raster=string] [roughbk_points=string] [roughbk_pt_col=string] [width1=float] [width2=float] [width_points=string] [width_points_col=string] [width1=float] [width2=float] [width_points=string] [width_points_col=string] [fp_width_value=float] [fp_width_pts=string] [fp_width_pts_col=string] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]
Example:
v.gsflow.segments input=name output=name
grass.script.run_command("v.gsflow.segments", input, output, icalc=1, cdpth=0.4, fdpth=0.42, awdth=4, bwdth=0.23, iupseg="0,0", flow="0,0", runoff="0,0", etsw="0,0", pptsw="0,0", roughch_value=0.035, roughch_raster=None, roughch_points=None, roughch_pt_col=None, roughbk_value=0.06, roughbk_raster=None, roughbk_points=None, roughbk_pt_col=None, width1=5, width2=5, width_points=None, width_points_col=None, width1=5, width2=5, width_points=None, width_points_col=None, fp_width_value=0, fp_width_pts=None, fp_width_pts_col=None, overwrite=False, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("v.gsflow.segments", input="name", output="name")
Parameters
input=name [required]
Vector stream network from r.stream.extract
Or data source for direct OGR access
output=name [required]
Segments: stream segments for GSFLOW / PRMS
Name for output vector map
icalc=integer
Stream depth option: 0-const; 1,2-Manning (rect/8-pt); 3-aQ^b
Default: 1
cdpth=float
Flow depth coefficient [meters]; used if ICALC=3
Default: 0.4
fdpth=float
Flow depth exponent; used if ICALC=3
Default: 0.42
awdth=float
Flow width coefficient [meters]; used if ICALC=3
Default: 4
bwdth=float
Flow width exponent; used if ICALC=3
Default: 0.23
iupseg=string
Category of upstream diversion segment (from_cat,to_cat,...)
Default: 0,0
flow=string
Streamflow entering the upstream-most segs (cat,Q,cat,Q,...)
Default: 0,0
runoff=string
Diffuse runoff entering each segment (cat,Q,cat,Q,...)
Default: 0,0
etsw=string
Direct removal of in-channel water by ET (cat,Q,cat,Q)
Default: 0,0
pptsw=string
Direct precipitation on the stream (cat,Q,cat,Q)
Default: 0,0
roughch_value=float
In-channel Manning's n (single value) for ICALC=1,2
Default: 0.035
roughch_raster=string
In-channel Manning's n raster map for ICALC=1,2
roughch_points=string
In-channel Manning's n vector point meas for ICALC=1,2
roughch_pt_col=string
Column name for in-channel n point measurements
roughbk_value=float
Overbank Manning's n for ICALC=2
Default: 0.06
roughbk_raster=string
Overbank Manning's n raster map for ICALC=2
roughbk_points=string
Overbank Manning's n vector point meas for ICALC=2
roughbk_pt_col=string
Column name for overbank n point measurements
width1=float
Upstream width in segment [m], uniform in watershed
Default: 5
width2=float
Downstream width in segment [m], uniform in watershed
Default: 5
width_points=string
Channel width point meas vect (instead of width1,width2)
width_points_col=string
Channel width point meas vect column
width1=float
Upstream width in segment [m], uniform in watershed
Default: 5
width2=float
Downstream width in segment [m], uniform in watershed
Default: 5
width_points=string
Channel width point meas vect (instead of width1,width2)
width_points_col=string
Channel width point meas vect column
fp_width_value=float
Floodplain width as constant value (ICALC=2)
Default: 0
fp_width_pts=string
Floodplain width measurement vector (ICALC=2)
fp_width_pts_col=string
Floodplain width measurement column (ICALC=2)
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
input : str, required
Vector stream network from r.stream.extract
Or data source for direct OGR access
Used as: input, vector, name
output : str, required
Segments: stream segments for GSFLOW / PRMS
Name for output vector map
Used as: output, vector, name
icalc : int, optional
Stream depth option: 0-const; 1,2-Manning (rect/8-pt); 3-aQ^b
Default: 1
cdpth : float, optional
Flow depth coefficient [meters]; used if ICALC=3
Default: 0.4
fdpth : float, optional
Flow depth exponent; used if ICALC=3
Default: 0.42
awdth : float, optional
Flow width coefficient [meters]; used if ICALC=3
Default: 4
bwdth : float, optional
Flow width exponent; used if ICALC=3
Default: 0.23
iupseg : str, optional
Category of upstream diversion segment (from_cat,to_cat,...)
Default: 0,0
flow : str, optional
Streamflow entering the upstream-most segs (cat,Q,cat,Q,...)
Default: 0,0
runoff : str, optional
Diffuse runoff entering each segment (cat,Q,cat,Q,...)
Default: 0,0
etsw : str, optional
Direct removal of in-channel water by ET (cat,Q,cat,Q)
Default: 0,0
pptsw : str, optional
Direct precipitation on the stream (cat,Q,cat,Q)
Default: 0,0
roughch_value : float, optional
In-channel Manning's n (single value) for ICALC=1,2
Default: 0.035
roughch_raster : str, optional
In-channel Manning's n raster map for ICALC=1,2
roughch_points : str, optional
In-channel Manning's n vector point meas for ICALC=1,2
roughch_pt_col : str, optional
Column name for in-channel n point measurements
roughbk_value : float, optional
Overbank Manning's n for ICALC=2
Default: 0.06
roughbk_raster : str, optional
Overbank Manning's n raster map for ICALC=2
roughbk_points : str, optional
Overbank Manning's n vector point meas for ICALC=2
roughbk_pt_col : str, optional
Column name for overbank n point measurements
width1 : float, optional
Upstream width in segment [m], uniform in watershed
Default: 5
width2 : float, optional
Downstream width in segment [m], uniform in watershed
Default: 5
width_points : str, optional
Channel width point meas vect (instead of width1,width2)
width_points_col : str, optional
Channel width point meas vect column
width1 : float, optional
Upstream width in segment [m], uniform in watershed
Default: 5
width2 : float, optional
Downstream width in segment [m], uniform in watershed
Default: 5
width_points : str, optional
Channel width point meas vect (instead of width1,width2)
width_points_col : str, optional
Channel width point meas vect column
fp_width_value : float, optional
Floodplain width as constant value (ICALC=2)
Default: 0
fp_width_pts : str, optional
Floodplain width measurement vector (ICALC=2)
fp_width_pts_col : str, optional
Floodplain width measurement column (ICALC=2)
overwrite: bool, optional
Allow output files to overwrite existing files
Default: False
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
v.gsflow.segments produces channel segments that are each one link in the full drainage network. Each segment also corresponds to a hydrologic response unit (HRU) in this formulation. These are used for the USGS combined groundwater (MODFLOW) and surface-water (PRMS) model GSFLOW.
REFERENCES
Ng, G.-H. C., A. D. Wickert, R. L. McLaughlin, J. La Frenierre, S. Liess, and L. Sabeeri (2016), Modeling the role of groundwater and vegetation in the hydrological response of tropical glaciated watersheds to climate change, in AGU Fall Meeting Abstracts, H13L–1590, San Francisco, CA.
SEE ALSO
v.gsflow.export, v.gsflow.gravres, v.gsflow.grid, v.gsflow.hruparams, v.gsflow.reaches, v.gsflow.mapdata, v.stream.inbasin, v.stream.network
AUTHOR
Andrew D. Wickert
SOURCE CODE
Available at: v.gsflow.segments source code
(history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819