Provided by: grass-doc_7.6.0-1_all bug


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


       raster, profile, transect


       r.profile --help
       r.profile   [-gc]  input=name   [output=name]    [coordinates=east,north[,east,north,...]]
       [file=name]   [resolution=float]    [null_value=string]    [units=string]    [--overwrite]
       [--help]  [--verbose]  [--quiet]  [--ui]

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

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

           Allow output files to overwrite existing files

           Print usage summary

           Verbose module output

           Quiet module output

           Force launching GUI dialog

       input=name [required]
           Name of input raster map

           Name of file for output (use output=- for stdout)
           Default: -

           Profile coordinate pairs

           Name of input file containing coordinate pairs
           Use instead of the ’coordinates’ option. "-" reads from stdin.

           Resolution along profile (default = current region resolution)

           String representing NULL value
           Default: *

           If  units  are  not  specified,  current  location  units are used. Meters are used by
           default in geographic (latlon) locations.
           Options: meters, kilometers, feet, miles


       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 and raster value. The
       optional four column output consists of easting, northing, cumulative profile length,  and
       raster  value.  Profile  end  or "turning" points can be set manually with the coordinates
       argument. The profile resolution, or distance between profile points, is obtained from the
       current region resolution, or can be manually set with the resolution argument.

       The coordinates parameter can be set to comma separated geographic coordinates for profile
       line endpoints.  Alternatively the coordinate pairs  can  be  piped  from  the  text  file
       specified  by  file  option,  or if set to "-", from stdin.  In these cases the coordinate
       pairs should be given one comma separated pair per line.

       The resolution 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


       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  and  can  be  piped
       direcly into this program.
       r.profile -g input=elevation coordinates=... | output=elevation_profile separator=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.

       Option  units  enables  to  set  units of the profile length output.  If the units are not
       specified, current  location  units  will  be  used.   In  case  of  geographic  locations
       (latitude/longitude), meters are used as default unit.


       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

       To extract the numbers in scripts, following parameters can be used:
       r.profile input=dgm12.5 coordinates=3570631,5763556 2>/dev/null
       This filters out the everything except the numbers.


   Extraction of values along profile defined by coordinates (variant 1)
       Extract a profile with coordinates (wayoints) provided on the command line (North Carolina
       data set):
       g.region raster=elevation -p
       r.profile -g input=elevation output=profile_points.csv \
       This  will  extract  a  profile along the track defined by the three coordinate pairs. The
       output file "profile_points.csv" contains east,north,distance,value (here: elevation).

   Extraction of values along profile defined by coordinates (variant 2)
       Coordinate pairs can also being "piped" into r.profile (variant 2a):
       r.profile elevation resolution=1000 file=- << EOF

       Coordinate pairs can also being "piped" into r.profile (variant 2b):
       echo "641712,226095
       641049,221186" > coors.txt
       cat coors.txt | r.profile elevation resolution=1000 file=-
       The output is printed into the terminal (unless the output parameter is used) and looks as
       Using resolution: 1000 [meters]
       Output columns:
       Along track dist. [meters], Elevation
       Approx. transect length: 1964.027749 [meters]
        0.000000 84.661507
        1000.000000 98.179062
       Approx. transect length: 2090.000000 [meters]
        1964.027749 83.638138
        2964.027749 89.141029
        3964.027749 78.497757
       Approx. transect length: 995.014070 [meters]
        4054.027749 73.988029

SEE ALSO, r.what, r.transect, wxGUI profile tool


       Bob Covill

       Last changed: $Date: 2015-06-07 20:56:26 +0200 (Sun, 07 Jun 2015) $


       Available at: r.profile source code (history)

       Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual