r.out.gdal.sh(1)

1r.out.gdal.sh(1)              Grass User's Manual             r.out.gdal.sh(1)
2
3
4

NAME

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

KEYWORDS

9       raster, export
10

SYNOPSIS

12       r.out.gdal.sh
13       r.out.gdal.sh help
14       r.out.gdal.sh  [-lr]   [input=string]   [format=string]   [type=string]
15       [output=string]                         [createopt=string[,string,...]]
16       [metaopt=string[,string,...]]   [--verbose]  [--quiet]
17
18   Flags:
19       -l
20           List supported output formats
21
22       -r
23           Region sensitive output
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31   Parameters:
32       input=string
33           Name of input raster map
34
35       format=string
36           GIS format to write (case sensitive, see also -l flag)
37           Options:
38           AAIGrid,BMP,BSB,DTED,ELAS,ENVI,FIT,GIF,GTiff,HFA,JPEG,MEM,MFF,MFF2,NITF,PAux,PNG,PNM,VRT,XPM
39           Default: GTiff
40
41       type=string
42           File type
43           Options:
44           Byte,Int16,UInt16,UInt32,Int32,Float32,Float64,CInt16,CInt32,CFloat32,CFloat64
45
46       output=string
47           Name for output file
48
49       createopt=string[,string,...]
50           Creation  option  to the output format driver. Multiple options may
51           be listed
52
53       metaopt=string[,string,...]
54           Metadata key passed on the output dataset if possible
55

DESCRIPTION

57       WARNING: This module is superseded and will be removed in  future  ver‐
58       sions of GRASS.  Use the much faster r.out.gdal instead.  r.out.gdal.sh
59       outputs GRASS raster maps into various  GIS  formats  as  supported  by
60       GDAL.  This  script  is  based on 'gdal_translate', it's parameters are
61       similar to those of ’gdal_translate'.  It requires the installation  of
62       either GDAL with GRASS support or of the GDAL-OGR-GRASS plugin which is
63       available from the GDAL web site.
64
65       For possible metaopt parameters see the 'supported  formats'  pages  of
66       GDAL.   The  createopt  may  be  used  to  create  TFW  or  World files
67       ("TFW=YES", "WORLDFILE=ON").
68

SUPPORTED FORMATS

70       The set of supported formats written by  r.out.gdal.sh  depend  on  the
71       local GDAL installation. Available may be (incomplete list):
72
73
74         AAIGrid: Arc/Info ASCII Grid
75         BMP: MS Windows Device Independent Bitmap
76         BSB: Maptech BSB Nautical Charts
77         DTED: DTED Elevation Raster
78         ELAS: ELAS
79         ENVI: ENVI .hdr Labelled
80         FIT: FIT Image
81         GIF: Graphics Interchange Format (.gif)
82         GTiff: GeoTIFF
83         HDF4Image: HDF4 Dataset
84         HFA: Erdas Imagine Images (.img)
85         JPEG2000: JPEG-2000 part 1 (ISO/IEC 15444-1)
86         JPEG: JPEG JFIF
87         MEM: In Memory Raster
88         MFF2: Atlantis MFF2 (HKV) Raster
89         MFF: Atlantis MFF Raster
90         NITF: National Imagery Transmission Format
91         PAux: PCI .aux Labelled
92         PCIDSK: PCIDSK Database File
93         PNG: Portable Network Graphics
94         PNM: Portable Pixmap Format (netpbm)
95         VRT: Virtual Raster
96         XPM: X11 PixMap Format
97
98

NOTES

100       When writing out GeoTIFF format for users of ESRI software or ImageMag‐
101       ick, the band interleaving should be  switched  to  pixel  interleaving
102       using  createopt="INTERLEAVE=PIXEL". Multiple options have to be speci‐
103       fied as comma separated list (createopt=TFW=YES,COMPRESS=DEFLATE).
104
105       Out of the GDAL data types, the closest match for GRASS CELL, FCELL and
106       DCELL  rasters  are  respectively Int32, Float32 and Float64. These are
107       not exact equivalents, but they will preserve  the  max  possible  data
108       range  and  number  of  decimal places for each respective GRASS raster
109       data type. Please keep in mind, that not all CELL rasters will  require
110       Int32  -  e.g., 0-255 CELL raster are covered by the Byte type as well.
111       Moreover, some GDAL-supported formats do not support all the data types
112       possible in GDAL and GRASS. Use r.info to check the data type and range
113       for your GRASS raster, refer to  specific  format  documentation  (GDAL
114       website,  format  vendor's docs) and e.g. the Wikipedia article Typical
115       boundaries of primitive integral types for details.
116

EXAMPLE

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

REFERENCES

123       GDAL library
124
125       Compile and install GRASS and QGIS with GDAL/OGR Plugin
126

AUTHOR

131       Markus Neteler, ITC-irst, Italy
132
133       Last changed: $Date: 2006-12-13 17:35:44 +0100 (Wed, 13 Dec 2006) $
134
135       Full index
136
137       © 2003-2008 GRASS Development Team
138
139
140
141GRASS 6.3.0                                                   r.out.gdal.sh(1)