Générer une zone d’exclusion (Outils de gestion des données)

Résumé

Masque les pixels en fonction de leur couleur ou en découpant une plage de valeurs. La sortie de cet outil est utilisée en entrée dans l’outil Color Balance Mosaic Dataset (Équilibrer les couleurs du jeu de données mosaïque) pour éliminer les zones, telles que les nuages et l’eau, qui peuvent fausser les statistiques utilisées pour équilibrer les couleurs de plusieurs images.

Utilisation

Cet outil permet d’exclure les zones pour lesquelles la correction des couleurs est difficile, telles que l’eau, les nuages et les zones anormales.
La sortie de cet outil peut être utilisée dans l’outil Color Balance Mosaic Dataset (Équilibrer les couleurs du jeu de données mosaïque) pour exclure les pixels (et les couleurs) de l’algorithme utilisé pour corriger les couleurs du jeu de données mosaïque.

Etiqueter	Explication	Type de données
Raster en entrée	Couche du jeu de données mosaïque ou raster à masquer.	Mosaic Dataset; Raster Dataset; Raster Layer
Jeu de données raster en sortie	Nom, emplacement et format du jeu de données que vous créez. Pour enregistrer un jeu de données raster dans une géodatabase, n’ajoutez pas d’extension de fichier au nom du jeu de données raster. Lorsque vous stockez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les paramètres d’environnement.	Raster Dataset
Type de pixel	Choisissez l’espace par pixel de votre jeu de données raster en entrée. La valeur par défaut est 8 bits. Toutefois, pour les jeux de données raster avec une plus grande profondeur de bits, les valeurs de masque de couleur et d’histogramme doivent être mises à l’échelle en conséquence. 8 bits—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 255. Il s’agit de l’option par défaut. 11 bits—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 2047. 12 bits—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 4095. 16 bits—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 65535.	String
Méthode de génération	Créez votre masque en fonction de la couleur des pixels ou en découpant les valeurs élevées et faibles. Masque de couleur—Définissez les valeurs de couleur maximales à inclure dans la sortie. Il s’agit de l’option par défaut. Pourcentage d’histogramme—Supprimez un pourcentage de valeurs de pixel élevées et faibles.	String
Rouge maximum (Facultatif)	Valeur rouge maximale à exclure. La valeur par défaut est 255.	Double
Vert maximum (Facultatif)	Valeur verte maximale à exclure. La valeur par défaut est 255.	Double
Bleu maximum (Facultatif)	Valeur bleue maximale à exclure. La valeur par défaut est 255.	Double
Blanc maximum (Facultatif)	Valeur blanche maximale à exclure. La valeur par défaut est 255.	Double
Noir maximum (Facultatif)	Valeur noire maximale à exclure. La valeur par défaut est 0.	Double
Magenta maximum (Facultatif)	Valeur magenta maximale à exclure. La valeur par défaut est 255.	Double
Cyan maximum (Facultatif)	Valeur cyan maximale à exclure. La valeur par défaut est 255.	Double
Jaune maximum (Facultatif)	Valeur jaune maximale à exclure. La valeur par défaut est 255.	Double
Pourcentage faible (Facultatif)	Excluez ce pourcentage des valeurs de pixel les plus faibles. La valeur par défaut est 0.	Double
Pourcentage élevé (Facultatif)	Excluez ce pourcentage des valeurs de pixel les plus élevées. La valeur par défaut est 100.	Double

arcpy.management.GenerateExcludeArea(in_raster, out_raster, pixel_type, generate_method, {max_red}, {max_green}, {max_blue}, {max_white}, {max_black}, {max_magenta}, {max_cyan}, {max_yellow}, {percentage_low}, {percentage_high})

Nom	Explication	Type de données
in_raster	Couche du jeu de données mosaïque ou raster à masquer.	Mosaic Dataset; Raster Dataset; Raster Layer
out_raster	Nom, emplacement et format du jeu de données que vous créez. Pour enregistrer un jeu de données raster dans une géodatabase, n’ajoutez pas d’extension de fichier au nom du jeu de données raster. Lorsque vous stockez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les paramètres d’environnement.	Raster Dataset
pixel_type	Choisissez l’espace par pixel de votre jeu de données raster en entrée. La valeur par défaut est 8 bits. Toutefois, pour les jeux de données raster avec une plus grande profondeur de bits, les valeurs de masque de couleur et d’histogramme doivent être mises à l’échelle en conséquence. `8_BIT`—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 255. Il s’agit de l’option par défaut. `11_BIT`—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 2047. `12_BIT`—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 4095. `16_BIT`—Les valeurs du jeu de données raster en entrée sont comprises entre 0 et 65535.	String
generate_method	Créez votre masque en fonction de la couleur des pixels ou en découpant les valeurs élevées et faibles. `COLOR_MASK`—Définissez les valeurs de couleur maximales à inclure dans la sortie. Il s’agit de l’option par défaut. `HISTOGRAM_PERCENTAGE`—Supprimez un pourcentage de valeurs de pixel élevées et faibles.	String
max_red (Facultatif)	Valeur rouge maximale à exclure. La valeur par défaut est 255.	Double
max_green (Facultatif)	Valeur verte maximale à exclure. La valeur par défaut est 255.	Double
max_blue (Facultatif)	Valeur bleue maximale à exclure. La valeur par défaut est 255.	Double
max_white (Facultatif)	Valeur blanche maximale à exclure. La valeur par défaut est 255.	Double
max_black (Facultatif)	Valeur noire maximale à exclure. La valeur par défaut est 0.	Double
max_magenta (Facultatif)	Valeur magenta maximale à exclure. La valeur par défaut est 255.	Double
max_cyan (Facultatif)	Valeur cyan maximale à exclure. La valeur par défaut est 255.	Double
max_yellow (Facultatif)	Valeur jaune maximale à exclure. La valeur par défaut est 255.	Double
percentage_low (Facultatif)	Excluez ce pourcentage des valeurs de pixel les plus faibles. La valeur par défaut est 0.	Double
percentage_high (Facultatif)	Excluez ce pourcentage des valeurs de pixel les plus élevées. La valeur par défaut est 100.	Double

Exemple de code

Exemple 1 d’utilisation de la fonction GenerateExcludeArea (fenêtre Python)

Il s’agit d’un exemple Python pour GenerateExcludeArea.

import arcpy
arcpy.management.GenerateExcludeArea("C:/workspace/fgdb.gdb/mosdata",
                               "C:/workspace/excludeArea.tif", "8_BIT",
                               "COLOR_MASK", "255", "255", "255", "255", "15",
                               "255", "255", "255", "0", "100")

Exemple 2 d’utilisation de la fonction GenerateExcludeArea (script autonome)

Il s’agit d’un exemple de script Python pour GenerateExcludeArea.

##===========================
##Generate Exclude Area

import arcpy
arcpy.env.workspace = "c:/workspace"

# Generate exclude area dataset from raster dataset with Histogram
arcpy.management.GenerateExcludeArea("srcimage.tif", "exarea.tif", "8_BIT",
                                     "HISTOGRAM_PERCENTAGE", "", "", "", "",
                                     "", "", "", "", "10", "100")

# Generate exclude area dataset from mosaic dataset with Color Mask
arcpy.management.GenerateExcludeArea("CC.gdb/srcmd", "exarea.tif", "8_BIT",
                                     "COLOR_MASK", "255", "200", "50", "255",
                                     "10", "210", "100", "255", "", "")

Environnements

Espace de travail courant, Étendue, Transformations géographiques, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture

Informations de licence