Agréger (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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 incluses dans l’étendue de cette cellule.

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

Illustration

OutRas = Aggregate(InRas1, 3, Max, Expansion, Données)

Utilisation

• Pour les paramètres Aggregation technique (Méthode d’agrégation) Maximum, Minimum ou Sum (Somme), le type de raster en sortie est identique à celui du raster en entrée. Si le paramètre est Mean (Moyenne) ou Median (Médiane), la sortie sera de type flottant.

• Cet outil est compatible avec les environnements Etendue et Taille de cellule. Pour connaître la résolution du raster en sortie lorsque vous avez défini la taille de cellule d’un entier, multipliez la résolution de la cellule de l’environnement d’analyse par le paramètre du facteur de cellule en entrée. Si la taille de cellule de l’environnement d’analyse représente le minimum ou le maximum des entrées, le raster en sortie est ce que vous obtenez lorsque vous multipliez la résolution du raster en entrée par le facteur de cellule désigné.

• 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster en entrée	Raster en entrée à agréger. Il peut être de type entier ou à virgule flottante.	Raster Layer
Facteur de cellule	Facteur de multiplication de la taille de cellule du raster en entrée. La valeur doit être un entier supérieur à 1. Par exemple, la valeur d’un facteur de cellule de 3 entraîne une taille de cellule en sortie trois fois supérieure à celle du raster en entrée.	Long
Méthode d’agrégation (Facultatif)	Méthode qui sera utilisée pour l’agrégation. Les valeurs des cellules en entrée figurant dans la cellule en sortie la plus grossière sont agrégées selon une des statistiques suivantes : Somme—Le 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. Moyenne—Valeur moyenne des cellules en entrée. Médiane—Valeur médiane des cellules en entrée. Minimum—Valeur la plus faible des cellules en entrée.	String
Expand extent if needed (Augmenter l’étendue si nécessaire) (Facultatif)	Indique si les limites du raster en entrée sont étendues si ses lignes ou colonnes ne sont pas des multiples du facteur de cellule. Activé : les limites en haut ou à droite du raster en entrée sont étendues, afin que le nombre total de cellules d’une ligne ou d’une colonne soit un multiple du facteur de cellule. La valeur NoData est attribuée aux cellules étendues lorsqu’elles sont intégrées au calcul. 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. Désactivé : le nombre de lignes ou de colonnes est réduit dans le raster en sortie. Cette option tronque les cellules restantes sur les limites supérieure ou droite du raster en entrée, ce qui fait du nombre de lignes ou de colonnes du raster en entrée 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 duFacteur de cellule, ces mots-clés ne sont pas utilisés.	Boolean
Ignorer NoData dans les calculs (Facultatif)	Indique si les valeurs NoData sont exclues lors du calcul d’agrégation. Activée : 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 de l’option par défaut. Désactivée : 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 de cette option 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

Étiquette	Explication	Type de données
Raster en sortie	Raster agrégé en sortie. Il s’agit d’une version de résolution réduite du raster en entrée.	Raster

Python

Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})

Nom	Explication	Type 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 de multiplication de la taille de cellule du raster en entrée. La valeur doit être un entier supérieur à 1. Par exemple, la valeur d’un facteur de cellule de 3 entraîne une taille de cellule en sortie trois fois supérieure à celle du raster en entrée.	Long
aggregation_type (Facultatif)	Méthode qui sera utilisée pour l’agrégation. Les valeurs des cellules en entrée figurant dans la cellule en sortie la plus grossière sont agrégées selon une des statistiques suivantes : SUM—Le 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)	Indique si les limites du raster en entrée sont étendues si ses lignes ou colonnes ne sont pas des multiples du facteur de cellule. EXPAND—Les limites en haut ou à droite du raster en entrée sont étendues, afin que le nombre total de cellules d’une ligne ou d’une colonne soit un multiple du facteur de cellule. La valeur NoData est attribuée aux cellules étendues lorsqu’elles sont intégrées au calcul.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. TRUNCATE—Le nombre de lignes ou de colonnes est réduit de 1 dans le raster en sortie. Cette option tronque les cellules restantes sur les limites supérieure ou droite du raster en entrée, ce qui fait du nombre de lignes ou de colonnes du raster en entrée 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 du cell_factor, ces mots-clés ne sont pas utilisé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 de l’option 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 de cette option 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

Nom	Explication	Type 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

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

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

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Facteur de traitement parallèle, Espace de travail temporaire, Raster de capture, Taille de tuile