Renvoie la géométrie polygonale délimitant chaque pixel d'une bande raster, ainsi que la valeur du pixel et ses coordonnées de ligne et de colonne.
Contrairement à ST_DumpAsPolygons, qui regroupe les pixels de même valeur en une seule géométrie, ST_PixelAsPolygons renvoie un polygone par pixel.
Syntaxe
setof record ST_PixelAsPolygons(raster raster_obj,
integer band default 0,
integer pyramid default 0,
boolean exclude_nodata_value default true,
out integer rowsn,
out integer columnsn,
out integer bandsn,
out double value,
out geometry geom);
Paramètres
| Paramètre | Description |
|---|---|
raster_obj |
Le raster à interroger. |
band |
L'identifiant de la bande à interroger. Les identifiants de bande commencent à 0. Valeur par défaut : 0. |
pyramid |
L'identifiant du niveau de pyramide à interroger. Valeur par défaut : 0. |
exclude_nodata_value |
Indique s'il faut exclure les pixels NoData du jeu de résultats. Valeur par défaut : true. |
Colonnes de sortie
Chaque ligne renvoyée par la fonction contient les colonnes suivantes :
| Colonne | Type | Description |
|---|---|---|
rowsn |
integer | Le numéro de ligne du pixel. |
columnsn |
integer | Le numéro de colonne du pixel. |
bandsn |
integer | L'identifiant de la bande à laquelle appartient le pixel. |
value |
double | La valeur du pixel. |
geom |
geometry | L'étendue spatiale (polygone) du pixel. |
Exemple
L'exemple suivant interroge la table rast_table pour les pixels de la bande 1, puis filtre le résultat pour ne conserver que les lignes dont la valeur du pixel est supérieure à 38,0.
WITH tmp AS (
SELECT (ST_PixelAsPolygons(rast, 1)).*
FROM rast_table
WHERE id = 10
)
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom)
FROM tmp
WHERE value > 38.0;
Exemple de sortie :
rowsn | columnsn | bandsn | value | st_asewkt
-------+----------+--------+-------+------------------------------------------------------------
100 | 100 | 0 | 43 | SRID=4326;POLYGON((-180 90,-180 89.1,-179.1 89.1,-179.1 90,-180 90))
Voir aussi
ST_DumpAsPolygons— regroupe les pixels de même valeur en géométries polygonales fusionnéesST_PixelAsPolygon— renvoie la géométrie polygonale d'un seul pixel situé à une ligne et une colonne spécifiéesST_PixelAsPoint— renvoie la géométrie ponctuelle d'un seul pixelST_PixelAsPoints— renvoie les géométries ponctuelles de tous les pixels d'une bandeST_PixelAsCentroid— renvoie le centroïde du polygone d'un seul pixelST_PixelAsCentroids— renvoie les géométries des centroïdes de tous les pixels d'une bande