4
WARNING: <b>This module is superseded and will be removed in future versions of GRASS.
5
Use the much faster <em><a href="r.out.gdal.html">r.out.gdal</a></em> instead.</b>
7
<em>r.out.gdal.sh</em> outputs GRASS raster maps into various GIS formats
8
as supported by GDAL. This script is based on 'gdal_translate',
9
it's parameters are similar to those of
10
'<a href="http://www.gdal.org/gdal_utilities.html">gdal_translate</a>'.
11
It requires the installation of either GDAL with GRASS support or
12
of the GDAL-OGR-GRASS plugin which is available from the
13
<a href="http://www.gdal.org">GDAL web site</a>.
15
For possible <em>metaopt</em> parameters see the 'supported formats' pages
17
The <em>createopt</em> may be used to create TFW or World files ("TFW=YES",
20
<h2>SUPPORTED FORMATS</h2>
22
The set of <a href="http://www.gdal.org/formats_list.html">supported
23
formats</a> written by <em>r.out.gdal.sh</em> depend on the
24
local GDAL installation. Available may be (incomplete list):<p>
27
AAIGrid: Arc/Info ASCII Grid
28
BMP: MS Windows Device Independent Bitmap
29
BSB: Maptech BSB Nautical Charts
30
DTED: DTED Elevation Raster
32
ENVI: ENVI .hdr Labelled
34
GIF: Graphics Interchange Format (.gif)
36
HDF4Image: HDF4 Dataset
37
HFA: Erdas Imagine Images (.img)
38
JPEG2000: JPEG-2000 part 1 (ISO/IEC 15444-1)
41
MFF2: Atlantis MFF2 (HKV) Raster
42
MFF: Atlantis MFF Raster
43
NITF: National Imagery Transmission Format
44
PAux: PCI .aux Labelled
45
PCIDSK: PCIDSK Database File
46
PNG: Portable Network Graphics
47
PNM: Portable Pixmap Format (netpbm)
49
XPM: X11 PixMap Format
54
When writing out GeoTIFF format for users of ESRI software or ImageMagick,
55
the band interleaving should be switched to pixel interleaving using
56
<em>createopt="INTERLEAVE=PIXEL"</em>. Multiple options have to be
57
specified as comma separated list (<em>createopt=TFW=YES,COMPRESS=DEFLATE</em>).
59
Out of the GDAL data types, the closest match for GRASS CELL, FCELL and DCELL
60
rasters are respectively Int32, Float32 and Float64. These are not exact
61
equivalents, but they will preserve the max possible data range and number of
62
decimal places for each respective GRASS raster data type. Please keep in mind, that
63
not all CELL rasters will require Int32 - e.g., 0-255 CELL raster are covered
64
by the Byte <em>type</em> as well. Moreover, some GDAL-supported formats do not
65
support all the data types possible in GDAL and GRASS. Use
66
<em><a href="r.info.html">r.info</a></em> to check the data type and range for your
67
GRASS raster, refer to specific format documentation
68
(<a href="http://www.gdal.org/">GDAL website</a>, format vendor's docs) and
69
e.g. the Wikipedia article
70
<em><a href="http://en.wikipedia.org/wiki/C_syntax#Typical_boundaries_of_primitive_integral_types">Typical boundaries of primitive integral types</a></em>
75
Export of the map 'elevation.dem' from the Spearfish data set:
77
<div class="code"><pre>
78
r.out.gdal.sh elevation.dem format=GTiff type=Int16 output=elev_dem.tif
83
<a href="http://www.gdal.org/">GDAL library</a>
85
<a href="http://grass.gdf-hannover.de/wiki/Compile_and_install_GRASS_and_QGIS_with_GDAL/OGR_Plugin">Compile and install GRASS and QGIS with GDAL/OGR Plugin</a>
89
<em><a href="r.out.arc.html">r.out.arc</a></em>,
90
<em><a href="r.out.ascii.html">r.out.ascii</a></em>,
91
<em><a href="r.out.tiff.html">r.out.tiff</a></em>
95
Markus Neteler, ITC-irst, Italy
96
<p><i>Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $</i>