Name
ST_Overlaps — Return true if raster rastA and rastB intersect but one does not completely contain the other.
Synopsis
boolean ST_Overlaps(
raster
rastA
,
integer
nbandA
,
raster
rastB
,
integer
nbandB
);
boolean ST_Overlaps(
raster
rastA
,
raster
rastB
);
Description
Return true if raster rastA spatially overlaps raster rastB. This means that rastA and rastB intersect but one does not completely contain the other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
![[Note]](../images/note.png)
|
|
|
This function will make use of any indexes that may be available on the rasters. |
|
|
|
|
To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry). |
Availability: 2.1.0
Examples
-- comparing different bands of same raster
SELECT ST_Overlaps(rast, 1, rast, 2) FROM dummy_rast WHERE rid = 2;
st_overlaps
-------------
f