NAME

       r.out.gdal.sh  - Exports GRASS raster into GDAL supported formats.

KEYWORDS

       raster, export

SYNOPSIS

       r.out.gdal.sh
       r.out.gdal.sh help
       r.out.gdal.sh     [-lr]      [input=string]       [format=string]      [type=string]      [output=string]
       [createopt=string[,string,...]]   [metaopt=string[,string,...]]   [--verbose]  [--quiet]

   Flags:
       -l
           List supported output formats

       -r
           Region sensitive output

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=string
           Name of input raster map

       format=string
           GIS format to write (case sensitive, see also -l flag)
           Options: AAIGrid,BMP,BSB,DTED,ELAS,ENVI,FIT,GIF,GTiff,HFA,JPEG,MEM,MFF,MFF2,NITF,PAux,PNG,PNM,VRT,XPM
           Default: GTiff

       type=string
           File type
           Options: Byte,Int16,UInt16,UInt32,Int32,Float32,Float64,CInt16,CInt32,CFloat32,CFloat64

       output=string
           Name for output file

       createopt=string[,string,...]
           Creation option to the output format driver. Multiple options may be listed

       metaopt=string[,string,...]
           Metadata key passed on the output dataset if possible

DESCRIPTION

       WARNING: This module is superseded and will be removed in future versions of GRASS.  Use the much  faster
       r.out.gdal  instead.   r.out.gdal.sh  outputs  GRASS raster maps into various GIS formats as supported by
       GDAL. This script is based on 'gdal_translate', it's parameters are similar to those of ’gdal_translate'.
       It requires the installation of either GDAL with GRASS support or of the GDAL-OGR-GRASS plugin  which  is
       available from the GDAL web site.

       For  possible metaopt parameters see the 'supported formats' pages of GDAL.  The createopt may be used to
       create TFW or World files ("TFW=YES", "WORLDFILE=ON").

SUPPORTED FORMATS

       The set of supported formats written by r.out.gdal.sh depend on the local  GDAL  installation.  Available
       may be (incomplete list):

         AAIGrid: Arc/Info ASCII Grid
         BMP: MS Windows Device Independent Bitmap
         BSB: Maptech BSB Nautical Charts
         DTED: DTED Elevation Raster
         ELAS: ELAS
         ENVI: ENVI .hdr Labelled
         FIT: FIT Image
         GIF: Graphics Interchange Format (.gif)
         GTiff: GeoTIFF
         HDF4Image: HDF4 Dataset
         HFA: Erdas Imagine Images (.img)
         JPEG2000: JPEG-2000 part 1 (ISO/IEC 15444-1)
         JPEG: JPEG JFIF
         MEM: In Memory Raster
         MFF2: Atlantis MFF2 (HKV) Raster
         MFF: Atlantis MFF Raster
         NITF: National Imagery Transmission Format
         PAux: PCI .aux Labelled
         PCIDSK: PCIDSK Database File
         PNG: Portable Network Graphics
         PNM: Portable Pixmap Format (netpbm)
         VRT: Virtual Raster
         XPM: X11 PixMap Format

NOTES

       When  writing  out GeoTIFF format for users of ESRI software or ImageMagick, the band interleaving should
       be switched to pixel  interleaving  using  createopt="INTERLEAVE=PIXEL".  Multiple  options  have  to  be
       specified as comma separated list (createopt=TFW=YES,COMPRESS=DEFLATE).

       Out  of  the  GDAL data types, the closest match for GRASS CELL, FCELL and DCELL rasters are respectively
       Int32, Float32 and Float64. These are not exact equivalents, but they will preserve the max possible data
       range and number of decimal places for each respective GRASS raster data type. Please keep in mind,  that
       not  all  CELL rasters will require Int32 - e.g., 0-255 CELL raster are covered by the Byte type as well.
       Moreover, some GDAL-supported formats do not support all the data types possible in GDAL and  GRASS.  Use
       r.info  to  check  the  data type and range for your GRASS raster, refer to specific format documentation
       (GDAL website, format vendor's docs) and e.g. the  Wikipedia  article  Typical  boundaries  of  primitive
       integral types for details.

EXAMPLE

       Export of the map 'elevation.dem' from the Spearfish data set:
       r.out.gdal.sh elevation.dem format=GTiff type=Int16 output=elev_dem.tif

REFERENCES

       GDAL library

       Compile and install GRASS and QGIS with GDAL/OGR Plugin

SEE ALSO

       r.out.arc, r.out.ascii, r.out.tiff

AUTHOR

       Markus Neteler, ITC-irst, Italy

       Last changed: $Date: 2011-11-08 01:42:51 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                r.out.gdal.sh(1grass)