[postgis-devel] [PostGIS] #1381: [raster] two-raster ST_Intersection

[PostGIS]

#1381: [raster] two-raster ST_Intersection
----------------------------+-----------------------------------------------
 Reporter:  dustymugs       |       Owner:  dustymugs    
     Type:  enhancement     |      Status:  assigned     
 Priority:  critical        |   Milestone:  PostGIS 2.0.0
Component:  postgis raster  |     Version:  trunk        
 Keywords:                  |  
----------------------------+-----------------------------------------------
Changes (by dustymugs):

  * status:  new => assigned


Comment:

 ST_Intersection will be a plpgsql function.

 A set of ST_Intersection functions for raster, raster.

 1. ST_Intersection(
         rast1 raster, nband1 int,[[BR]]
         rast2 raster, nband2 int,[[BR]]
         returnband text DEFAULT 'BOTH',[[BR]]
         otheruserfunc regprocedure DEFAULT NULL
 );

         returnband: can be FIRST, SECOND, BOTH, OTHER
                 FIRST returns the band of rast1 in the intersecting
 extent.  returning raster will have one band.[[BR]]
                 SECOND returns the band of rast2 in the intersecting
 extent.  returning raster will have one band.[[BR]]
                 BOTH returns the bands of rast1 and rast2 in the
 intersection extent.  returning raster will have two bands.[[BR]]
                 OTHER returns the computed band based upon rast1 and rast2
 in the intersecting extent.  returning raster will have one band.  If
 OTHER, must provide a regprocedure to otherfunc

         otherfunc: function to call when returnband = OTHER.  Function
 format must be identical to tworastuserfunc of 2-raster ST_MapAlgebraFct.

 2. ST_Intersection(
         rast1 raster, nband1 int,[[BR]]
         rast2 raster, nband2 int,[[BR]]
         otheruserfunc regprocedure
 );

 3. ST_Intersection(
         rast1 raster,[[BR]]
         rast2 raster,[[BR]]
         returnband text DEFAULT 'BOTH',[[BR]]
         otheruserfunc regprocedure DEFAULT NULL
 );

 4. ST_Intersection(
         rast1 raster,[[BR]]
         rast2 raster,[[BR]]
         returnband text
 );

 5. ST_Intersection(
         rast1 raster,[[BR]]
         rast2 raster,[[BR]]
         otheruserfunc regprocedure
 );

 A set of ST_Intersection functions for raster, geometry (converted to
 raster).

 1. ST_Intersection(
         rast raster, nband int,[[BR]]
         geom geometry,[[BR]]
         extent text DEFAULT 'INTERSECTION',[[BR]]
         otheruserfunc regprocedure DEFAULT NULL
 )

         extent: can be INTERSECTION, FIRST, SECOND, UNION

 2. ST_Intersection(
         rast raster, nband int,[[BR]]
         geom geometry,[[BR]]
         otheruserfunc regprocedure
 );

 3. ST_Intersection(
         rast raster,[[BR]]
         geom geometry,[[BR]]
         extent text DEFAULT 'INTERSECTON',[[BR]]
         otheruserfunc regprocedure DEFAULT NULL
 );

 4. ST_Intersection(
         rast raster,[[BR]]
         geom geometry,[[BR]]
         otheruserfunc regprocedure
 );

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/1381#comment:1>
PostGIS <http://trac.osgeo.org/postgis/>
The PostGIS Trac is used for bug, enhancement & task tracking, a user and developer wiki, and a view into the subversion code repository of PostGIS project.