Provided by: grass-doc_7.8.2-1build3_all bug

NAME  - Exports a raster map to a text file as x,y,z values based on cell centers.


       raster, export, output, ASCII, conversion

SYNOPSIS --help     [-i]     input=name[,name,...]      [output=name]      [separator=character]
       [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

           Include no data values

           Allow output files to overwrite existing files

           Print usage summary

           Verbose module output

           Quiet module output

           Force launching GUI dialog

       input=name[,name,...] [required]
           Name of input raster map(s)

           Name for output file (if omitted or "-" output to stdout)

           Field separator
           Special characters: pipe, comma, space, tab, newline
           Default: pipe


       The module exports a raster map as a list of x,y,z values  into  an  ASCII  text


       This  module will by default not export x,y coordinates for raster cells containing a NULL
       value. This includes cells masked by a raster MASK.  Using the flag -i also  these  raster
       cells will be included in the exported data.

       This  module,  as  all GRASS raster modules, will export cells based on the current region
       settings. See the g.region module for details.

       The r.out.ascii module should be used to export an array (of size row x column) containing
       z values.  can combine several input raster maps, which can be convenient when it comes to
       e.g. produce ASCII point cloud files. is simply a front-end to "r.stats -1g[n]".


       In this example, a LiDAR elevation map in the North Carolina sample  dataset  location  is
       exported to CSV format.
       g.region raster=elev_lid792_1m -p input=elev_lid792_1m output=elev_lid792_1m.csv separator=","

       In  this  example,  elevation data from the North Carolina dataset are exported along with
       R,G,B triplet of the related orthophoto into a combined file (requires the import  of  the
       supplementary high-resolution color orthophoto, here called "ortho2010_t792"):
       g.region raster=elev_lid792_1m res=1 -a -p input=elev_lid792_1m,,, \
               separator=space output=pointcloud.asc
       # validate: X Y Z R G B
       head -n 3 pointcloud.asc
       638300.5 220749.5 126.338218689 78 84 71
       638301.5 220749.5 126.3381958008 93 101 86
       638302.5 220749.5 126.3414840698 68 77 59


       Implement this script as a r.out.ascii option?


        g.region, r.mask r.out.ascii, r.stats


       M. Hamish Bowman
       Dept. Marine Science
       Otago University, New Zealand


       Available at: source code (history)

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

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