~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to scripts/r.out.gdal/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
 
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>
6
 
 
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>.
14
 
<p>
15
 
For possible <em>metaopt</em> parameters see the 'supported formats' pages
16
 
of GDAL.
17
 
The <em>createopt</em> may be used to create TFW or World files ("TFW=YES",
18
 
"WORLDFILE=ON").
19
 
 
20
 
<h2>SUPPORTED FORMATS</h2>
21
 
 
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>
25
 
 
26
 
<pre>
27
 
  AAIGrid: Arc/Info ASCII Grid
28
 
  BMP: MS Windows Device Independent Bitmap
29
 
  BSB: Maptech BSB Nautical Charts
30
 
  DTED: DTED Elevation Raster
31
 
  ELAS: ELAS
32
 
  ENVI: ENVI .hdr Labelled
33
 
  FIT: FIT Image
34
 
  GIF: Graphics Interchange Format (.gif)
35
 
  GTiff: GeoTIFF
36
 
  HDF4Image: HDF4 Dataset
37
 
  HFA: Erdas Imagine Images (.img)
38
 
  JPEG2000: JPEG-2000 part 1 (ISO/IEC 15444-1)
39
 
  JPEG: JPEG JFIF
40
 
  MEM: In Memory Raster
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)
48
 
  VRT: Virtual Raster
49
 
  XPM: X11 PixMap Format
50
 
</pre>
51
 
 
52
 
<h2>NOTES</h2>
53
 
 
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>).
58
 
<p>
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>
71
 
for details.
72
 
 
73
 
<h2>EXAMPLE</h2>
74
 
 
75
 
Export of the map 'elevation.dem' from the Spearfish data set:
76
 
 
77
 
<div class="code"><pre>
78
 
r.out.gdal.sh elevation.dem format=GTiff type=Int16 output=elev_dem.tif
79
 
</pre></div>
80
 
 
81
 
<h2>REFERENCES</h2>
82
 
 
83
 
<a href="http://www.gdal.org/">GDAL library</a>
84
 
<p>
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>
86
 
 
87
 
<h2>SEE ALSO</h2>
88
 
 
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>
92
 
 
93
 
<h2>AUTHOR</h2>
94
 
 
95
 
Markus Neteler, ITC-irst, Italy
96
 
<p><i>Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $</i>