NAME
r.profile - Outputs the raster map layer values lying on user-defined line(s).
SYNOPSIS
r.profile
r.profile help
r.profile [-ig] input=string [output=string] [profile=east,north[,east,north,...]] [res=float] [null=string]
Flags:
- -i
- Interactively select End-Points
- -g
- Output easting and northing in first two columns of four column output
Parameters:
- input=string
- Name of existing raster map
- output=string
- Name of file for output (use output=- for stdout)
- Default: -
- profile=east,north[,east,north,...]
- Profile Coordinate Pairs
- res=float
- Resolution along profile (default = current region resolution)
- null=string
- Character to represent no data cell
- Default: *
DESCRIPTION
This program outputs two or four column (with -g) data to stdout or
an ASCII file. The default two column output consists of cumulative profile
length (in meters) and raster value. The optional four column output consists
of easting, northing, cumlative profile length (m), and raster value. Profile
end or "turning" points can be set manually with the profile
argument or selected interactively from the GRASS monitor by setting the
-i flag. The profile resolution, or distance between profile
points, is obtained from the current region resolution, or can be manually
set with the res argument.
The -i flag allows the user for selecting the profile from the GRASS
monitor by clicking the left mouse button along the profile; clicking the
right mouse button ends the profile.
The profile parameter can be set to comma separated geographic
coordinates for profile line endpoints. The interactive flag (-i)
overrides this option.
The res parameter sets the distance between each profile point
(resolution). The resolution must be provided in GRASS database units (i.e.
decimal degrees for Lat Long databases and meters for UTM). By default
r.profile uses the resolution of the current GRASS region.
The null parameter can optionally be set to change the character
string representing null values.
OUTPUT FORMAT
The 2 or 4 column output from r.profile is intended for easy use in
other programs. The output can be piped (|) directly into other programs or
saved to a file for later use. The 4 column output is compatible with
s.in.ascii and can be piped direcly into
this program for later plotting.
r.profile -ig input=elev.rast | s.in.ascii output=elev.profile
The 2 column output is compatible with most plotting programs.
NOTES
The profile resolution is measured exactly from the supplied end or
"turning" point along the profile. The end of a profile segment will be an
exact multiple of the profile resolution and will therefore not always match
the end point coordinates entered for the segmanet.
To extract the numbers in scripts, following parameters can be used:
r.profile input=dgm12.5 profile=3570631,5763556 2>/dev/null
This filters out the everything except the numbers.
SEE ALSO
d.profile,
r.what,
r.transect
AUTHOR
Bob Covill
Last changed: $Date: 2004/02/24 00:29:59 $
Help Index