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