Générer une zone d’exclusion (Gestion des données)

Synthèse

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 Équilibrer 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 Équilibrer les couleurs de la mosaïque pour exclure des pixels (et couleurs) de l'algorithme utilisé pour colorer la mosaïque.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Couche de jeu de données raster ou de mosaïque que vous souhaitez 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 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
Type de pixel

Sélectionnez l’espace par pixel de votre fichier raster en entrée. La valeur par défaut est de huit bits, mais pour les jeux de données de raster dont la profondeur des couleurs est supérieure, les valeurs de masque de couleur et d’histogramme doivent être proportionnées en conséquence.

  • 8_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 255. Il s’agit de l’option par défaut.
  • 11_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 2047.
  • 12_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 4095.
  • 16_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 65535.
String
Méthode de génération

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

  • COLOR_MASKDéfinissez les valeurs de couleurs maximum à inclure dans la sortie. Il s’agit de l’option par défaut.
  • HISTOGRAM_PERCENTAGESupprimez un pourcentage de valeurs de pixel élevées et faibles.
String
Rouge maximum
(Facultatif)

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

Double
Vert maximum
(Facultatif)

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

Double
Bleu maximum
(Facultatif)

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

Double
Blanc maximum
(Facultatif)

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

Double
Noir maximum
(Facultatif)

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

Double
Magenta maximum
(Facultatif)

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

Double
Cyan maximum
(Facultatif)

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

Double
Jaune maximum
(Facultatif)

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

Double
Pourcentage faible
(Facultatif)

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

Double
Pourcentage élevé
(Facultatif)

Excluez ce pourcentage des plus hautes valeurs de pixel. 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})
NomExplicationType de données
in_raster

Couche de jeu de données raster ou de mosaïque que vous souhaitez 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 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

Sélectionnez l’espace par pixel de votre fichier raster en entrée. La valeur par défaut est de huit bits, mais pour les jeux de données de raster dont la profondeur des couleurs est supérieure, les valeurs de masque de couleur et d’histogramme doivent être proportionnées en conséquence.

  • 8_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 255. Il s’agit de l’option par défaut.
  • 11_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 2047.
  • 12_BITLe jeu de données raster en entrée a des valeurs comprises entre 0 à 4095.
  • 16_BITLe 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_MASKDéfinissez les valeurs de couleurs maximum à inclure dans la sortie. Il s’agit de l’option par défaut.
  • HISTOGRAM_PERCENTAGESupprimez 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 de script Python pour 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)

Ceci est un exemple de script Python pour 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", "", "")

Rubriques connexes