Agréger (Spatial Analyst)
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
 |
OutRas = Aggregate(InRas1, 3, Max, Expansion, Données) |
Utilisation
-
Si les valeurs du raster en entrée sont un entier et que vous utilisez une option de type statistique autre que Moyenne, le raster en sortie est un entier. Si les valeurs du raster en entrée sont à virgule flottante ou que utilisez le type de statistiques Moyenne, le raster en sortie sera à virgule flottante.
-
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é.
Syntaxe
| Paramètre | 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 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 :
| 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.
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.
| 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
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")
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")