Dataset de mosaico de balance de color (Administración de datos)—ArcGIS Pro

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.
- 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 bandas de Ráster de destino tienen que estar en el mismo orden que las bandas del dataset de mosaico de entrada. En condiciones ideales, el número de bandas debe ser el mismo. Si hay más bandas en el dataset de mosaico de entrada, las bandas del ráster de destino se usarán de nuevo secuencialmente.
Si la profundidad de bit del dataset de mosaico de entrada difiere de la del ráster de destino, los valores de píxeles se ajustarán automáticamente para que los dos tengan la misma profundidad de bit.
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 categoría del parámetro 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 panel Catálogo y haga clic en Quitar > Quitar balance de color.

Parámetros

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico	Dataset de mosaico al que desea aplicar el balance de color.	Mosaic Layer
Método de balance (Opcional)	Al algoritmo de balance que se va a utilizar. Sobreexposición—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. Histograma—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. Desviación estándar—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 se puede calcular a partir de todos los rásteres del dataset de mosaico; también puede especificar un ráster de destino. Esta técnica funciona mejor cuando todos los rásteres tienen distribuciones normales.	String
Tipo de superficie de color (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. Color único—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 de todos los píxeles. Cuadrícula de color— 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. Primer orden— 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. Segundo orden— 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. Tercer orden— 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
Ráster de destino (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.	Raster Dataset; Raster Layer; Internet Tiled Layer; Map Server Layer
Excluir ráster de área (Opcional)	Aplique 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
Tipo de extensión (Opcional)	Extienda el rango de valores antes de realizar el balance de color. Elija una de las opciones siguientes: Ninguna— Utilizar los valores originales de los píxeles. Esta es la opción predeterminada. Adaptable— Se aplicará una preextensión adaptable antes de que se lleve a cabo cualquier proceso. Mínimo Máximo— Extender los valores entre sus valores mínimos y máximos reales. Desviación estándar— 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
Campo de bloque (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

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico actualizado	El dataset de mosaico actualizado.	Capa de mosaico

arcpy.management.ColorBalanceMosaicDataset(in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})

Nombre	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 se puede calcular a partir de todos los rásteres del dataset de mosaico; también puede especificar un ráster de destino. 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 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.	Raster Dataset; Raster Layer; Internet Tiled Layer; Map Server Layer
exclude_raster (Opcional)	Aplique 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

Salida derivada

Nombre	Explicación	Tipo de datos
out_mosaic_dataset	El dataset de mosaico actualizado.	Capa de mosaico

Muestra de código

Ejemplo 1 de ColorBalanceMosaicDataset (ventana de Python)

Esta es una muestra de Python para la herramienta 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 (script independiente)

Esta es una muestra del script de Python para la herramienta 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)