table of contents
other versions
- wheezy 6.4.2-2
- jessie 6.4.4-1
- testing 7.2.0-2
- unstable 7.2.0-2
- experimental 7.2.1-1~exp1
r.profile(1grass) | Grass User's Manual | r.profile(1grass) |
NAME¶
r.profile - Outputs the raster map layer values lying on user-defined line(s).KEYWORDS¶
raster, profileSYNOPSIS¶
r.profileFlags:¶
- -i
-
- -g
-
- -c
-
- --verbose
-
- --quiet
-
Parameters:¶
- input=name
-
- output=string
-
- profile=east,north[,east,north,...]
-
- res=float
-
- null=string
-
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. Alternatively the coordinate pairs can be piped from stdin, one comma separated pair per line. 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 multi 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. Output with geographic coordinates ( -g) is compatible with v.in.ascii and can be piped direcly into this program.EXAMPLES¶
Example 1591243,4926344
592509,4922156
594100,4920793
599910,4919365
602929,4919235
604844,4918391
606468,4917190
607766,4915664
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:SEE ALSO¶
v.in.ascii, d.where, d.profile, r.what, r.transect, gis.m: PROFILE TOOLAUTHOR¶
Bob Covill Last changed: $Date: 2010-01-15 15:57:25 +0100 (Fri, 15 Jan 2010) $ Full index © 2003-2011 GRASS Development TeamGRASS 6.4.2 |