1r.out.gdal.sh(1) Grass User's Manual r.out.gdal.sh(1)
2
3
4
6 r.out.gdal.sh - Exports GRASS raster into GDAL supported formats.
7
9 raster, export
10
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
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
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
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
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
123 GDAL library
124
125 Compile and install GRASS and QGIS with GDAL/OGR Plugin
126
128 r.out.arc, r.out.ascii, r.out.tiff
129
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)