Disponible avec une licence Spatial Analyst.
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.
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. Pour Plage et STD, les cellules en sortie ont la valeur 0 et pour Variété, elles ont toutes la valeur 1.
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.
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.
| Boolean |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster | Raster en sortie. La valeur est déterminée en appliquant le type de statistiques attribué aux rasters en entrée. | 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")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst