Dataset de mosaico de balance de color

Resumen

Hace que las transiciones de una imagen a una imagen adyacente aparezcan sin interrupciones.

Uso

• El balance de color sólo puede llevarse a cabo si sus datos cumplen las siguientes condiciones:

  • Se han calculado las estadísticas de todas las bandas.
  • Se han generado los histogramas de todas las bandas.
  • Todos los datasets ráster tienen el mismo número de bandas.
  • Todos los datasets ráster tienen el mismo tipo de píxel y profundidad de píxel. Sólo se admiten las profundidades de bits de 8 bits sin signo y de 16 bits sin signo.
  • Ninguno de los datasets ráster tiene un mapa de color asociado.

• Las acciones definidas por los parámetros Excluir ráster de área, Tipo de extensión y Gamma parameters (exclude_raster, stretch_type y gamma en Python) se realizan antes de que se lleve a cabo el balance de color. En el cuadro de diálogo de la herramienta, estos tres parámetros se encuentran en la pestaña Opciones de preprocesamiento.

• La superficie de color de destino solo está disponible si se elige la técnica de balance de sobreexposición. Al utilizar la técnica de balance de sobreexposición, cada píxel necesita un color de destino, que se toma de la superficie de color de destino. Existen cinco tipos de superficies de color de destino entre las cuales puede elegir: color único, cuadrícula de color, superficie de primer orden, superficie de segundo orden y superficie de tercer orden.

• El Ráster de destino es un ráster que se utiliza para guiar el balance de color.

  • Al utilizar balance de sobreexposición, el color de destino que se derive dependerá del tipo de superficie de color de destino elegido. Para el color único, se utiliza el valor medio de la imagen de destino de referencia. Para la cuadrícula de color, se toma de nuevo una muestra de la imagen de destino de referencia con una cuadrícula adecuada. En el caso de las superficies de orden de polinomio, los coeficientes del polinomio se obtienen mediante un ajuste por cuadrados mínimos, a partir de la imagen de destino de referencia.
  • Al utilizar un balance de histograma, el histograma de destino se obtiene a partir de la imagen de destino de referencia.
  • Al utilizar un balance de desviación estándar, la desviación estándar de destino se obtiene a partir de la imagen de destino de referencia.

• Para quitar una corrección de color, haga clic con el botón derecho del ratón en el dataset de mosaico en ArcCatalog o en la ventana Catálogo y haga clic en Quitar > Quitar equilibrado de color.

Sintaxis

ColorBalanceMosaicDataset_management (in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})

