Statistiques de cellule (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Calcule des statistiques par cellule à partir de rasters multiples.

Les statistiques disponibles sont les suivantes : Majorité, Maximum, Moyenne, Médiane, Minimum, Minorité, Centile, Plage, Écart type, Somme et Variété.

Learn more about how Cell Statistics works

Illustration

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. Lorsque vous sélectionnez la plage ou l’écart type, les cellules en sortie ont toutes la valeur 0. Pour la variété, la valeur est égale à 1.

• If the Process as multiband parameter is unchecked (process_as_multiband is set to SINGLE_BAND in Python), each band from a multiband raster input will be processed separately as a single band raster, and the output will be a single band raster.

  

  The Cell Statistics tool creates a single-band output when processed as SINGLE_BAND.

• If the Process as multiband parameter is checked (process_as_multiband is set to MULTI_BAND in Python), each multiband raster input will be processed as a multiband raster, and the output will be a multiband raster. Le raster en sortie est également un raster multicanal si les entrées sont une combinaison d’un raster multicanal et de constantes. Le nombre de canaux de chaque entrée multicanale est identique.

  L’outil effectue l’opération sur chaque canal à partir d’une entrée en utilisant le canal correspondant de l’autre entrée. Si une entrée est un raster multicanal et l’autre est une constante, l’outil réalise l’opération en utilisant la valeur constante de chaque canal dans l’entrée multicanale.

  

  The Cell Statistics tool creates a multiband output when processed as MULTI_BAND.

• Si toutes les entrées sont des données raster multidimensionnelles avec le même nombre de variables, l’outil effectue l’opération pour toutes les tranches qui possèdent la même valeur de dimension. 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, faute de quoi une erreur est générée.

  Si toutes les entrées ont une variable, mais des noms différents, désélectionnez l’environnement de géotraitement Apparier la variable multidimensionnelle(définissez arcpy.env.matchMultidimensionalVariable = False dans Python) avant d’effectuer l’opération.

  Si une ou plusieurs entrées sont des rasters multidimensionnels et que les autres entrées sont constantes, l’outil effectue l’opération pour toutes les tranches de toutes les variables à l’aide de la valeur constante et la sortie est un raster multidimensionnel.

• Pour les calculs de la majorité et de la minorité, lorsqu’il existe une association, la sortie est la plus faible des valeurs associées.

• Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Rasters ou valeurs constantes en entrée	Liste des rasters en entrée pour lesquels une opération statistique est calculée pour chaque cellule à l’intérieur 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 multicanal) est sélectionné, toutes les entrées multicanales doivent comporter le même nombre de canaux.	Raster Layer; Constant
Statistique de croisement (Facultatif)	Spécifie le type de statistique à calculer. Le type de statistique par défaut est Moyenne. Moyenne—La moyenne des entrées est calculée. Il s’agit de l’option par défaut. Majorité—La majorité (valeur survenant le plus souvent) des entrées va être calculée. Maximum—Le maximum (valeur la plus importante) des entrées va être calculé. Médiane—La médiane des entrées est calculée. Minimum—Le minimum (valeur la plus petite) des entrées va être calculé. Minorité—La minorité (valeur survenant le moins souvent) des entrées va être calculée. Centile—Le centile des entrées va être 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 pourcentage). Plage—La plage (différence entre la valeur la plus grande et la plus petite) des entrées est calculée. Écart type—L’écart type des entrées est calculé. Somme—La somme (total de toutes les valeurs) des entrées est calculée. Variété—La variété (nombre de valeurs uniques) des entrées est calculée.	String
Ignorer NoData dans les calculs (Facultatif)	Précise 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ésactivé : 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 (Traiter comme multicanal) (Facultatif)	Indique comment les canaux des rasters multicanaux en entrée sont traités. Désélectionnée : chaque canal d’une entrée de raster multicanal est traité séparément comme un raster monocanal. Il s’agit de l’option par défaut. Cochée : chaque entrée de raster multicanal est traitée comme un raster multicanal. L’opération est effectuée pour chaque canal d’une même entrée en utilisant le numéro de canal correspondant des autres entrées.	Boolean
Valeur du pourcentage (Facultatif)	Valeur de centile qui est calculée. La valeur par défaut est 90, soit le 90e centile. La valeur peut être comprise entre 0 et 100. Le centile 0 équivaut sensiblement à la statistique de minimum, tandis que le 100e centile équivaut à la statistique de maximum. La valeur 50 produit essentiellement le même résultat que la statistique médiane. Ce paramètre est disponible uniquement si le paramètre Statistique de superposition est défini sur Centile.	Double
Percentile Interpolation Type (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 les pixels des rasters en entrée sont de type entier, la méthode Le plus proche est utilisée. Si les pixels des rasters en entrée sont de type à virgule flottante, la méthode Linéaire est utilisée. Il s’agit de l’option par défaut. Les plus proches—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 renvoyée

Étiquette	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.	Raster

Python

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})

Nom	Explication	Type de données
in_rasters_or_constants [in_raster_or_constant,...]	Liste des rasters en entrée pour lesquels une opération statistique est calculée pour chaque cellule à l’intérieur 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. If the processing_as_multiband parameter is set to MULTI_BAND, all multiband inputs should have an equal number of bands.	Raster Layer; Constant
statistics_type (Facultatif)	Spécifie le type de statistique à calculer. MEAN—La moyenne des entrées est calculée. Il s’agit de l’option par défaut. MAJORITY—La majorité (valeur survenant le plus souvent) des entrées va être calculée. MAXIMUM—Le maximum (valeur la plus importante) des entrées va être calculé. MEDIAN—La médiane des entrées est calculée. MINIMUM—Le minimum (valeur la plus petite) des entrées va être calculé. MINORITY—La minorité (valeur survenant le moins souvent) des entrées va être calculée. PERCENTILE—Le centile des entrées va être calculé. Le 90è centile est calculé par défaut. You can specify other values (from 0 to 100) using the percentile_value parameter. RANGE—La plage (différence entre la valeur la plus grande et la plus petite) des entrées est calculée. STD—L’écart type des entrées est calculé. SUM—La somme (total de toutes les valeurs) des entrées est calculée. VARIETY—La variété (nombre de valeurs uniques) des entrées est calculée. The default statistic type is MEAN.	String
ignore_nodata (Facultatif)	Précise 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 canaux des rasters multicanaux en entrée sont traités. SINGLE_BAND—Chaque canal d’une entrée de raster multicanal est traité séparément comme un raster monocanal. Il s’agit de l’option par défaut. MULTI_BAND—Chaque entrée de raster multicanal est traitée comme un raster multicanal. L’opération est effectuée pour chaque canal d’une même entrée en utilisant le numéro de canal correspondant des autres entrées.	Boolean
percentile_value (Facultatif)	Valeur de centile qui est calculée. La valeur par défaut est 90, soit le 90e centile. La valeur peut être comprise entre 0 et 100. Le centile 0 équivaut sensiblement à la statistique de minimum, tandis que le 100e centile équivaut à la statistique de maximum. La valeur 50 produit essentiellement le même résultat que la statistique médiane. This parameter is only supported if the statistics_type parameter is set to 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—If the input rasters are of integer pixel type, the NEAREST method will be used. If the input rasters are of floating point pixel type, the LINEAR method will be used. 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 renvoyée

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

Premier exemple d'utilisation de l'outil 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.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")

Deuxième exemple d'utilisation de l'outil CellStatistics (script autonome)

Cet exemple calcule la plage par cellule par canal sur plusieurs rasters multicanaux en entrée et crée un raster multicanal en sortie.

# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
#               and process as multiband.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

• Basic: Nécessite Spatial Analyst ou Image Analyst
• Standard: Nécessite Spatial Analyst ou Image Analyst
• Advanced: Nécessite Spatial Analyst ou Image Analyst