Réduire (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Réduit la taille des zones sélectionnées selon un nombre de cellules défini, en remplaçant leur valeur par celle de la cellule la plus fréquente dans leur voisinage.

Pour en savoir plus sur l'outil Réduire

Illustration

OutRas = Shrink(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. Avec cet outil, les cellules des zones de premier plan peuvent être remplacées par les cellules des zones d'arrière-plan.

• Lorsque deux régions adjacentes font partie de l'ensemble sélectionné pour contraction, leur limite n'est pas modifiée.

• Les valeurs NoData ont la même priorité que toute autre valeur valide pour occuper les zones libérées par les valeurs sélectionnées pour la réduction. Par conséquent, si une valeur sélectionnée est adjacente à une valeur NoData, elle peut prendre la valeur NoData après contraction.

• 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 pour lequel les zones identifiées seront réduites. Il doit être de type entier.	Raster Layer
Nombre de cellules	Nombre de cellules à utiliser pour réduire chaque zone spécifiée. La valeur doit être un entier supérieur à 0.	Long
Valeurs de zone	Liste des valeurs de zone à contracter. Les valeurs de zone doivent être des entiers. Elles peuvent être dans un ordre quelconque.	Long
Méthode de réduction (Facultatif)	Méthode utilisée pour réduire 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). Morphologique—Utilise une méthode de morphologie mathématique pour réduire les zones. Il s’agit de l’option par défaut. Distance—Utilise une méthode basée sur la distance pour réduire les zones.	String

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster généralisé en sortie. Les zones spécifiées du raster en entrée seront contractées en fonction du nombre spécifié de cellules. La sortie est toujours de type entier.	Raster

Python

Shrink(in_raster, number_cells, zone_values, {shrink_method})

Nom	Explication	Type de données
in_raster	Raster en entrée pour lequel les zones identifiées seront réduites. Il doit être de type entier.	Raster Layer
number_cells	Nombre de cellules à utiliser pour réduire chaque zone spécifiée. La valeur doit être un entier supérieur à 0.	Long
zone_values [zone_value,...]	Liste des valeurs de zone à contracter. Les valeurs de zone doivent être des entiers. Elles peuvent être dans un ordre quelconque.	Long
shrink_method (Facultatif)	Méthode utilisée pour réduire les zones sélectionnées. MORPHOLOGICAL—Utilise une méthode de morphologie mathématique pour réduire les zones. Il s’agit de l’option par défaut. DISTANCE—Utilise une méthode basée sur la distance pour réduire les zones. L’option DISTANCE prend en charge la parallélisation, et peut être contrôlée avec le paramètre d’environnement parallelProcessingFactor.	String

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 contractées en fonction du nombre spécifié de cellules. La sortie est toujours de type entier.	Raster

Exemple de code

Exemple 1 d'utilisation de l'outil Shrink (fenêtre Python)

Cet exemple réduit 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"
outShrink = Shrink("land", 2, [1, 3, 7])
outShrink.save("c:/sapyexamples/output/shrinkout")

Exemple 2 d'utilisation de l'outil Shrink (script autonome)

Cet exemple réduit la zone spécifiée en fonction d'une liste de valeurs (deux cellules).

# Name: Shrink_Ex_02.py
# Description: Shrinks the selected zones 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 = "land"
cellRemove = 2
zoneSet = [1,3,7,9]

# Execute Shrink
outShrink = Shrink(inRaster, cellRemove, zoneSet)

# Save the output 
outShrink.save("c:/sapyexamples/output/outshrink")

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

Cas particuliers

Informations de licence

• Basic: Nécessite Spatial Analyst
• Standard: Nécessite Spatial Analyst
• Advanced: Nécessite Spatial Analyst