Parámetro	Explicación	Tipo de datos
in_mosaic_dataset	Dataset de mosaico al que desea aplicar el balance de color.	Mosaic Layer
balancing_method (Opcional)	Al algoritmo de balance que se va a utilizar. DODGING —Cambie el valor de cada píxel hacia el color de destino. Con esta técnica, también debe elegir el tipo de superficie de color de destino, que afecta al color de destino. La sobreexposición tiende a dar el mejor resultado en la mayoría de los casos. HISTOGRAM —Cambie el valor de cada píxel según su relación con el histograma de destino. El histograma de destino puede derivarse de todos los rásteres; también puede especificar un ráster. Esta técnica funciona bien cuando todos los rásteres tienen un histograma similar. STANDARD_DEVIATION —Cambie los valores de cada uno de los píxeles según su relación con el histograma del ráster objetivo, dentro de una desviación estándar. La desviación estándar puede calcularse a partir de todos los rásteres del dataset de mosaico; también puede especificar un ráster objetivo. Esta técnica funciona mejor cuando todos los rásteres tienen distribuciones normales.	String
color_surface_type (Opcional)	Cuando utiliza el método de balance Sobreexposición, cada píxel necesita un color objetivo, que se determina mediante el tipo de superficie. SINGLE_COLOR —Utilícelo cuando haya solo un número pequeño de datasets ráster y unos cuantos tipos diferentes de objetos de terreno. Si hay demasiados datasets ráster o demasiados tipos de superficies de terreno, el color de salida puede volverse borroso. Todos los píxeles se modifican hacia un único punto de color: el valor medio (promedio) de todos los píxeles. COLOR_GRID — Utilícelo cuando tenga un gran número de datasets ráster o áreas con un gran número de objetos de terreno diversos. Los píxeles se modifican hacia varios colores objetivo, que se distribuyen por todo el dataset de mosaico. FIRST_ORDER — Esta técnica tiende a crear un cambio de color más suave y utiliza menos almacenamiento en la tabla auxiliar, pero tarda más tiempo en procesarse en comparación con la superficie de cuadrícula de color. Todos los píxeles se modifican hacia muchos puntos, que se obtienen del plano inclinado polinómico bidimensional. SECOND_ORDER — Esta técnica tiende a crear un cambio de color más suave y utiliza menos almacenamiento en la tabla auxiliar, pero tarda más tiempo en procesarse en comparación con la superficie de cuadrícula de color. Todos los píxeles de entrada se modifican hacia un conjunto de varios puntos, que se obtiene de la superficie parabólica polinómica bidimensional. THIRD_ORDER — Esta técnica tiende a crear un cambio de color más suave y utiliza menos almacenamiento en la tabla auxiliar, pero tarda más tiempo en procesarse en comparación con la superficie de cuadrícula de color. Todos los píxeles de entrada se modifican hacia varios puntos, que se obtienen de la superficie cúbica.	String
target_raster (Opcional)	Ráster que desea utilizar para realizar el balance de color en las otras imágenes. El método de balance y el tipo de superficie de color, si procede, se derivará de esta imagen.	Internet Tiled Layer; Map Server Layer; Raster Layer
exclude_raster (Opcional)	Aplica una máscara antes de realizar el balance de color en el dataset de mosaico. Cree la máscara utilizando la herramienta Generar área de exclusión.	Raster Layer
stretch_type (Opcional)	Extienda el rango de valores antes de realizar el balance de color. Elija una de las opciones siguientes: NONE — Utilizar los valores originales de los píxeles. Esta es la opción predeterminada. ADAPTIVE — Se aplicará una preextensión adaptable antes de que se lleve a cabo cualquier proceso. MINIMUM_MAXIMUM — Extender los valores entre sus valores mínimos y máximos reales. STANDARD_DEVIATION — Extender los valores entre el número predeterminado de desviaciones estándar.	String
gamma (Opcional)	Ajuste el brillo general de una imagen. Un valor bajo minimizará el contraste entre valores moderados haciendo que parezcan más oscuros. Los valores altos aumentan el contraste haciendo que parezcan más brillantes.	Double
block_field (Opcional)	El nombre del campo en una tabla de atributos del dataset de mosaico que se utiliza para identificar los elementos que deberían considerarse un elemento al realizar algunos cálculos y operaciones.	String

Muestra de código

Ejemplo 1 de ColorBalanceMosaicDataset (ventana de Python)

Esta es una muestra de Python para ColorBalanceMosaicDataset.

import arcpy
arcpy.ColorBalanceMosaicDataset_management(
     "C:/workspace/CC.gdb/cc1", "DODGING", "SINGLE_COLOR", 
     "C:/workspace/Aerial.lyr",  "#", "STANDARD_DEVIATION", "3", "BLOCKNAME")

Ejemplo 2 de ColorBalanceMosaicDataset (secuencia de comandos independiente)

Esta es una muestra de secuencia de comandos de Python para ColorBalanceMosaicDataset.

#########*#########*##########*#########*#########*#########*#########*&&&&&&&&&&

# Color Correction Mosaic Dataset with target layer

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

mdname = "CC.gdb/cc1"
ccmethod = "DODGING"
dogesurface = "SINGLE_COLOR"
targetras = "C:/workspace/Aerial_photo.lyr"
excluderas = "#"
prestretch = "NONE"
gamma = "#"
blockfield = "#"

arcpy.ColorBalanceMosaicDataset_management(
     mdname, ccmethod, dogesurface, targetras, excluderas,
     prestretch, gamma, blockfield)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento

Información sobre licencias

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