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.

Sintaxis

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})

Parámetro	Explicación	Tipo 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_BIT —El dataset ráster de entrada tiene valores de 0 a 255. Esta es la opción predeterminada. 11_BIT —El dataset ráster de entrada tiene valores de 0 a 2047. 12_BIT —El dataset ráster de entrada tiene valores de 0 a 4095. 16_BIT —El 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_MASK —Establezca los valores máximos de color para incluir en la salida. Esta es la opción predeterminada. HISTOGRAM_PERCENTAGE —Elimine 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", "", "")

Entornos

Espacio de trabajo actual, Extensión, Transformaciones geográficas, Sistema de coordenadas de salida, Espacio de trabajo temporal, Ráster de alineación

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí