Convertit les pixels d'un raster situés à une position donnée en objets géométriques, chacun représenté par un point placé à la position de référence au sein de l'objet.
Syntaxe
setof record ST_PixelAsPoints(raster raster_obj,
integer band default 0,
integer pyramid default 0,
boolean exclude_nodata_value default true,
cstring ref_point default 'UPPERLEFT',
out integer rowsn,
out integer columnsn,
out integer bandsn,
out double value,
out geometry geom);
Paramètres
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
raster_obj |
raster | — | Le raster à interroger. |
band |
integer | 0 |
L'ID de la bande à interroger. Les ID de bande valides commencent à 0. |
pyramid |
integer | 0 |
L'ID du niveau de pyramide à interroger. |
exclude_nodata_value |
boolean | true |
Indique s'il faut exclure les pixels NoData. |
ref_point |
cstring | 'UPPERLEFT' |
La position de référence du point au sein de l'objet géométrique. Valeurs valides : UPPERLEFT (coin supérieur gauche) et CENTER (centre). |
rowsn |
out integer | — | Le numéro de ligne du pixel. |
columnsn |
out integer | — | Le numéro de colonne du pixel. |
bandsn |
out integer | — | L'ID de bande du pixel. |
value |
out double | — | La valeur du pixel. |
geom |
out geometry | — | L'étendue spatiale du pixel. |
Description
La fonction ST_PixelAsPoints convertit les pixels d'un raster situés à une position donnée en objets géométriques. Chaque objet géométrique est représenté par un seul point, positionné selon le paramètre ref_point : soit le coin supérieur gauche (UPPERLEFT), soit le centre (CENTER) de la géométrie du pixel.
Exemple
L'exemple suivant récupère tous les pixels de la bande 1 du raster dont l'id = 10, puis filtre ceux dont la valeur est supérieure à 38.0. Il renvoie pour chaque pixel le numéro de ligne, le numéro de colonne, la bande, la valeur et la géométrie au format Extended WKT.
WITH tmp AS (
SELECT (ST_PixelAsPoints(rast, 1)).*
FROM rast_table
WHERE id = 10
)
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom)
FROM tmp
WHERE value > 38.0;
Résultat :
rowsn | columnsn | bandsn | value | st_asewkt
-------+----------+--------+-------+---------------------------
100 | 100 | 0 | 43 | SRID=4326;POINT(-90 0)