Statistiques par bloc (ArcGIS Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Cet outil permet de partitionner une entrée en blocs non superposés et de calculer les statistiques relatives aux valeurs dans chaque bloc. La valeur est attribuée à toutes les cellules dans chaque bloc dans la sortie.

Pour en savoir plus sur le fonctionnement de l'outil Statistiques par bloc

Illustration

Illustration de l'utilisation de l'outil Statistiques par bloc avec l'option Maximum
OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,MAP), "MAXIMUM", "")

Utilisation

Syntaxe

BlockStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
ParamètreExplicationType de données
in_raster

Raster faisant l'objet de calculs avec l'outil Statistiques par bloc.

Raster Layer
neighborhood
(Facultatif)

La classe Voisinage dicte la forme de la zone autour de chaque cellule utilisée pour le calcul des statistiques.

Les différents types de voisinage disponibles sont NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, et NbrWeight.

Formes des voisinages :

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})
  • NbrIrregular(inKernelFile)
  • NbrWeight(inKernelFile)

Le voisinage par défaut est un voisinage NbrRectangle carré avec une largeur et une hauteur de 3 cellules.

Neighborhood
statistics_type
(Facultatif)

Type de statistique à calculer.

  • MOYENNE Calcule la moyenne des cellules du voisinage.
  • MAJORITY Calcule la majorité (valeur la plus fréquente) des cellules du voisinage.
  • MAXIMUM Calcule le maximum (valeur la plus élevée) des cellules du voisinage.
  • MEDIANE Calcule la médiane des cellules du voisinage.
  • MINIMUM Calcule le minimum (valeur la plus faible) des cellules du voisinage.
  • MINORITY Calcule la minorité (valeur la moins fréquente) des cellules du voisinage.
  • PLAGE Calcule la plage (différence entre la valeur la plus élevée et la valeur la plus faible) des cellules du voisinage.
  • ECART TYPE Calcule l'écart type des cellules du voisinage.
  • SUM Calcule la somme (total de toutes les valeurs) des cellules du voisinage.
  • VARIETE Calcule la variété (le nombre de valeurs uniques) des cellules du voisinage.

Le type de statistiques par défaut est MEAN.

String
ignore_nodata
(Facultatif)

Indique si les valeurs NoData sont ignorées par le calcul de statistiques.

  • DATA Précise que si une valeur NoData existe dans un voisinage de bloc, elle est ignorée. Seules les cellules du voisinage dotées de valeurs de données sont utilisées dans la détermination de la valeur en sortie. Il s'agit de l'option par défaut.
  • NODATA Précise que si une cellule d'un voisinage a une valeur NoData, la sortie de chaque cellule du bloc correspondant reçoit NoData. Avec cette option, la présence d'une valeur NoData implique que les informations sont insuffisantes pour calculer les statistiques pour le voisinage.
Boolean

Valeur renvoyée

NomExplicationType de données
out_raster

Raster des statistiques du bloc en sortie.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil BlockStatistics (fenêtre Python)

Cet exemple décrit le calcul de la valeur d'une cellule minimale dans chaque voisinage d'anneau non superposé dans le raster GRID en entrée.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nbr = NbrAnnulus(1, 3, "MAP")
outBlockStat = BlockStatistics("block", nbr, "MINIMUM", "")
outBlockStat.save("C:/sapyexamples/output/blockstat")
Deuxième exemple d'utilisation de l'outil BlockStatistics (script autonome)

Cet exemple décrit le calcul de la valeur d'une cellule minimale dans chaque voisinage d'anneau non superposé dans le raster GRID en entrée.

# Name: BlockStatistics_Ex_02.py
# Description: Calculates statistics for a nonoverlapping 
#              neighborhood.
# 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
inRaster = "block"
nbr = NbrAnnulus(1, 3, "MAP")

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

# Execute BlockStatistics
outBlockStat = BlockStatistics(inRaster, nbr, "MINIMUM", "NODATA")

# Save the output 
outBlockStat.save("C:/sapyexamples/output/blockstat")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst
5/10/2014