Statistiques de cellule (Image 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 sont les suivantes : moyenne, majorité, maximum, médiane, minimum, minorité, plage, écart type et variété.

En savoir plus sur le fonctionnement de l’outil Statistiques de cellule

Illustration

Exemples de valeurs en entrée et en sortie de l’outil Statistiques de cellule
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, 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 Traiter comme multicanal est désactivé (process_as_multiband 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.

    Sortie monocanal lors d’un traitement en tant que SINGLE_BAND
    L’outil Statistiques de cellule crée une sortie monocanal lors d’un traitement en tant que SINGLE_BAND.
  • Si le paramètre Traiter comme multicanal est activé (process_as_multiband défini sur MULTI_BAND dans Python), chaque 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.

    Sortie multicanal lors d’un traitement en tant que MULTI_BAND.
    L’outil Statistiques de cellule outil crée une sortie multicanal lors d’un traitement en tant que MULTI_BAND.
  • Dans ArcPy, si les toutes les entrées sont des rasters multidimensionnels comportant le même nombre de variables, l’outil effectue l’opération pour toutes les tranches dotées de la même valeur de dimension ; la sortie obtenue est un raster multidimensionnel. Les variables des entrées doivent avoir les mêmes dimensions ou des dimensions communes.

    Si toutes les entrées sont des rasters multidimensionnels possèdent une variable mais ont des noms différents, définissez l’environnement de géotraitement matchMultidimensionalVariable sur False pour effectuer l’opération.

    Dans ArcPy, si une ou plusieurs entrées correspondent à un raster multidimensionnel et qu’une autre entrée est une constante, 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.

Paramètres

ÉtiquetteExplicationType de données
Rasters ou valeurs constantes en entrée

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 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 statistiques par défaut est Moyenne.

  • MoyenneLa moyenne des entrées est calculée.
  • MajoritéLa majorité (valeur survenant le plus souvent) des entrées est calculée.
  • MaximumLa valeur maximale (la plus grande valeur) des entrées est calculée.
  • MédianeLa médiane des entrées est calculée.
  • MinimalLa valeur minimale (la plus petite valeur) des entrées est calculée.
  • MinoritéLa minorité (valeur survenant le moins souvent) des entrées est calculée.
  • PlageLa plage (différence entre la valeur la plus grande et la plus petite) des entrées est calculée.
  • Écart typeL’écart type des entrées est calculé.
  • SommeLa 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 renvoyée

ÉtiquetteExplicationType 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

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})
NomExplicationType 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.

  • MEANLa moyenne des entrées est calculée.
  • MAJORITYLa majorité (valeur survenant le plus souvent) des entrées est calculée.
  • MAXIMUMLa valeur maximale (la plus grande valeur) des entrées est calculée.
  • MEDIANLa médiane des entrées est calculée.
  • MINIMUMLa valeur minimale (la plus petite valeur) des entrées est calculée.
  • MINORITYLa minorité (valeur survenant le moins souvent) des entrées est calculée.
  • RANGELa plage (différence entre la valeur la plus grande et la plus petite) des entrées est calculée.
  • STDL’écart type des entrées est calculé.
  • SUMLa somme (total de toutes les valeurs) des entrées est calculée.
  • VARIETYLa variété (nombre de valeurs uniques) des entrées est calculée.

Le type de statistiques par défaut est Moyenne.

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.
  • NODATASi 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_BANDChaque 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_BANDChaque 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 renvoyée

NomExplicationType 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.ia import *
env.workspace = "C:/iapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/iapyexamples/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: Image Analyst Extension

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

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

# 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")

Informations de licence

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

Rubriques connexes