Преглед изворни кода

r.out.gdal manual: added COG example (#1554)

* r.out.gdal manual: added COG example
* add links to GTiFF and COG man pages
Markus Neteler пре 4 година
родитељ
комит
d2b16fe332
1 измењених фајлова са 29 додато и 13 уклоњено
  1. 29 13
      raster/r.out.gdal/r.out.gdal.html

+ 29 - 13
raster/r.out.gdal/r.out.gdal.html

@@ -139,7 +139,7 @@ This issue only arises when writing out multi-band imagery groups.
 <p>Classic TIFF format supports only files with up to 4GB. Files that 
 <p>Classic TIFF format supports only files with up to 4GB. Files that 
 exceed this limit (in compressed or uncompressed form) need to be 
 exceed this limit (in compressed or uncompressed form) need to be 
 exported with <em>createopt="BIGTIFF=YES"</em>. BIGTIFF is available if 
 exported with <em>createopt="BIGTIFF=YES"</em>. BIGTIFF is available if 
-GDAL is built with libtiff >= 4.0.
+GDAL is built with libtiff &amp;= 4.0.
 
 
 <h3>Improving GeoTIFF compatibility</h3>
 <h3>Improving GeoTIFF compatibility</h3>
 
 
@@ -173,20 +173,32 @@ a method to reset the color table and assign a new color table
 tags will be written and a World file is required (<em>createopt="TFW=YES"</em>).
 tags will be written and a World file is required (<em>createopt="TFW=YES"</em>).
 </ul>
 </ul>
 
 
+<!-- outdated?
 <p>
 <p>
 Cloud Optimized GeoTIFFs (COG) can be created with the creation options 
 Cloud Optimized GeoTIFFs (COG) can be created with the creation options 
 <em>createopt=TILED=YES,COMPRESS=DEFLATE</em>, followed by 
 <em>createopt=TILED=YES,COMPRESS=DEFLATE</em>, followed by 
 <em>gdaladdo</em> to build overviews.
 <em>gdaladdo</em> to build overviews.
+-->
 
 
 <h2>EXAMPLES</h2>
 <h2>EXAMPLES</h2>
 
 
 <h3>Export the integer raster basin_50K map to GeoTIFF format</h3>
 <h3>Export the integer raster basin_50K map to GeoTIFF format</h3>
 
 
+See also <a href="https://gdal.org/drivers/raster/gtiff.html">GeoTIFF format description</a> (GDAL):
+
 <div class="code"><pre>
 <div class="code"><pre>
 g.region raster=basin_50K -p
 g.region raster=basin_50K -p
 r.out.gdal input=basin_50K output=basin_50K.tif
 r.out.gdal input=basin_50K output=basin_50K.tif
 </pre></div>
 </pre></div>
 
 
+<h3>Export the integer raster landclass96 map to Cloud Optimized GeoTIFF format</h3>
+
+See also <a href="https://gdal.org/drivers/raster/cog.html">Cloud Optimized GeoTIFF (COG) format description</a> (GDAL):
+
+<div class="code"><pre>
+g.region -p raster=landclass96
+r.out.gdal -fmt input=landclass96 output=landclass96.tif format=COG overviews=4
+</pre></div>
 
 
 <h3>Export a DCELL raster map in GeoTIFF format suitable for ESRI software</h3>
 <h3>Export a DCELL raster map in GeoTIFF format suitable for ESRI software</h3>
 
 
@@ -230,14 +242,6 @@ r.out.gdal in=nc_landsat_rgb output=nc_landsat_rgb.tif type=Byte \
 </pre></div>
 </pre></div>
 
 
 
 
-<h3>Export the floating point raster elevation map to ERDAS/IMG format</h3>
-
-<div class="code"><pre>
-g.region raster=elevation -p
-r.out.gdal input=elevation output=elelevation.img format=HFA type=Float32
-</pre></div>
-
-
 <h3>Export group of image maps as multi-band file</h3>
 <h3>Export group of image maps as multi-band file</h3>
 <div class="code"><pre>
 <div class="code"><pre>
 g.list group
 g.list group
@@ -304,6 +308,17 @@ gdalinfo $OUTNAME
 
 
 The resulting GeoTIFF file can be used e.g. for Web server applications.
 The resulting GeoTIFF file can be used e.g. for Web server applications.
 
 
+
+<h3>Export the floating point raster elevation map to ERDAS/IMG format</h3>
+
+See also <a href="https://gdal.org/drivers/raster/hfa.html">Erdas Imagine .img format description</a> (GDAL):
+
+<div class="code"><pre>
+g.region raster=elevation -p
+r.out.gdal input=elevation output=elelevation.img format=HFA type=Float32
+</pre></div>
+
+
 <h2>GDAL RELATED ERROR MESSAGES</h2>
 <h2>GDAL RELATED ERROR MESSAGES</h2>
 
 
 <ul>
 <ul>
@@ -324,9 +339,10 @@ The resulting GeoTIFF file can be used e.g. for Web server applications.
 
 
 <h2>SEE ALSO</h2>
 <h2>SEE ALSO</h2>
 
 
-The <a href="http://www.gdal.org/formats_list.html">GDAL supported formats</a>
-page.
-<br>
+<a href="https://gdal.org/drivers/raster/index.html">GDAL supported raster formats</a> and
+<a href="https://gdal.org/drivers/vector/index.html">GDAL supported vector formats</a>
+
+<p>
 <em>
 <em>
 <a href="r.out.ascii.html">r.out.ascii</a>,
 <a href="r.out.ascii.html">r.out.ascii</a>,
 <a href="r.out.bin.html">r.out.bin</a>,
 <a href="r.out.bin.html">r.out.bin</a>,
@@ -338,7 +354,7 @@ page.
 
 
 <h2>REFERENCES</h2>
 <h2>REFERENCES</h2>
 
 
-GDAL Pages: <a href="http://www.gdal.org">http://www.gdal.org</a>
+GDAL Pages: <a href="http://gdal.org">https://gdal.org</a>
 
 
 
 
 <h2>AUTHORS</h2>
 <h2>AUTHORS</h2>