Calcule toutes les statistiques d’un raster, y compris l’histogramme et les centiles.
Syntaxe
raster ST_ComputeStatistics(raster raster_obj,
cstring sampleOption default '{}')
raster ST_ComputeStatistics(raster raster_obj,
cstring bands,
cstring sampleOption default '{}',
cstring parallelOption default '{}')Paramètres
| Paramètre | Description |
|---|---|
| raster_obj | L’objet raster. |
| bands | Les identifiants des bandes à traiter. Exemple : '0,1-3,6,8'. Les identifiants de bande commencent à 0. Pour traiter toutes les bandes, définissez ce paramètre sur ''. |
| sampleOption | Chaîne JSON contenant les options d’échantillonnage. Consultez le tableau paramètres sampleOption. La valeur par défaut est '{}'. |
| parallelOption | Chaîne JSON contenant les options d’exécution parallèle. Consultez le tableau paramètres parallelOption. La valeur par défaut est '{}'. |
Paramètres sampleOption
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
| approx | Booléen | false | Indique s’il faut utiliser un échantillonnage approximatif. Si la valeur est true, un échantillonnage est appliqué, mais le résultat peut être imprécis. |
| factor | entier | 4 | Facteur d’échantillonnage, exprimé en nombre de pixels par unité d’échantillonnage. Tout entier positif est valide. Ce paramètre s’applique uniquement lorsque approx est défini sur true. |
| exclusive_nodata | Booléen | true | Indique s’il faut inclure les valeurs NoData. Valeurs valides : true et false. |
Paramètres parallelOption
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
| parallel | entier | ganos.parallel.degree | Degré de parallélisme. Valeurs valides : 1 à 64. |
Exemples
-- Use default settings.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj) WHERE id = 1;
-- Specify bands and disable approximate sampling.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'0-2','{"approx":false}') WHERE id = 1;
-- Disable approximate sampling without specifying bands.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'{"approx":false}') WHERE id = 1;
-- Specify bands, enable approximate sampling with a custom factor, and set the degree of parallelism.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;