Generar área de exclusión (Administración de datos)

Resumen

Enmascara los píxeles en función de su color o recortando un rango de valores. La salida de esta herramienta se utiliza como entrada en la herramienta Dataset de mosaico de balance de color para áreas tales como nubes y agua que pueden sesgar las estadísticas utilizadas para el balance de color de imágenes múltiples.

Uso

  • Esta herramienta se utiliza para excluir áreas en la cuales será difícil corregir el color, como el agua, las nubes y las áreas anómalas.

  • La salida de esta herramienta se puede utilizar en la herramienta Dataset de mosaico de balance de color para excluir píxeles (y colores) del algoritmo utilizado para colorear correctamente el dataset de mosaico.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

Capa de dataset de mosaico o ráster que desea enmascarar.

Mosaic Dataset; Raster Dataset; Raster Layer
Dataset ráster de salida

Nombre, ubicación y formato para el dataset que está creando. Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Cuando almacena el dataset ráster en un archivo JPEG, un archivo JPEG 2000 o una geodatabase, puede especificar un tipo de Compresión y la Calidad de compresión en Configuración del entorno.

Raster Dataset
Tipo de Píxel

Elija la profundidad de píxel de su dataset ráster de entrada. El valor predeterminado es 8 bits; no obstante, los datasets ráster con una mayor profundidad de bits necesitarán escalar la máscara de color y los valores de histograma de manera acorde.

  • 8_BITEl dataset ráster de entrada tiene valores de 0 a 255. Esta es la opción predeterminada.
  • 11_BITEl dataset ráster de entrada tiene valores de 0 a 2047.
  • 12_BITEl dataset ráster de entrada tiene valores de 0 a 4095.
  • 16_BITEl dataset ráster de entrada tiene valores de 0 a 65535.
String
Generar método

Cree su máscara en función del color de los píxeles o recortando los valores altos y bajos.

  • COLOR_MASKEstablezca los valores máximos de color para incluir en la salida. Esta es la opción predeterminada.
  • HISTOGRAM_PERCENTAGEElimine un porcentaje de los valores de píxel altos y bajos.
String
Rojo máximo
(Opcional)

El valor rojo máximo que se excluirá. El valor predeterminado es 255.

Double
Verde máximo
(Opcional)

El valor verde máximo que se excluirá. El valor predeterminado es 255.

Double
Azul máximo
(Opcional)

El valor azul máximo que se excluirá. El valor predeterminado es 255.

Double
Blanco máximo
(Opcional)

El valor blanco máximo que se excluirá. El valor predeterminado es 255.

Double
Negro máximo
(Opcional)

El valor negro máximo que se excluirá. El valor predeterminado es 0.

Double
Magenta máximo
(Opcional)

El valor magenta máximo que se excluirá. El valor predeterminado es 255.

Double
Cian máximo
(Opcional)

El valor cian máximo que se excluirá. El valor predeterminado es 255.

Double
Amarillo máximo
(Opcional)

El valor amarillo máximo que se excluirá. El valor predeterminado es 255.

Double
Porcentaje bajo
(Opcional)

Excluya este porcentaje de los valores de píxel más bajos. El valor predeterminado es 0.

Double
Porcentaje alto
(Opcional)

Excluya este porcentaje de los valores de píxel más altos. El valor predeterminado es 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})
NombreExplicaciónTipo de datos
in_raster

Capa de dataset de mosaico o ráster que desea enmascarar.

Mosaic Dataset; Raster Dataset; Raster Layer
out_raster

Nombre, ubicación y formato para el dataset que está creando. Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster. Cuando almacena el dataset ráster en un archivo JPEG, un archivo JPEG 2000 o una geodatabase, puede especificar un tipo de Compresión y la Calidad de compresión en Configuración del entorno.

Raster Dataset
pixel_type

Elija la profundidad de píxel de su dataset ráster de entrada. El valor predeterminado es 8 bits; no obstante, los datasets ráster con una mayor profundidad de bits necesitarán escalar la máscara de color y los valores de histograma de manera acorde.

  • 8_BITEl dataset ráster de entrada tiene valores de 0 a 255. Esta es la opción predeterminada.
  • 11_BITEl dataset ráster de entrada tiene valores de 0 a 2047.
  • 12_BITEl dataset ráster de entrada tiene valores de 0 a 4095.
  • 16_BITEl dataset ráster de entrada tiene valores de 0 a 65535.
String
generate_method

Cree su máscara en función del color de los píxeles o recortando los valores altos y bajos.

  • COLOR_MASKEstablezca los valores máximos de color para incluir en la salida. Esta es la opción predeterminada.
  • HISTOGRAM_PERCENTAGEElimine un porcentaje de los valores de píxel altos y bajos.
String
max_red
(Opcional)

El valor rojo máximo que se excluirá. El valor predeterminado es 255.

Double
max_green
(Opcional)

El valor verde máximo que se excluirá. El valor predeterminado es 255.

Double
max_blue
(Opcional)

El valor azul máximo que se excluirá. El valor predeterminado es 255.

Double
max_white
(Opcional)

El valor blanco máximo que se excluirá. El valor predeterminado es 255.

Double
max_black
(Opcional)

El valor negro máximo que se excluirá. El valor predeterminado es 0.

Double
max_magenta
(Opcional)

El valor magenta máximo que se excluirá. El valor predeterminado es 255.

Double
max_cyan
(Opcional)

El valor cian máximo que se excluirá. El valor predeterminado es 255.

Double
max_yellow
(Opcional)

El valor amarillo máximo que se excluirá. El valor predeterminado es 255.

Double
percentage_low
(Opcional)

Excluya este porcentaje de los valores de píxel más bajos. El valor predeterminado es 0.

Double
percentage_high
(Opcional)

Excluya este porcentaje de los valores de píxel más altos. El valor predeterminado es 100.

Double

Muestra de código

Ejemplo 1 de GenerateExcludeArea (ventana de Python)

Esta es una muestra de Python para 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")
Ejemplo 2 de GenerateExcludeArea (script independiente)

Esta es una muestra de script de Python para 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", "", "")