[postgis-devel] [PostGIS] #1752: [raster] ST_Neighborhood

[PostGIS]

#1752: [raster] ST_Neighborhood
-------------------------+--------------------------------------------------
 Reporter:  dustymugs    |       Owner:  dustymugs     
     Type:  enhancement  |      Status:  new           
 Priority:  medium       |   Milestone:  PostGIS Future
Component:  raster       |     Version:  trunk         
 Keywords:               |  
-------------------------+--------------------------------------------------
 Along with ST_NearestValue(), a related function is to get the all pixels
 within N pixel distance from a specific pixel (excluding the specific
 pixel).  The function returns a set of records (x, y, pixel value) that
 can used for additional processing...

 {{{
 ST_Neighborhood(
         rast raster, band integer,
         ix integer, iy integer,
         distance integer,
         exclude_nodata_value boolean DEFAULT TRUE,
         OUT x integer, OUT y integer,
         OUT val double precision
 ) -> SETOF record
 }}}

 distance: value greater than zero denoting the size of the neighborhood
 around the specified pixel.  So a value of 4 would be all pixels within
 the box made by 4 pixels to the left of, 4 pixels to the right of, 4
 pixels above and 4 pixels below the specific pixel

 {{{
 ST_Neighborhood(
         rast raster,
         ix integer, iy integer,
         distance integer,
         exclude_nodata_value boolean DEFAULT TRUE,
         OUT x integer, OUT y integer,
         OUT val double precision
 ) -> SETOF record
 }}}

 {{{
 ST_Neighborhood(
         rast raster, band integer,
         pt geometry,
         distance integer,
         exclude_nodata_value boolean DEFAULT TRUE,
         OUT x integer, OUT y integer,
         OUT val double precision
 ) -> SETOF record
 }}}

 {{{
 ST_Neighborhood(
         rast raster,
         pt geometry,
         distance integer,
         exclude_nodata_value boolean DEFAULT TRUE,
         OUT x integer, OUT y integer,
         OUT val double precision
 ) -> SETOF record
 }}}

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/1752>
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.