Disponible avec une licence Spatial Analyst.
Disponible avec une licence Image 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 Maximum, Minimum, Moyen, Médiane, 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 la plage ou l’écart type, les cellules en sortie ont toutes la valeur 0. Pour la variété, la valeur est égale à 1.
Si le paramètre Process as multiband (Traiter comme multicanal) est désactivé (process_as_multiband est défini sur SINGLE_BAND dans Python), chaque canal d’un raster multicanal en entrée est traité séparément comme s’il s’agissait d’un raster monocanal et la sortie est un raster monocanal.
L’outil Statistiques de cellule outil crée une sortie monocanale lors d’un traitement en tant que SINGLE_BAND. Si le paramètre Process as multiband (Traiter comme multicanal) est activé (process_as_multiband est défini sur MULTI_BAND dans Python), chaque un raster multicanal en entrée est traité comme s’il s’agissait d’un raster multicanal et la sortie est un raster multicanal. 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.
L’outil Statistiques de cellule outil crée une sortie multicanale lors d’un traitement en tant que MULTI_BAND. 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}, {process_as_multiband})
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 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 multicanaux doivent comporter le même nombre de canaux. | Raster Layer; Constant |
statistics_type (Facultatif) | Spécifie le type de statistique à calculer.
Le type de statistique par défaut est Moyenne. | String |
ignore_nodata (Facultatif) | Précise si les valeurs NoData sont ignorées par le calcul de statistiques.
| Boolean |
process_as_multiband (Facultatif) | Indique le mode de traitement des canaux des rasters multicanaux en entrée.
| 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 |
Exemple de code
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")
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
Informations de licence
- Basic: Requiert Spatial Analyst ou Image Analyst
- Standard: Requiert Spatial Analyst ou Image Analyst
- Advanced: Requiert Spatial Analyst ou Image Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?