Développer (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Étend d’un nombre défini de cellules les zones spécifiées d’un raster.

Pour en savoir plus sur le fonctionnement de l'outil Développer

Illustration

Illustration de l’outil Développer
OutRas = Expand(InRas1, 1, 5)

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.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée pour lequel les zones identifiées seront développées

Il doit être de type entier.

Raster Layer
Nombre de cellules

Nombre de cellules à développer pour chaque zone désignée.

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

Long
Valeurs de zone

Liste des valeurs de zone à développer.

Les valeurs de zone doivent être des entiers. Elles peuvent être dans un ordre quelconque.

Long
Méthode de développement
(Facultatif)

Méthode utilisée pour développer les zones sélectionnées.

L’option Distance (Distance) prend en charge la parallélisation, et peut être contrôlée avec le paramètre d’environnement Parallel Processing Factor (Facteur de traitement parallèle).

  • MorphologiqueUtilise une méthode de morphologie mathématique pour développer les zones. Il s’agit de l’option par défaut.
  • DistanceUtilise une méthode basée sur la distance pour développer les zones.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

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

Expand(in_raster, number_cells, zone_values, {expand_method})
NomExplicationType 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
expand_method
(Facultatif)

Méthode utilisée pour développer les zones sélectionnées.

  • MORPHOLOGICALUtilise une méthode de morphologie mathématique pour développer les zones. Il s’agit de l’option par défaut.
  • DISTANCEUtilise une méthode basée sur la distance pour développer les zones.

L’option DISTANCE prend en charge la parallélisation. Elle peut être contrôlée avec le paramètre d’environnement parallelProcessingFactor.

String

Valeur renvoyée

NomExplicationType 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]

# Execute Expand
outExpand = Expand(inRaster, numberCells, zoneValues)

# Save the output 
outExpand.save("C:/sapyexamples/output/outexpand")

Rubriques connexes