Ubuntu Manpage: r.profile - Outputs the raster map layer values lying on user-defined line(s).

NAME

       r.profile  - Outputs the raster map layer values lying on user-defined line(s).

KEYWORDS

       raster, profile

SYNOPSIS

       r.profile
       r.profile help
       r.profile   [-igc]   input=name   [output=string]    [profile=east,north[,east,north,...]]    [res=float]
       [null=string]   [--verbose]  [--quiet]

   Flags:
       -i
           Interactively select End-Points

       -g
           Output easting and northing in first two columns of four column output

       -c
           Output RRR:GGG:BBB color values for each profile point

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=name
           Name of input 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. 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.
       r.profile -ig input=elev.rast | v.in.ascii output=elev.profile fs=space
        The 2 column output is compatible with most plotting programs.

       The optional RGB output provides the associated GRASS colour value for each profile point.

EXAMPLES

       Example 1
       Extract a profile with coordinates provided on the command line:
       r.profile input=elev.rast output=profile.pts profile=562517,7779433,562984,7779533,563875,7779800
        This will extract a profile along the track defined by the three coordinate pairs.

       Example 2
       Extract a profile by interactively selecting the profile route from the GRASS monitor:
       r.profile -i input=elev.rast output=profile.pts
         Use  the left mouse button to select the profile route in the GRASS monitor. Use the right mouse button
       to end the profile.

       Example 3
       Extract a profile with coordinates provided from standard input or an external file:

       First create a points file with d.where
       d.where > saved.points
        Then pipe the points file into r.profile
       cat saved.points | r.profile input=elev.rast output=profile.pts
        The advantage of this method is that the same profile points can be piped into different  GRASS  rasters
       by changing the input parameter.

       With  this  method  the  coordinates must be given as space or tab separated easting and northing. Labels
       after these values are ignored.

       Another example using d.where:
       d.where | r.profile elevation.dem

       Example 4
       Pipe coordinates into r.profile
       r.profile elevation.dem res=1000 << EOF
        591243,4926344
        592509,4922156
        594100,4920793
        599910,4919365
        602929,4919235
        604844,4918391
        606468,4917190
        607766,4915664
       EOF

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.

AUTHOR

       Bob Covill

       Last changed: $Date: 2010-01-15 06:57:25 -0800 (Fri, 15 Jan 2010) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                    r.profile(1grass)