Changes between Version 59 and Version 60 of WKTRaster/SpecificationWorking03

Timestamp:

Apr 10, 2011, 10:14:04 AM (13 years ago)

Author:

Bborie Park

Comment:

ST_TIFF functions

WKTRaster/SpecificationWorking03

@@ -186 +186 @@
 
 compression=[JPEG/LZW/PACKBITS/DEFLATE/CCITTRLE/CCITTFAX3/CCITTFAX4/NONE]: Set the type of compression to use. None is the default. The CCITT compression should only be used with 1bit (NBITS=1) data. JPEG should only be used with Byte data. When using JPEG add a number specifying the quality. 75 is the default. e.g. ST_AsTIFF(raster, "JPEG60") (copied from http://www.gdal.org/frmt_gtiff.html)
+
+Bborie: A proposed implementation of the ST_AsTIFF functions.
+
+The TIFF format is probably the most robust available for converting rasters to GDAL rasters. Not only does it support all PostGIS Raster pixel types, it also provides plenty of creation options and possibly no issues with the number of bands. The only limitation found is that there can only be one NODATA value for all bands.
+
+The next three functions are the most basic of the ST_AsTIFF functions.
+
+1. ST_AsTIFF(rast raster, options text[], srs text) -> bytea
+
+    The most generic version of this function. All other ST_AsTIFF functions call this function.
+
+    This function will check that all bands of the raster to be converted has the same NODATA value. If there are more than one possible NODATA values, a WARNING will be raised and the output TIFF will use the NODATA value of the last band with a NODATA value.
+
+        options: the GDAL creation options found in the Creation Options section of the GDAL TIFF driver
+
+        srs: the user-specified OGC WKT or the proj4 text for a spatial reference to embed in the GDAL raster. TIFF is one of the formats that supports embedding the spatial reference within the image file.
+
+{{{
+ST_AsTIFF(rast, ARRAY['COMPRESS=DEFLATE', 'ZLEVEL=9'], '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+
+ST_AsTIFF(rast, ARRAY['COMPRESS=DEFLATE', 'ZLEVEL=9'], 'PROJCS["NAD83 / California Albers",GEOGCS["NAD83",DATUM["North_American_Datum_1983",SPHEROID["GRS 1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],AUTHORITY["EPSG","6269"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.01745329251994328,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4269"]],UNIT["metre",1,AUTHORITY["EPSG","9001"]],PROJECTION["Albers_Conic_Equal_Area"],PARAMETER["standard_parallel_1",34],PARAMETER["standard_parallel_2",40.5],PARAMETER["latitude_of_center",0],PARAMETER["longitude_of_center",-120],PARAMETER["false_easting",0],PARAMETER["false_northing",-4000000],AUTHORITY["EPSG","3310"],AXIS["X",EAST],AXIS["Y",NORTH]]')
+}}}
+
+2. ST_AsTIFF(rast raster, options text[]) -> bytea
+
+This one removes the user-specified srs argument. The output TIFF's spatial reference will be set to the same as the input raster, if possible.
+
+{{{
+ST_AsTIFF(rast, ARRAY['COMPRESS=DEFLATE', 'ZLEVEL=9'])
+}}}
+
+3. ST_AsTIFF(rast raster) -> bytea
+
+The simplest implementation of this function. Since the options argument has been removed, the output TIFF will be created with default options. Like the prior function, the spatial reference of the TIFF will be set to the same as the input raster.
+
+{{{
+ST_AsTIFF(rast)
+}}}
+
+
+The next three functions add a band index argument to filter the raster's bands before generating the output TIFF.
+
+4. ST_AsTIFF(rast raster, nbands int[], options text[], srs text) -> bytea
+
+{{{
+ST_AsTIFF(rast, ARRAY[3,1,2], ARRAY['COMPRESS=DEFLATE', 'ZLEVEL=9'], '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+}}}
+
+5. ST_AsTIFF(rast raster, nbands int[], options text[]) -> bytea
+
+This one removes the user-specified srs argument. The output TIFF's spatial reference will be set to the same as the input raster, if possible.
+
+{{{
+ST_AsTIFF(rast, ARRAY[3,1,2], ARRAY['COMPRESS=DEFLATE', 'ZLEVEL=9'])
+}}}
+
+6. ST_AsTIFF(rast raster, nbands int[]) -> bytea
+
+Since the options argument has been removed, the output TIFF will be created with default options. Like the prior function, the spatial reference of the TIFF will be set to the same as the input raster.
+
+{{{
+ST_AsTIFF(rast, ARRAY[3,1,2])
+}}}
+
+
+The next two functions add a compression argument. If the compression desired is JPEG or DEFLATE, the user can specify a quality as part of the compression string.
+
+Examples are:
+
+{{{
+JPEG90
+
+JPEG
+
+DEFLATE8
+
+DEFLATE
+}}}
+
+7. ST_AsTIFF(rast raster, compression text, srs text) -> bytea
+
+This function will parse the compression string for the compression type and the compression quality. It will also inspect to make sure that the pixel types of the raster's bands are appropriate for the compression type. This is primarily for JPEG and CCITT compression types, which only support 8BUI and 1BB respectively.
+
+{{{
+ST_AsTIFF(rast, 'JPEG90', '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+
+ST_AsTIFF(rast, 'JPEG', '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+
+ST_AsTIFF(rast, 'LZMA', '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+}}}
+
+8. ST_AsTIFF(rast raster, compression text) -> bytea
+
+The output TIFF will be created with default options. Like the prior function, the spatial reference of the TIFF will be set to the same as the input raster.
+
+{{{
+ST_AsTIFF(rast, 'LZMA')
+}}}
+
+
+The next two functions include band index and compression arguments
+
+9. ST_AsTIFF(rast raster, nbands int[], compression text, srs text) -> bytea
+
+{{{
+ST_AsTIFF(rast, ARRAY[2], 'JPEG90', ARRAY['BIGTIFF=IF_NEEDED'], '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+
+ST_AsTIFF(rast, ARRAY[1,3], 'JPEG', ARRAY['BIGTIFF=IF_NEEDED'], '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+
+ST_AsTIFF(rast, ARRAY[3,1,2], 'LZMA', ARRAY['BIGTIFF=IF_NEEDED'], '+proj=aea +lat_1=34 +lat_2=40.5 +lat_0=0 +lon_0=-120 +x_0=0 +y_0=-4000000 +ellps=GRS80 +datum=NAD83 +units=m +no_defs')
+}}}
+
+10. ST_AsTIFF(rast raster, nbands int[], compression text) -> bytea
+
+{{{
+ST_AsTIFF(rast, ARRAY[3,2], 'DEFLATE9')
+}}}
+
+The output TIFF will be created with default options. The spatial reference of the TIFF will be set to the same as the input raster. 
 
 ----