NAME¶

r.out.xyz - Export a raster map to a text file as x,y,z values based on cell centers.

KEYWORDS¶

raster, export

SYNOPSIS¶

r.out.xyz r.out.xyz help r.out.xyz input=name[,name,...] [output=name] [ fs=character] [--verbose] [--quiet]

Parameters:¶

input=name[,name,...]

 

Name of input raster map

output=name

 

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

fs=character

 

Field separator

 

Default: |

DESCRIPTION¶

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

NOTES¶

This module will not export x,y coordinates for raster cells containing a NULL value. This includes cells masked by a raster MASK. 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. r.out.xyz can combine several input raster maps, which can be convenient when it comes to e.g. produce ASCII point cloud files. r.out.xyz is simply a front-end to "r.stats -1gn".

EXAMPLES¶

In this example, a LiDAR elevation map in the North Carolina sample dataset location is exported to CSV format. g.region rast=elev_lid792_1m -p r.out.xyz input=elev_lid792_1m output=elev_lid792_1m.csv fs="," 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 rast=elev_lid792_1m res=1 -a -p # R=1, G=2, B=3 r.out.xyz input=elev_lid792_1m,ortho2010_t792.1,ortho2010_t792.2,ortho2010_t792.3 \
fs=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

TODO¶

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

SEE ALSO¶

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

AUTHOR¶

M. Hamish Bowman Dept. Marine Science Otago University, New Zealand Last changed: $Date: 2013-12-03 22:26:15 +0100 (Tue, 03 Dec 2013) $ Full index © 2003-2014 GRASS Development Team