Tous les produits
Search
Centre de documentation

PolarDB:ST_Reclassify

Dernière mise à jour :Sep 02, 2026

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ètre chunktable dans storageOption est 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 pour chunktable .