ST_Reclassify remappe les valeurs de pixels des bandes d'un objet raster selon des règles basées sur des intervalles. Le raster renvoyé conserve la même référence spatiale et la même résolution que l'entrée ; le nombre de bandes en sortie dépend du paramètre reclassexpr.
Syntaxe
raster ST_Reclassify(raster raster_obj,
cstring reclassexpr default NULL
cstring storageOption default '')
Paramètres
| Paramètre | Description |
|---|---|
raster_obj |
Objet raster à reclassifier. |
reclassexpr |
Tableau JSON définissant les règles de reclassification pour chaque bande. |
storageOption |
Chaîne JSON contrôlant le stockage du raster de sortie. |
reclassexpr
Le paramètre reclassexpr est un tableau JSON. Chaque élément configure une bande.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
band |
integer | — | Index de la bande (commence à 0). |
remap |
object | — | Associe les plages de valeurs de pixels d'entrée aux valeurs de sortie. Consultez la syntaxe remap. |
nodata |
boolean | false |
true : les pixels ayant des valeurs nodata produisent une sortie nodata. false : les pixels nodata sont traités comme des valeurs numériques ordinaires. |
nodataValue |
float8 | 0 |
Valeur nodata attribuée en sortie. |
Syntaxe remap
Chaque paire clé-valeur dans remap associe une plage d'entrée à une valeur ou une plage de sortie.
Notation d'intervalle
| Symbole | Signification | Exemple |
|---|---|---|
[ |
Supérieur ou égal à (≥) | [100 → valeur ≥ 100 |
( |
Strictement supérieur à (>) | (100 → valeur > 100 |
] |
Inférieur ou égal à (≤) | 100] → valeur ≤ 100 |
) |
Strictement inférieur à (<) | 100) → valeur < 100 |
L'intervalle par défaut est (] (ouvert à gauche, fermé à droite).
Exemples d'intervalles complets
| Expression | Condition équivalente |
|---|---|
[a,b] |
a ≤ valeur ≤ b |
(a,b] |
a < valeur ≤ b |
[a,b) |
a ≤ valeur < b |
(a,b) |
a < valeur < b |
Méthodes de mappage
Trois méthodes de mappage sont disponibles. Toutes utilisent des valeurs séparées par des virgules pour définir les plages d'entrée et les valeurs de sortie.
| Méthode | Valeurs d'entrée | Valeurs de sortie | Exemple |
|---|---|---|---|
| Plage vers valeur | n+1 valeurs (n intervalles) | n valeurs | "(300,400,500]":"80,90" |
| Plage vers plage | n valeurs | n valeurs | "300,400,500":"80,90,100" et "[300,400,500]":"80,90,100" |
| Valeur vers valeur | 1 valeur | 1 valeur | "10":"1" |
Règles :
Les valeurs de pixels situées en dehors de toutes les plages mappées sont traitées comme nodata.
Les plages ne doivent pas se chevaucher (une même valeur de pixel ne peut appartenir à deux plages).
Exemples reclassexpr
Exemple 1 : Bande unique, mappage plage vers valeur
Reclassification de la bande 0 :
0 < valeur ≤ 100 → 20
100 < valeur ≤ 200 → 50
Toutes les autres valeurs → nodata
[
{
"band": 0,
"remap": {
"(0,100,200]": "20,50"
}
}
]
Exemple 2 : Bande unique, plusieurs plages disjointes
Plusieurs segments de valeurs sont pris en charge. Les valeurs de pixels au-delà de la plage sont définies sur des valeurs nodata.
[
{
"band": 0,
"remap": {
"(0,100,200]": "20,50",
"(300,400,500]": "80,90,100"
}
}
]
Exemple 3 : Deux bandes avec contrôle nodata
La bande 0 utilise nodata: true : les pixels ayant des valeurs nodata produisent une sortie nodata, et les pixels hors plage obtiennent une valeur nodata de 999. La bande 1 utilise nodata: false : les pixels nodata sont calculés comme des valeurs ordinaires, et les pixels hors plage obtiennent une valeur nodata de 0.
[
{
"band": 0,
"remap": {
"(0,100,200]": "20,50"
},
"nodata": true,
"nodataValue": 999
},
{
"band": 1,
"remap": {
"(400,600,800]": "20,90,130"
},
"nodata": false,
"nodataValue": 0
}
]
Pour la bande 1, le mappage plage vers plage "(400,600,800]":"20,90,130" mappe les valeurs dans chaque intervalle :
400 < valeur ≤ 600 → interpolation entre 20 et 90
600 < valeur ≤ 800 → interpolation entre 90 et 130
storageOption
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
chunking |
boolean | Identique à l'entrée | Indique si la sortie doit être stockée sous forme de chunks. |
chunkdim |
string | Identique à l'entrée | Dimensions des chunks. Prend effet uniquement lorsque chunking est défini sur true. |
chunktable |
string | '' |
Nom de la table de chunks. Une chaîne vide génère une table de chunks temporaire avec un nom aléatoire, valide uniquement pour la session actuelle. Spécifiez un nom pour conserver la sortie entre les sessions. |
compression |
string | Identique à l'entrée | Algorithme de compression. Valeurs valides : none, jpeg, zlib, png, lzo, lz4. |
quality |
integer | Identique à l'entrée | Qualité de la compression. S'applique uniquement à l'algorithme jpeg. |
interleaving |
string | Identique à l'entrée | Méthode d'entrelacement : bip (band interleaved by pixel, BIP), bil (band interleaved by line, BIL) ou bsq (band sequential, BSQ). |
endian |
string | Identique à l'entrée | Ordre des octets : NDR (little endian) ou XDR (big endian). |
celltype |
string | Identique à l'entrée | Type de pixel du raster de sortie. |
Exemples
Les exemples suivants reclassifient la bande 0 d'un raster en utilisant l'intervalle (0,100,200] → 20,50.
Stocker les résultats dans une table temporaire (session actuelle uniquement)
-- Create the temporary table
CREATE TEMP TABLE rast_reclassify_result_temp(id integer, rast raster);
-- Run reclassification and store the result
INSERT INTO rast_reclassify_result_temp(id, rast)
SELECT 1, ST_Reclassify(rast, '[{"band":0,"remap":{"(0,100,200]":"20,50"}}]')
FROM reclass_table;
Stocker les résultats dans une table permanente
-- Create the permanent table
CREATE TABLE rast_reclassify_result(id integer, rast raster);
-- Run reclassification and store the result
INSERT INTO rast_reclassify_result(id, rast)
SELECT 1, ST_Reclassify(rast, '[{"band":0,"remap":{"(0,100,200]":"20,50"}}]')
FROM reclass_table;
Le paramètrechunktabledansstorageOptionest par défaut une chaîne vide, ce qui crée une table de chunks temporaire valide uniquement pour la session actuelle. Pour conserver le raster reclassifié entre les sessions, spécifiez un nom pourchunktable.