r.transect
Outputs raster map layer values lying along user defined transect line(s).
r.transect [-g] map=name line=east,north,azimuth,distance [,east,north,azimuth,distance,...] [null_value=string] [--verbose] [--quiet] [--qq] [--ui]
Example:
r.transect map=name line=east,north,azimuth,distance
grass.script.parse_command("r.transect", map, line, null_value="*", flags=None, verbose=False, quiet=False, superquiet=False)
Example:
gs.parse_command("r.transect", map="name", line="east,north,azimuth,distance")
Parameters
map=name [required]
Raster map to be queried
line=east,north,azimuth,distance [,east,north,azimuth,distance,...] [required]
Transect definition
null_value=string
String representing NULL value
Default: *
-g
Output easting and northing in first two columns of four column output
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
map : str, required
Raster map to be queried
Used as: input, raster, name
line : list[tuple[str, str, str, str]] | tuple[str, str, str, str] | list[str] | str, required
Transect definition
Used as: east,north,azimuth,distance
null_value : str, optional
String representing NULL value
Used as: string
Default: *
flags : str, optional
Allowed values: g
g
Output easting and northing in first two columns of four column output
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
r.transect outputs, in ASCII, the values in a raster map which lie along one or more user-defined transect lines. The transects are described by their starting coordinates, azimuth, and distance.
The line parameter is a definition of (each) transect line, specified by the geographic coordinates of its starting point (easting, northing), the angle and direction of its travel (azimuth), and its distance (distance).
The azimuth is an angle, in degrees, measured to the east of north. The distance is in map units (meters for a metered database, like UTM).
The null parameter can optionally be set to change the character string representing null values.
NOTES
This program is a front-end to the r.profile program. It simply converts the azimuth and distance to an ending coordinate and then runs r.profile. There once were width= and result=raw|median|average options which are not currently implemented.
SEE ALSO
AUTHOR
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
SOURCE CODE
Available at: r.transect source code
(history)
Latest change: Monday Feb 24 16:07:55 2025 in commit 4ab71fd