Disponible avec une licence Spatial Analyst.
Récapitulatif
Etend d’un nombre défini de cellules les zones spécifiées d’un raster.
Illustration
Utilisation
Les valeurs de zone spécifiées sont considérées comme des zones de premier plan, tandis que les valeurs de zone restantes sont considérées comme des zones d'arrière-plan. Cet outil permet de développer les zones de premier plan dans les zones en arrière-plan.
Lorsque deux zones de premier plan sont en compétition pour occuper la même zone d'arrière-plan, le conflit est résolu sur la base de la valeur de majorité des cellules voisines.
Les cellules NoData étant toujours traitées comme des cellules d'arrière-plan, les cellules de voisinage ayant n'importe quelle valeur peuvent s'étendre jusqu'aux cellules NoData. Par contre, les cellules de valeur NoData n'occupent jamais leurs voisines.
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.
Syntaxe
Expand (in_raster, number_cells, zone_values)
Paramètre | Explication | Type de données |
in_raster | Raster en entrée pour lequel les zones identifiées seront développées Il doit être de type entier. | Raster Layer |
number_cells | Nombre de cellules à développer pour chaque zone désignée. La valeur doit être un entier supérieur à 1. | Long |
zone_values [zone_value,...] | Liste des valeurs de zone à développer. Les valeurs de zone doivent être des entiers. Elles peuvent être dans un ordre quelconque. | Long |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster | Raster généralisé en sortie. Les zones spécifiées du raster en entrée seront développées en fonction du nombre spécifié de cellules. La sortie est toujours de type entier. | Raster |
Exemple de code
Premier exemple d'utilisation de l'outil Expansion (fenêtre Python)
Cet exemple décrit l'expansion de la zone spécifiée en fonction d'une liste de valeurs (deux cellules).
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExpand = Expand("filter", 2, [0, 6, -3])
outExpand.save("C:/sapyexamples/output/outexpand.img")
Deuxième exemple d'utilisation de l'outil Expansion (script autonome)
Cet exemple décrit l'expansion de la zone spécifiée en fonction d'une liste de valeurs (deux cellules).
# Name: Expand_Ex_02.py
# Description: Expands specified zones of a raster
# by a specified number of cells.
# 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 = "filter"
numberCells = 2
zoneValues = [0, 6, -3]
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Expand
outExpand = Expand(inRaster, numberCells, zoneValues)
# Save the output
outExpand.save("C:/sapyexamples/output/outexpand")
Environnements
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