NAME

       r.out.ascii  - Converts a raster map layer into an ASCII text file.

KEYWORDS

       raster, export

SYNOPSIS

       r.out.ascii
       r.out.ascii help
       r.out.ascii   [-hsmi]   input=string    [output=string]    [dp=integer]    [width=integer]
       [null=string]   [--verbose]  [--quiet]

   Flags:
       -h
           Suppress printing of header information

       -s
           Write SURFER (Golden Software) ASCII grid

       -m
           Write MODFLOW (USGS) ASCII array

       -i
           Force output of integer values

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=string
           Name of an existing raster map

       output=string
           Name for output ASCII grid map (use out=- for stdout)

       dp=integer
           Number of significant digits (floating point only)

       width=integer
           Number of values printed before wrapping a line (only SURFER or MODFLOW format)

       null=string
           String to represent null cell (GRASS grid only)
           Default: *

DESCRIPTION

       r.out.ascii converts a user-specified raster map layer (input=name) into an ASCII grid  in
       a text file (output=name) suitable for export to other computer systems.

       The  GRASS  program  r.in.ascii can be used to perform the reverse function, converting an
       ASCII file in suitable format to GRASS raster map format.

       To write a SURFER .grd ASCII GRID file (with reverted row order and different header)  use
       the -s flag:
       r.out.ascii -s input=inname output=outname.grd [dp=value]
         NULL  data  are  coded to "1.70141e+038" for SURFER ASCII GRID files (ignoring the null=
       parameter).

NOTES

       The output from r.out.ascii may be placed into  a  file  by  using  the  UNIX  redirection
       mechanism; e.g.:
       r.out.ascii input=soils output=- > out.file
         The  output  file out.file can then be printed or copied onto a CDROM or floppy disk for
       export purposes.

       To export the raster values as x,y,z values  of  cell  centers  (one  per  line)  use  the
       r.out.xyz module.

SEE ALSO

        r.in.ascii, r.in.arc, r.out.bin, r.out.gdal, r.out.xyz

AUTHOR

       Michael Shapiro, U.S. Army Construction Engineering Research Laboratory

       Surfer support by Markus Neteler

       Last changed: $Date: 2008-05-16 12:09:06 -0700 (Fri, 16 May 2008) $

       Full index

       © 2003-2013 GRASS Development Team