Agréger (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Génère une version du raster à une résolution inférieure. Chaque cellule en sortie contient la somme, le minimum, le maximum, la moyenne ou la médiane des cellules en entrée qui figurent dans l’étendue de cette cellule.

Pour en savoir plus sur le fonctionnement de l'outil Agréger

Illustration

Illustration de l’outil Agréger
OutRas = Aggregate(InRas1, 3, Max, Expansion, Données)

Utilisation

Syntaxe

Aggregate (in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
ParamètreExplicationType de données
in_raster

Raster en entrée à agréger.

Il peut être de type entier ou à virgule flottante.

Raster Layer
cell_factor

Facteur par lequel il faut multiplier la taille de cellule du raster en entrée, en vue d'obtenir la résolution appropriée pour le raster en sortie.

Par exemple, la valeur d’un facteur de cellule de trois entraîne une taille de cellule en sortie trois fois supérieure à celle du raster en entrée.

La valeur doit être un entier supérieur à 1.

Long
aggregation_type
(Facultatif)

Définit la façon dont est déterminée la valeur de chaque cellule en sortie.

Les valeurs des cellules en entrée figurant dans la cellule en sortie la plus grossière sont regroupées dans l’une des statistiques suivantes :

  • SUMLa somme (total) des valeurs de cellule en entrée. Il s'agit de l'option par défaut.
  • MAXIMUM Valeur des cellules en entrée la plus élevée.
  • MEAN Valeur moyenne des cellules en entrée.
  • MEDIAN Valeur médiane des cellules en entrée.
  • MINIMUM Valeur la plus faible des cellules en entrée.
String
extent_handling
(Facultatif)

Définit la gestion des limites du raster en entrée si ses lignes ou ses colonnes ne sont pas des multiples du facteur de cellule.

  • EXPAND Permet d’étendre les limites en bas ou à droite du raster en entrée afin que le nombre total de cellules d'une ligne ou d'une colonne soit un multiple du facteur de cellule. Les cellules étendues sont associées à la valeur NoData.Cette option permet au raster en sortie de couvrir une étendue spatiale plus importante que celle du raster en entrée. Il s'agit de l'option par défaut. Il s'agit du paramétrage par défaut.
  • TRUNCATE Désactivée : permet de réduire le nombre de lignes ou de colonnes de 1. Dans ce cas, vous tronquez les cellules restantes situées aux limites en bas ou à droite du raster en entrée. Le nombre de cellules ou de colonnes dans le raster en entrée est donc un multiple du facteur de cellule.Cette option permet au raster en sortie de couvrir une étendue spatiale plus réduite que celle du raster en entrée.

Si le nombre de lignes et de colonnes du raster en entrée est un multiple de facteur_cellule, ces mots-clés ne sont pas employés.

Boolean
ignore_nodata
(Facultatif)

Indique si les valeurs NoData sont exclues du calcul d'agrégation.

  • DATA Indique que si une valeur NoData existe pour des cellules incluses dans l'étendue spatiale d'une plus grande cellule dans le raster en sortie, les valeurs NoData sont ignorées lors de la détermination de la valeur des positions des cellules en sortie. Seules les cellules en entrée se trouvant dans l'étendue de la cellule en sortie contenant des valeurs de données sont utilisées pour déterminer la valeur de la cellule en sortie. Il s'agit du paramétrage par défaut.
  • NODATA Indique que si une cellule incluse dans l'étendue spatiale d'une cellule plus grande dans le raster en sortie a une valeur NoData, la valeur de la position de cette cellule en sortie est également NoData.L'utilisation du mot-clé NODATA implique que lorsque les cellules d'une agrégation contiennent la valeur NoData, il manque des informations pour effectuer les calculs permettant de déterminer une valeur en sortie.
Boolean

Valeur renvoyée

NomExplicationType de données
out_raster

Raster agrégé en sortie.

Il s’agit d’une version de résolution réduite du raster en entrée.

Raster

Exemple de code

Premier exemple d’agrégation (fenêtre Python)

Cet exemple regroupe un raster en faisant la moyenne des valeurs avec un facteur de cellule de 3. Vous obtenez un raster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAggreg = Aggregate("highres", 3, "MAXIMUM", "TRUNCATE", "DATA")
outAggreg.save("C:/sapyexamples/output/aggregate.tif")
Deuxième exemple d’agrégation (script autonome)

Cet exemple regroupe un raster en faisant la moyenne des valeurs avec un facteur de cellule de 3. Vous obtenez un raster GRID.

# Name: Aggregate_Ex_02.py
# Description: Generates a reduced resolution version of a raster.
# 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 = "highres"
cellFactor = 3

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

# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")

# Save the output 
outAggreg.save("C:/sapyexamples/output/aggregate02")

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