ArcMap

Générer une zone d'exclusion

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 Equilibrer les couleurs d'une mosaïque afin d'éliminer les zones, telles que les nuages et l'eau, qui peuvent déformer les statistiques utilisées pour équilibrer les couleurs de plusieurs images.

Utilisation

  • Cet outil permet d'exclure des zones dont la correction des couleurs est difficile, telles que l'eau, les nuages et les surfaces anormales.

  • La sortie de cet outil peut être utilisée dans l'outil Equilibrer les couleurs d'une mosaïque pour exclure des pixels (et couleurs) de l'algorithme utilisé pour colorer la mosaïque.

Syntaxe

GenerateExcludeArea_management (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})
ParamètreExplicationType de données
in_raster

Couche de jeu de données raster ou de mosaïque que vous souhaitez masquer.

Mosaic Dataset; Composite Layer; 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 enregistrez un jeu de données raster dans un fichier JPEG ou JPEG 2000, ou dans 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 de 8 bits. Toutefois, il sera nécessaire de mettre à l'échelle correctement les valeurs d'histogramme et le masque de couleur des jeux de données raster dont la profondeur des couleurs est plus importante.

  • 8_BIT —Le jeu de données raster en entrée a des valeurs comprises entre 0 à 255. C'est la valeur par défaut.
  • 11_BIT —Le jeu de données raster en entrée a des valeurs comprises entre 0 à 2047.
  • 12_BIT —Le jeu de données raster en entrée a des valeurs comprises entre 0 à 4095.
  • 16_BIT —Le jeu de données raster en entrée a des valeurs comprises entre 0 à 65535.
String
generate_method

Créez votre masque en fonction de la couleur des pixels ou en découpant des valeurs élevées et faibles.

  • COLOR_MASK —Définissez les valeurs de couleurs maximum à 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 maximum à exclure. La valeur par défaut est 255.

Double
max_green
(Facultatif)

Valeur verte maximum à exclure. La valeur par défaut est 255.

Double
max_blue
(Facultatif)

Valeur bleue maximum à exclure. La valeur par défaut est 255.

Double
max_white
(Facultatif)

Valeur blanche maximum à exclure. La valeur par défaut est 255.

Double
max_black
(Facultatif)

Valeur noire maximum à exclure. La valeur par défaut est 0.

Double
max_magenta
(Facultatif)

Valeur magenta maximum à exclure. La valeur par défaut est 255.

Double
max_cyan
(Facultatif)

Valeur cyan maximum à exclure. La valeur par défaut est 255.

Double
max_yellow
(Facultatif)

Valeur jaune maximum à exclure. La valeur par défaut est 255.

Double
percentage_low
(Facultatif)

Excluez ce pourcentage des plus faibles valeurs de pixel. La valeur par défaut est 0.

Double
percentage_high
(Facultatif)

Excluez ce pourcentage des plus hautes valeurs de pixel. La valeur par défaut est 100.

Double

Exemple de code

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

Il s'agit d'un exemple en Python de l'utilisation de l'outil GenerateExcludeArea.

import arcpy
arcpy.GenerateExcludeArea_management("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 l'outil GenerateExcludeArea (script autonome)

Il s'agit d'un exemple de script en Python de l'utilisation de l'outil GenerateExcludeArea.

##===========================
##Generate Exclude Area
##Usage: GenerateExcludeArea_management in_raster out_raster 8_BIT | 11_BIT | 
##                                      12_BIT | 16_BIT COLOR_MASK | HISTOGRAM_PERCENTAGE
##                                      {max_red} {max_green} {max_blue} {max_white} 
##                                      {max_black} {max_magenta} {max_cyan}
##                                      {max_yellow} {percentage_low} {percentage_high}

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

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

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

Environnements

Informations de licence

  • ArcGIS Desktop Basic: Non
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes