Calcule des statistiques par cellule à partir de rasters multiples.
Les statistiques disponibles sont les suivantes : Majority (Majorité), Maximum, Mean (Moyenne), Median (Médiane), Minimum, Minority (Minorité), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) et Variety (Variété).
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")
Utilisation
L'ordre des rasters en entrée est sans importance avec cet outil.
Pour les types de statistiques Maximum, Minimum, Moyenne, Médiane, Majorité, Minorité, Centile et Somme, si vous n’utilisez qu’un raster en entrée, les valeurs de cellule en sortie seront les mêmes que les valeurs de cellule en entrée. Pour Plage et Écart type, les cellules en sortie ont la valeur 0. Pour Variété, elles ont la valeur 1.
Si le paramètre Process as multiband (Traiter comme multibande) est désactivé (process_as_multiband est défini sur SINGLE_BAND dans Python), chaque bande provenant d’un raster multibande en entrée est traitée séparément comme un raster à une seule bande, et la sortie est un raster à une seule bande.
L’outil Cell Statistics (Statistiques de cellule) crée une sortie à une seule bande en cas de traitement SINGLE_BAND.
Si le paramètre Process as multiband (Traiter comme multibande) est activé (process_as_multiband est défini sur MULTI_BAND dans Python), chaque raster multibande en entrée est traité comme un raster multibande. Le raster en sortie est également un raster multibande si les entrées sont une combinaison de raster multibande et de constantes. Le nombre de bandes dans chaque entrée multibande doit être identique.
L’outil exécute l’opération sur chaque bande d’une entrée en utilisant la bande correspondante de l’autre entrée. Si l’une des entrées est un raster multibande et que l’autre entrée est une constante, l’outil exécute l’opération en utilisant la valeur constante de chaque bande de l’entrée multibande.
L’outil Cell Statistics (Statistiques de cellule) crée une sortie multibande en cas de traitement MULTI_BAND.
Si toutes les entrées sont des données raster multidimensionnelles comportant le même nombre de variables, l’outil effectue l’opération pour toutes les tranches dont la valeur de dimension est identique. La sortie est un raster multidimensionnel au format CRF. Les variables des entrées doivent posséder au moins une dimension en commun et une valeur dimensionnelle en commun à traiter par cet outil, sinon, une erreur se produit.
Si toutes les entrées comportent une variable, mais ont des noms différents, désactivez l’environnement de géotraitement Match Multidimensional Variable (Apparier la variable multidimensionnelle) (définissez arcpy.env.matchMultidimensionalVariable = False dans Python) avant d’effectuer l’opération.
Si l’une des entrées ou plusieurs d’entre elles correspondent à un raster multidimensionnel et que les autres entrées sont des constantes, l’outil procède à l’opération pour toutes les tranches de toutes les variables en utilisant la valeur constante, la sortie étant un raster multidimensionnel.
Pour les calculs de majorité et de minorité, en cas d’égalité, la sortie correspond à la plus faible des valeurs égales.
Lorsque le raster en entrée comporte des cellules rectangulaires, il est traité de telle sorte que les cellules du raster en sortie soient carrées avec des côtés égaux à la moyenne de la longueur et de la largeur des cellules rectangulaires.
Liste des rasters en entrée pour lesquels une opération statistique est calculée pour chaque cellule de la fenêtre d’analyse.
Un nombre peut être utilisé comme entrée. Toutefois, la taille de cellule et l'étendue doivent être définies en premier dans l'environnement.
Si le paramètre Process as multiband (Traiter comme multibande) est activé, toutes les entrées multibandes doivent comporter le même nombre de bandes.
Raster Layer; Constant
Statistique de superposition
(Facultatif)
Spécifie le type de statistique à calculer.
Moyenne—La moyenne des entrées sera calculée. Il s’agit de l’option par défaut.
Majorité—La majorité (valeur qui apparaît le plus souvent) des entrées sera déterminée.
Maximum—Le maximum (valeur la plus grande) des entrées sera déterminé.
Médiane—La médiane des entrées sera déterminée.
Minimum—Le minimum (valeur la plus petite) des entrées sera déterminé.
Minorité—La minorité (valeur qui se produit le moins souvent) des entrées sera déterminée.
Centile—Le centile des entrées est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile Value (Valeur de centile).
Plage—La plage (différence entre les valeurs les plus grandes et les plus petites) des entrées sera calculée.
Écart type—L’écart type des entrées sera calculé.
Somme—La somme (total de toutes les valeurs) des entrées sera calculée.
Variété—La variété (nombre de valeurs uniques) des entrées sera calculée.
String
Ignorer NoData dans les calculs
(Facultatif)
Indique si les valeurs NoData sont ignorées par le calcul de statistiques.
Activé—À l’emplacement de la cellule de traitement, si des rasters en entrée possèdent la valeur NoData, cette valeur NoData est ignorée. Les statistiques sont calculées en tenant compte uniquement des cellules avec des valeurs valides. Il s’agit de l’option par défaut.
Décoché—Si l’emplacement de la cellule de traitement des rasters en entrée est égal à NoData, la sortie de cette cellule est égale à NoData.
Boolean
Traiter comme multibande
(Facultatif)
Indique comment les bandes des rasters multibandes en entrée seront traitées.
Activé—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées.
Décoché—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.
Boolean
Valeur du centile
(Facultatif)
Valeur de centile à calculer. La valeur par défaut est de 90, soit le 90e centile.
La valeur peut être comprise entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut à la statistique maximale. Une valeur de 50 donne le même résultat que la statistique médiane.
Ce paramètre est disponible uniquement si le paramètre Overlay statistic (Statistique de superposition) est défini sur Percentile (Centile).
Double
Type d’interpolation en centile
(Facultatif)
Définit la méthode d’interpolation à utiliser lorsque la valeur de centile spécifiée se situe entre deux valeurs de cellule en entrée.
Détection automatique—Si le type de pixel des rasters en entrée est entier, la méthode Nearest (Le plus proche) est utilisée. Si le type de pixel des rasters en entrée est flottant, la méthode Linear (Linéaire) est utilisée. Il s’agit de l’option par défaut.
Le plus proche—La valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui des rasters en entrée.
Linéaire—La moyenne pondérée des deux valeurs environnantes du centile va être utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
Valeur de retour
Etiqueter
Explication
Type de données
Raster en sortie
Raster en sortie.
Pour chaque cellule, la valeur est déterminée en appliquant le type de statistiques attribué aux rasters en entrée à cet emplacement.
Liste des rasters en entrée pour lesquels une opération statistique est calculée pour chaque cellule de la fenêtre d’analyse.
Un nombre peut être utilisé comme entrée. Toutefois, la taille de cellule et l'étendue doivent être définies en premier dans l'environnement.
Si le paramètre processing_as_multiband est défini sur MULTI_BAND, toutes les entrées multibandes doivent comporter le même nombre de bandes.
Raster Layer; Constant
statistics_type
(Facultatif)
Spécifie le type de statistique à calculer.
MEAN—La moyenne des entrées sera calculée. Il s’agit de l’option par défaut.
MAJORITY—La majorité (valeur qui apparaît le plus souvent) des entrées sera déterminée.
MAXIMUM—Le maximum (valeur la plus grande) des entrées sera déterminé.
MEDIAN—La médiane des entrées sera déterminée.
MINIMUM—Le minimum (valeur la plus petite) des entrées sera déterminé.
MINORITY—La minorité (valeur qui se produit le moins souvent) des entrées sera déterminée.
PERCENTILE—Le centile des entrées est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre percentile_value.
RANGE—La plage (différence entre les valeurs les plus grandes et les plus petites) des entrées sera calculée.
STD—L’écart type des entrées sera calculé.
SUM—La somme (total de toutes les valeurs) des entrées sera calculée.
VARIETY—La variété (nombre de valeurs uniques) des entrées sera calculée.
String
ignore_nodata
(Facultatif)
Indique si les valeurs NoData sont ignorées par le calcul de statistiques.
DATA—À l’emplacement de la cellule de traitement, si des rasters en entrée possèdent la valeur NoData, cette valeur NoData est ignorée. Les statistiques sont calculées en tenant compte uniquement des cellules avec des valeurs valides. Il s’agit de l’option par défaut.
NODATA—Si l’emplacement de la cellule de traitement des rasters en entrée est égal à NoData, la sortie de cette cellule est égale à NoData.
Boolean
process_as_multiband
(Facultatif)
Indique comment les bandes des rasters multibandes en entrée seront traitées.
MULTI_BAND—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées.
SINGLE_BAND—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.
Boolean
percentile_value
(Facultatif)
Valeur de centile à calculer. La valeur par défaut est de 90, soit le 90e centile.
La valeur peut être comprise entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut à la statistique maximale. Une valeur de 50 donne le même résultat que la statistique médiane.
Ce paramètre est pris en charge uniquement si le paramètre statistics_type est défini sur PERCENTILE.
Double
percentile_interpolation_type
(Facultatif)
Définit la méthode d’interpolation à utiliser lorsque la valeur de centile spécifiée se situe entre deux valeurs de cellule en entrée.
AUTO_DETECT—Si le type de pixel des rasters en entrée est entier, la méthode NEAREST est utilisée. Si le type de pixel des rasters en entrée est flottant, la méthode LINEAR est utilisée. Il s’agit de l’option par défaut.
NEAREST—La valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui des rasters en entrée.
LINEAR—La moyenne pondérée des deux valeurs environnantes du centile va être utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
String
Valeur de retour
Nom
Explication
Type de données
out_raster
Raster en sortie.
Pour chaque cellule, la valeur est déterminée en appliquant le type de statistiques attribué aux rasters en entrée à cet emplacement.
Raster
Exemple de code
Exemple 1 d’utilisation de la fonction CellStatistics (fenêtre Python)
Cet exemple calcule l'écart type par cellule sur plusieurs rasters Grid en entrée et génère le résultat sous la forme d'un raster IMG.
Exemple 2 d’utilisation de la fonction CellStatistics (script autonome)
Cet exemple calcule la plage par cellule par bande sur plusieurs rasters multibandes en entrée et crée un raster multibande en sortie.
# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
# and process as multiband.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy.ia import *
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"
# Run CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")
# Save the output
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")
