Changes between Version 125 and Version 126 of WKTRaster/SpecificationWorking03

Timestamp:

Jun 24, 2011, 10:00:23 AM (13 years ago)

Author:

Bborie Park

Comment:

added the various versions of ST_Transform

WKTRaster/SpecificationWorking03

@@ -2590 +2590 @@
 
 '''ST_Transform(raster|geometry, SRID) -> same type as input'''
+
+ST_Transform enables the end-user to reproject a raster to a new projection.  Unlike the ST_Transform function for geometries, ST_Transform for rasters depends upon the specificiation of a resampling algorithm and an error tolerance.  In addition, reprojecting a raster will probably change the scale of the pixels.  Therefore, ST_Transform for rasters can be more involved than the ST_Transform for geometries.
+
+1. ST_Transform(rast raster, srid integer, algorithm text DEFAULT '!NearestNeighbour', maxerr double precision DEFAULT 0.125, scalex double precision DEFAULT 0, scaley double precision DEFAULT 0)
+
+  returns a new raster in the projection specified by "srid"
+
+  srid: the SRID of the projection to use when reprojecting the raster
+
+  algorithm: the resampling algorithm to use when reprojecting the raster.  default is '!NearestNeighbour'.  possible algorithms are:
+
+{{{
+NearestNeighbour (default.  fastest performance but worst interpolation)
+
+NearestNeighbor (for those wanting to use the American spelling)
+
+Bilinear
+
+Cubic
+
+CubicSpline
+
+Lanczos
+}}}
+
+  maxerr: the threshold for transformation approximation by the resampling algorithm (in pixel units).  default is 0.125, which is the same value used in GDAL gdalwarp utility.  if set to zero, no approximation takes place.
+
+  scalex: the reprojected raster's scale in the X axis.  default is 0 indicating that the user isn't specifying the reprojected raster's scale
+
+  scaley: the reprojected raster's scale in the Y axis.  default is 0 indicating that the user isn't specifying the reprojected raster's scale
+
+{{{
+ST_Transform(rast, 3310)
+
+ST_Transform(rast, 3310, 'Bilinear')
+
+ST_Transform(rast, 3310, 'Lanczos', 0)
+
+ST_Transform(rast, 3310, 'Lanczos', 0.5)
+
+ST_Transform(rast, 3310, 'Lanczos', 0.125, 1000)
+
+ST_Transform(rast, 3310, 'Lanczos', 0.125, 1000, 1000)
+}}}
+
+2. ST_Transform(rast raster, srid integer, scalex double precision, scaley double precision, algorithm text DEFAULT '!NearestNeighbour', maxerr double precision DEFAULT 0.125)
+
+{{{
+ST_Transform(rast, 4326, 500, 500)
+
+ST_Transform(rast, 4326, 500, 500, 'Cubic')
+
+ST_Transform(rast, 4326, 500, 500, 'CubicSpline', 0)
+}}}
+
+3. ST_Transform(rast raster, srid integer, scalexy double precision, algorithm text DEFAULT '!NearestNeighbour', maxerr double precision DEFAULT 0.125)
+
+  scalexy: the reprojected raster's scale in the X and Y axes.  default is 0 indicating that the user isn't specifying the reprojected raster's scale
+
+{{{
+ST_Transform(rast, 4326, 250)
+
+ST_Transform(rast, 4326, 250, 'Cubic')
+
+ST_Transform(rast, 4326, 100, 'CubicSpline', 0)
+}}}
+
 ----
 == '''Objective FV.06 - Being able to do some base raster operations. - ''Done Partially''''' ==