GRASS logo

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

Table of contents


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


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)

Latest change: Thursday Jan 26 14:10:26 2023 in commit: cdd84c130cea04b204479e2efdc75c742efc4843

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

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual