Statistiques de cellule (Spatial Analyst)—ArcMap

Disponible avec une licence Spatial Analyst.

Résumé
Illustration
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Calcule des statistiques par cellule à partir de rasters multiples.

Les statistiques sont les suivantes : moyenne, majorité, maximum, médiane, minimum, minorité, plage, écart type et variété.

Pour plus d'informations sur le fonctionnement de l'outil Statistiques de cellules

Illustration

Utilisation

L'ordre des rasters en entrée est sans importance avec cet outil.
Lorsqu’un raster multicanal est spécifié comme l’un des rasters ou valeurs constantes en entrée (Input rasters or constant values) (in_rasters_or_constants dans Python), tous les canaux sont utilisés.
Pour traiter une sélection de canaux à partir d’un raster multicanal, vous pouvez créer en premier un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites et utilisez le résultat dans la liste des rasters en entrée ou valeurs constantes (Input rasters or constant values) (in_rasters_or_constants dans Python).
Pour les types de statistiques Maximal, Minimal, Moyen, Médian, Majorité, Minorité 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 Plage ou STD, les cellules en sortie auront la valeur 0, et 1 pour Variété.
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.

Syntaxe

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata})

Paramètre	Explication	Type de données
in_rasters_or_constants [in_raster_or_constant,...]	Liste des rasters en entrée pour lesquels un calcul de statistiques est effectué pour chaque cellule à l'intérieur de la fenêtre 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.	Raster Layer; Constant
statistics_type (Facultatif)	Type de statistique à calculer. MEAN —Calcule la moyenne des entrées. MAJORITY —Calcule la majorité (valeur survenant le plus souvent) des entrées. MAXIMUM —Calcule le maximum (valeur la plus importante) des entrées. MEDIAN —Calcule la médiane des entrées. MINIMUM —Calcule le minimum (valeur la plus petite) des entrées. MINORITY —Calcule la minorité (valeur survenant le moins souvent) des entrées. RANGE —Calcule la plage (différence entre la valeur la plus grande et la plus petite) des entrées. STD —Calcule l'écart type des entrées. SUM —Calcule la somme (total des valeurs) des entrées. VARIETY —Calcule la diversité (nombre de valeurs uniques) des entrées. Le type de statistiques par défaut est Moyenne.	String
ignore_nodata (Facultatif)	Indique si les valeurs NoData sont ignorées par le calcul de statistiques. DATA —A 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

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

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 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 Grid.

# Name: CellStatistics_Ex_02.py
# Description: Calculates a per-cell statistic from multiple rasters
# Requirements: Spatial Analyst Extension

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

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "cost"

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

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

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