Difference between revisions of "Raster Format Conversion Using gdal translate"

From Tuflow
Jump to navigation Jump to search
Line 16: Line 16:
 
<Br>
 
<Br>
 
'''Using DEFLATE Compression on Output GeoTIFF'''
 
'''Using DEFLATE Compression on Output GeoTIFF'''
−
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used -'''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
+
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used - '''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
 
:** ''<tt>COMPRESS=<method></tt>: "NONE", "DEFLATE", "LZW", and "PACKBITS" are currently supported by TUFLOW
 
:** ''<tt>COMPRESS=<method></tt>: "NONE", "DEFLATE", "LZW", and "PACKBITS" are currently supported by TUFLOW
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 
'''Specifying the Compression Level for the DEFLATE Compression Method'''<br>
 
'''Specifying the Compression Level for the DEFLATE Compression Method'''<br>
−
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used -'''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
+
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used - '''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
 
:** ''<tt>ZLEVEL=[1-9]</tt>
 
:** ''<tt>ZLEVEL=[1-9]</tt>
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 
'''Adding a Horizontal Predictor to the Compression'''<br>
 
'''Adding a Horizontal Predictor to the Compression'''<br>
−
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used -'''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
+
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used - '''<u>[https://gdal.org/drivers/raster/gtiff.html More Details]</u>'''
 
:** ''<tt>PREDICTOR=[1/2/3]</tt>'': 1 (No Predictor) and 2 (Horizontal Predictor) currently supported by TUFLOW
 
:** ''<tt>PREDICTOR=[1/2/3]</tt>'': 1 (No Predictor) and 2 (Horizontal Predictor) currently supported by TUFLOW
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 -co PREDICTOR=2 DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 
<pre>gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 -co PREDICTOR=2 DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 +
 +
==Assigning a Projection==
 +
<br>
 +
'''ASC to GeoTIFF'''<Br>
 +
:* ''<t>-a_srs <srs_def></tt>'': Override the projection of the output file (no transformations performed). Srs_def can be an EPSG or WKT CRS definition.
 +
<pre>gdal_translate.exe -of GTiff -a_srs "EPSG:32760" DEM_M01_5m.asc DEM_M01_5m.tif</pre>
 +
 +
==Converting to/from GPKG==
 +
<br>
 +
'''Convert to a new GPKG Database Where Layer Name is Different Than Database Name'''<Br>
 +
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used - '''<u>[https://gdal.org/drivers/raster/gpkg.html More Details]</u>'''
 +
:** ''<tt>RASTER_TABLE=<name></tt>'': The name of the output layer within database
 +
<pre>gdal_translate.exe -of GPKG -co RASTER_TABLE=DEM_M01_5m DEM_M01_5m.asc DEM_database.gpkg</pre>
 +
'''Convert to an existing GPKG Database Where Layer Name is Different Than Database Name'''<Br>
 +
:* ''<tt>-co</tt>'': (Creation Option) - output format specific option. Flag must be used for each creation option used - '''<u>[https://gdal.org/drivers/raster/gpkg.html More Details]</u>'''
 +
:** ''<tt>APPEND_SUBDATASET=[YES/NO]</tt>'': If "YES" the existing GPKG will not be priorly destroyed.
 +
<pre>gdal_translate.exe -of GPKG -co RASTER_TABLE=DEM_M01_5m -co APPEND_SUBDATASET=YES DEM_M01_5m.asc DEM_database.gpkg</pre>
 +
'''GPKG to GeoTIFF Where the Layer Name is Different Than the Database Name'''<Br>
 +
:* ''<tt>-oo</tt>'': (Opening Option) - input format specific option. Flag must be used for each opening option used - '''<u>[https://gdal.org/drivers/raster/gpkg.html More Details]</u>'''
 +
:** ''<tt>TABLE=<name></tt>'': Name of the layer within GPKG to be converted.
 +
<pre>gdal_translate.exe -of GTiff -oo TABLE=DEM_M01_5m DEM_database.gpkg DEM_M01_5m.tif</pre>

Revision as of 23:11, 11 April 2022

This page lists useful batch file examples for using gdal_translate.exe. For complete documentation on this tool please visit gdal.org/programs/gdal_translate

Basic Format Conversion

Format conversion can be done using "-of <format_name>" then specifying the "<source_dataset> <destination_dataset>".

ASC to GeoTIFF

gdal_translate.exe -of GTiff DEM_M01_5m.asc DEM_M01_5m.tif

ASC to GPKG

gdal_translate.exe -of GPKG DEM_M01_5m.asc DEM_M01_5m.gpkg

GeoTIFF to ASC

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used. - More Details
    • SIGNIFICANT_DIGITS=<n>: limits the precision of the output
gdal_translate.exe -of AAIGrid -co SIGNIFICANT_DIGITS=8 DEM_M01_5m.tif DEM_M01_5m.asc

Adding Compression to GeoTIFF


Using DEFLATE Compression on Output GeoTIFF

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used - More Details
    • COMPRESS=<method>: "NONE", "DEFLATE", "LZW", and "PACKBITS" are currently supported by TUFLOW
gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE DEM_M01_5m.asc DEM_M01_5m.tif

Specifying the Compression Level for the DEFLATE Compression Method

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used - More Details
    • ZLEVEL=[1-9]
gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 DEM_M01_5m.asc DEM_M01_5m.tif

Adding a Horizontal Predictor to the Compression

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used - More Details
    • PREDICTOR=[1/2/3]: 1 (No Predictor) and 2 (Horizontal Predictor) currently supported by TUFLOW
gdal_translate.exe -of GTiff -co COMPRESS=DEFLATE -co ZLEVEL=9 -co PREDICTOR=2 DEM_M01_5m.asc DEM_M01_5m.tif

Assigning a Projection


ASC to GeoTIFF

  • <t>-a_srs <srs_def>: Override the projection of the output file (no transformations performed). Srs_def can be an EPSG or WKT CRS definition.
gdal_translate.exe -of GTiff -a_srs "EPSG:32760" DEM_M01_5m.asc DEM_M01_5m.tif

Converting to/from GPKG


Convert to a new GPKG Database Where Layer Name is Different Than Database Name

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used - More Details
    • RASTER_TABLE=<name>: The name of the output layer within database
gdal_translate.exe -of GPKG -co RASTER_TABLE=DEM_M01_5m DEM_M01_5m.asc DEM_database.gpkg

Convert to an existing GPKG Database Where Layer Name is Different Than Database Name

  • -co: (Creation Option) - output format specific option. Flag must be used for each creation option used - More Details
    • APPEND_SUBDATASET=[YES/NO]: If "YES" the existing GPKG will not be priorly destroyed.
gdal_translate.exe -of GPKG -co RASTER_TABLE=DEM_M01_5m -co APPEND_SUBDATASET=YES DEM_M01_5m.asc DEM_database.gpkg

GPKG to GeoTIFF Where the Layer Name is Different Than the Database Name

  • -oo: (Opening Option) - input format specific option. Flag must be used for each opening option used - More Details
    • TABLE=<name>: Name of the layer within GPKG to be converted.
gdal_translate.exe -of GTiff -oo TABLE=DEM_M01_5m DEM_database.gpkg DEM_M01_5m.tif
Retrieved from "https://wiki.tuflow.com/w/index.php?title=Raster_Format_Conversion_Using_gdal_translate&oldid=26567"