r.out.gdal(1)

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

NAME

6       r.out.gdal   - Exports GRASS raster data into various formats (requires
7       GDAL)
8

KEYWORDS

10       raster, export
11

SYNOPSIS

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

DESCRIPTION

46       r.out.gdal  outputs  GRASS raster maps into various GIS formats as sup‐
47       ported by GDAL. This script is based on 'gdal_translate', it's  parame‐
48       ters are similar to those of ’gdal_translate'.  It requires the instal‐
49       lation of either GDAL with GRASS support or of the GDAL-OGR-GRASS plug‐
50       in which is available from the GDAL web site.
51
52       For  possible  metaopt  parameters see the 'supported formats' pages of
53       GDAL.  The  createopt  may  be  used  to  create  TFW  or  World  files
54       ("TFW=YES", "WORLDFILE=ON").
55

SUPPORTED FORMATS

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

NOTES

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

EXAMPLE

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

REFERENCES

110       GDAL library
111
112       Compile and install GRASS and QGIS with GDAL/OGR Plugin
113

AUTHOR

118       Markus Neteler, ITC-irst, Italy
119
120       Last changed: $Date: 2006/08/14 15:32:17 $
121
122       Full index
123
124
125
126GRASS 6.2.2                                                      r.out.gdal(1)