Dataset de mosaico de balance de color (Administración de datos)

Resumen

Equilibra el color de un dataset de mosaico de modo que las teselas 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.
  • Ninguno de los datasets ráster tiene un mapa de color asociado.

• Las bandas del valor del parámetro Ráster objetivo deben estar en el mismo orden que las bandas del valor del parámetro Dataset de mosaico. 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 se realizan antes de que se lleve a cabo el balance de color.

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

• Los valores de los parámetros Ráster objetivo e Id. de objeto de ráster objetivo se utilizan para guiar el balance de color. El color de los valores de los parámetros Ráster objetivo e Id. de objeto de ráster objetivo no se cambiarán, y sus características de color se utilizarán para equilibrar el color de las otras imágenes del dataset de mosaico. Si bien se mantiene el color del ráster objetivo, la optimización global de todo el dataset de mosaico puede debilitarse, por lo que no es necesario obtener siempre el mejor resultado general de balance de color optimizado.

  • Cuando se utiliza el balance de sobreexposición: el color objetivo que se derivará depende del tipo de superficie de color objetivo elegido. Para color único, se utiliza el valor promedio de la imagen objetivo de referencia. Para cuadrícula de colores, la imagen objetivo de referencia se vuelve a muestrear en una cuadrícula adecuada. Para las superficies de orden polinomial, los coeficientes del polinomio se obtienen mediante ajuste mediante mínimos cuadrados, a partir de la imagen objetivo de referencia.
  • Cuando se utiliza el balance de histograma: el histograma objetivo se obtiene de la imagen objetivo de referencia.
  • Cuando se utiliza el balance de desviación estándar: la desviación estándar objetivo se obtiene de la imagen objetivo de referencia.

• El parámetro Ráster de DEM se activa cuando el parámetro Método de balance se establece en Ajuste global. Se recomienda que el modelo de elevación digital (DEM) sea local en lugar de en línea; de lo contrario, el cómputo tardará más. Cuando se especifica el valor del parámetro Ráster de DEM, se activan los parámetros Factor Z, Desplazamiento Z y Aplicar corrección de geoide, y normalmente se utilizan sus valores predeterminados.

• El parámetro Puntos de solución de entrada se activa cuando el parámetro Método de balance se establece en Ajuste global. Puede utilizar los puntos de solución de la salida de ajuste de bloques para ayudar a estimar las ubicaciones de superposición de imágenes. Esto resulta útil cuando la imagen tiene menos del 50 por ciento de superposición con sus vecinos. Se recomienda no utilizar esta opción para datasets de mosaico con buena superposición, ya que esto aumentará el tiempo de cómputo.

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico	El dataset de mosaico para el que se va a realizar el balance de color.	Mosaic Layer
Método de balance (Opcional)	Especifica el método de balance que se utilizará. Sobreexposición—El valor de cada píxel se cambiará en función de un color objetivo. Con este método, también debe elegir el tipo de superficie de color de destino, que afecta al color objetivo. La sobreexposición tiende a dar el mejor resultado en la mayoría de los casos. Ajuste global—Se determinará un valor de píxel óptimo ajustando globalmente al mínimo la diferencia de color en todas las áreas de superposición. Este método es adecuado para un dataset de mosaico en el que cada imagen tiene una buena superposición entre sí. Histograma—El valor de cada píxel se cambiará según su relación con un histograma objetivo. El histograma de destino puede derivarse de todos los rásteres; también puede especificar un ráster. Este método funciona bien cuando todos los rásteres tienen un histograma similar. Desviación estándar—Cada uno de los valores de píxel se cambiará 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. Este método funciona mejor cuando todos los rásteres tienen distribuciones normales.	String
Tipo de superficie de color (Opcional)	Especifica cómo se determinará el color objetivo de cada píxel. Este parámetro está activo si el parámetro Método de balance se define como Sobreexposición. Color único—Todos los píxeles se modificarán hacia un único punto de color: el valor medio de todos los píxeles. Utilice esta opción cuando haya solo un número pequeño de datasets ráster y unos cuantos tipos diferentes de objetos de suelo. Si hay demasiados datasets ráster o demasiados tipos de superficies de terreno, el color de salida puede volverse borroso. Cuadrícula de color—Los píxeles se modificarán hacia varios colores objetivo, que se distribuyen por todo el dataset de mosaico. Utilice esta opción cuando tenga un gran número de datasets ráster o áreas con un gran número de objetos de suelo diversos. Primer orden—Todos los píxeles se modificarán hacia muchos puntos, que se obtienen del plano inclinado polinómico bidimensional. Esta opción 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. Segundo orden—Todos los píxeles de entrada se modificarán hacia un conjunto de varios puntos, que se obtiene de la superficie parabólica polinómica bidimensional. Esta opción 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. Tercer orden—Todos los píxeles de entrada se modificarán hacia varios puntos, que se obtienen de la superficie cúbica. Esta opción 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.	String
Ráster de destino (Opcional)	El ráster que se 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)	Un ráster que identifica las ubicaciones que se excluirán. Cree una máscara utilizando la herramienta Generar área de exclusión.	Raster Layer
Tipo de extensión (Opcional)	Especifica cómo se extenderá el rango de valores antes del balance de color. Ninguna—Se utilizarán los valores de píxel originales. 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—Los valores se extenderán entre sus valores mínimo y máximo. Desviación estándar—Los valores se extenderán entre el número predeterminado de desviaciones estándar.	String
Gamma (Opcional)	Un valor numérico que ajustará el brillo general de una imagen. Un valor bajo minimizará el contraste entre valores moderados haciendo que parezcan más oscuros. Los valores altos aumentarán el contraste haciendo que parezcan más brillantes.	Double
Campo de bloque (Opcional)	Un campo de la tabla de atributos del dataset de mosaico que se utilizará para identificar los elementos que se considerarán un elemento al realizar algunos cálculos y operaciones.	String
Ráster DEM (Opcional)	Un DEM para ayudar a estimar las ubicaciones superpuestas en el dataset de mosaico. Este parámetro está activo si el parámetro Método de balance se define como Ajuste global.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer
Factor Z (Opcional)	Un factor de conversión que ajusta las unidades de medida de las unidades verticales (o de elevación) cuando estas son diferentes a las unidades de coordenadas (X,Y) horizontales del DEM de la superficie de entrada. Es el número de unidades X,Y de suelo en una superficie de unidades z. Si las unidades verticales son metros, establezca el parámetro en 1. Si las unidades verticales son pies, establezca el parámetro en 0,3048. Si se utilizan otras unidades verticales, utilice este parámetro para escalar las unidades a metros. Este parámetro está activo cuando se especifica el parámetro Ráster de DEM.	Double
Desplazamiento Z (Opcional)	Un valor base que se agregará al valor de elevación en el DEM. Se puede utilizar para desplazar valores de elevación que no comienzan en el nivel del mar. Este parámetro está activo cuando se especifica el parámetro Ráster de DEM.	Double
Aplicar corrección geoide (Opcional)	Especifica si se realizará la corrección del geoide requerida por los coeficientes polinómicos racionales (RPC) que hacen referencia a alturas elipsoidales. La mayoría de los datasets de elevación hacen referencia a alturas ortométricas a nivel del mar, por lo que esta corrección es necesaria en estos casos para convertir a alturas elipsoidales. Este parámetro está activo cuando se especifica el parámetro Ráster de DEM. Desactivada: no se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está expresado en alturas elipsoidales. Esta es la opción predeterminada. Activada: se realizará una corrección geoide para convertir alturas ortométricas en alturas elipsoidales (basándose en el geoide EGM96).	Boolean
Puntos de solución de entrada (Opcional)	Los puntos de solución de la salida de ajuste de bloques para ayudar a estimar con precisión las ubicaciones superpuestas. Este parámetro resulta útil cuando la imagen tiene menos del 50 por ciento de superposición con sus vecinos. El uso de este parámetro aumentará el tiempo de cómputo, por lo que, para datasets de mosaico ordinarios con buenas superposiciones, puede dejar este parámetro sin especificar. Este parámetro está activo si el parámetro Método de balance se define como Ajuste global.	Table View
Id. de objeto de ráster objetivo (Opcional)	El Id. de objeto de ráster objetivo que se 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. Este parámetro está activo si el parámetro Método de balance se define como Ajuste global.	Long
Afinar la estimación por correlación (Opcional)	Especifica si la estimación de balance de color para las ubicaciones correspondientes en las áreas superpuestas se refinará mediante la correlación de imágenes. Este parámetro es útil para la corrección exacta de diferencias de color, pero aumentará el tiempo de cómputo. Si tiene un dataset de mosaico compuesto por una gran cantidad de imágenes, desactive este parámetro para reducir el tiempo de cómputo. Este parámetro está activo si el parámetro Método de balance se define como Ajuste global. Sin activar: no se refinará la estimación. Activado: se refinará la estimación del balance de color. Esta es la opción predeterminada.	Boolean
Reducir la influencia de las sombras (Opcional)	Especifica si se reducirá la influencia negativa de las sombras en la salida del balance de color. Este parámetro está activo si el parámetro Método de balance se define como Ajuste global. Desactivado: la influencia de las sombras no se reducirá. Esta es la opción predeterminada. Activado: se reducirá la influencia de las sombras. Utilice esta opción cuando el dataset de mosaico tenga muchas sombras.	Boolean
Reducir la influencia de las nubes (Opcional)	Especifica si se reducirá la influencia negativa de las nubes en la salida del balance de color. Este parámetro está activo si el parámetro Método de balance se define como Sobreexposición o Ajuste global. Desactivado: la influencia de las nubes no se reducirá. Esta es la opción predeterminada. Activado: se reducirá la influencia de las nubes.	Boolean

Salida derivada

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

Python

arcpy.management.ColorBalanceMosaicDataset(in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field}, {in_DEM_raster}, {ZFactor}, {ZOffset}, {Geoid}, {solution_points}, {target_objectid}, {refine_estimation}, {reduce_shadow}, {reduce_cloud})

Nombre	Explicación	Tipo de datos
in_mosaic_dataset	El dataset de mosaico para el que se va a realizar el balance de color.	Mosaic Layer
balancing_method (Opcional)	Especifica el método de balance que se utilizará. DODGING—El valor de cada píxel se cambiará en función de un color objetivo. Con este método, también debe elegir el tipo de superficie de color de destino, que afecta al color objetivo. La sobreexposición tiende a dar el mejor resultado en la mayoría de los casos. GLOBAL_FIT—Se determinará un valor de píxel óptimo ajustando globalmente al mínimo la diferencia de color en todas las áreas de superposición. Este método es adecuado para un dataset de mosaico en el que cada imagen tiene una buena superposición entre sí. HISTOGRAM—El valor de cada píxel se cambiará según su relación con un histograma objetivo. El histograma de destino puede derivarse de todos los rásteres; también puede especificar un ráster. Este método funciona bien cuando todos los rásteres tienen un histograma similar. STANDARD_DEVIATION—Cada uno de los valores de píxel se cambiará 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. Este método funciona mejor cuando todos los rásteres tienen distribuciones normales.	String
color_surface_type (Opcional)	Especifica cómo se determinará el color objetivo de cada píxel. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor DODGING. SINGLE_COLOR—Todos los píxeles se modificarán hacia un único punto de color: el valor medio de todos los píxeles. Utilice esta opción cuando haya solo un número pequeño de datasets ráster y unos cuantos tipos diferentes de objetos de suelo. Si hay demasiados datasets ráster o demasiados tipos de superficies de terreno, el color de salida puede volverse borroso. COLOR_GRID—Los píxeles se modificarán hacia varios colores objetivo, que se distribuyen por todo el dataset de mosaico. Utilice esta opción cuando tenga un gran número de datasets ráster o áreas con un gran número de objetos de suelo diversos. FIRST_ORDER—Todos los píxeles se modificarán hacia muchos puntos, que se obtienen del plano inclinado polinómico bidimensional. Esta opción 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. SECOND_ORDER—Todos los píxeles de entrada se modificarán hacia un conjunto de varios puntos, que se obtiene de la superficie parabólica polinómica bidimensional. Esta opción 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. THIRD_ORDER—Todos los píxeles de entrada se modificarán hacia varios puntos, que se obtienen de la superficie cúbica. Esta opción 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.	String
target_raster (Opcional)	El ráster que se 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)	Un ráster que identifica las ubicaciones que se excluirán. Cree una máscara utilizando la herramienta Generar área de exclusión.	Raster Layer
stretch_type (Opcional)	Especifica cómo se extenderá el rango de valores antes del balance de color. NONE—Se utilizarán los valores de píxel originales. Esta es la opción predeterminada. ADAPTIVE—Se aplicará una preextensión adaptable antes de que se lleve a cabo cualquier proceso. MINIMUM_MAXIMUM—Los valores se extenderán entre sus valores mínimo y máximo. STANDARD_DEVIATION—Los valores se extenderán entre el número predeterminado de desviaciones estándar.	String
gamma (Opcional)	Un valor numérico que ajustará el brillo general de una imagen. Un valor bajo minimizará el contraste entre valores moderados haciendo que parezcan más oscuros. Los valores altos aumentarán el contraste haciendo que parezcan más brillantes.	Double
block_field (Opcional)	Un campo de la tabla de atributos del dataset de mosaico que se utilizará para identificar los elementos que se considerarán un elemento al realizar algunos cálculos y operaciones.	String
in_DEM_raster (Opcional)	Un DEM para ayudar a estimar las ubicaciones superpuestas en el dataset de mosaico. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor GLOBAL_FIT.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer
ZFactor (Opcional)	Un factor de conversión que ajusta las unidades de medida de las unidades verticales (o de elevación) cuando estas son diferentes a las unidades de coordenadas (X,Y) horizontales del DEM de la superficie de entrada. Es el número de unidades X,Y de suelo en una superficie de unidades z. Si las unidades verticales son metros, establezca el parámetro en 1. Si las unidades verticales son pies, establezca el parámetro en 0,3048. Si se utilizan otras unidades verticales, utilice este parámetro para escalar las unidades a metros. Este parámetro se habilita cuando se especifica el parámetro in_DEM_raster.	Double
ZOffset (Opcional)	Un valor base que se agregará al valor de elevación en el DEM. Se puede utilizar para desplazar valores de elevación que no comienzan en el nivel del mar. Este parámetro se habilita cuando se especifica el parámetro in_DEM_raster.	Double
Geoid (Opcional)	Especifica si se realizará la corrección del geoide requerida por los coeficientes polinómicos racionales (RPC) que hacen referencia a alturas elipsoidales. La mayoría de los datasets de elevación hacen referencia a alturas ortométricas a nivel del mar, por lo que esta corrección es necesaria en estos casos para convertir a alturas elipsoidales. Este parámetro está activo cuando se especifica el parámetro in_DEM_raster. NONE—No se realizará ninguna corrección geoide. Utilice esta opción solamente si el DEM ya está expresado en alturas elipsoidales. Esta es la opción predeterminada. GEOID—Se realizará una corrección geoide para convertir alturas ortométricas en alturas elipsoidales (basado en geoide EGM96).	Boolean
solution_points (Opcional)	Los puntos de solución de la salida de ajuste de bloques para ayudar a estimar con precisión las ubicaciones superpuestas. Este parámetro resulta útil cuando la imagen tiene menos del 50 por ciento de superposición con sus vecinos. El uso de este parámetro aumentará el tiempo de cómputo, por lo que, para datasets de mosaico ordinarios con buenas superposiciones, puede dejar este parámetro sin especificar. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor GLOBAL_FIT.	Table View
target_objectid (Opcional)	El Id. de objeto de ráster objetivo que se 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. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor GLOBAL_FIT.	Long
refine_estimation (Opcional)	Especifica si la estimación de balance de color para las ubicaciones correspondientes en las áreas superpuestas se refinará mediante la correlación de imágenes. Este parámetro es útil para la corrección exacta de diferencias de color, pero aumentará el tiempo de cómputo. Si tiene un dataset de mosaico compuesto por una gran cantidad de imágenes, especifique la opción NO_REFINE_ESTIMATION para reducir el tiempo de cómputo. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor GLOBAL_FIT. NO_REFINE_ESTIMATION—No se refinará la estimación. Esta es la opción predeterminada. REFINE_ESTIMATION—Se refinará la estimación del balance de color.	Boolean
reduce_shadow (Opcional)	Especifica si se reducirá la influencia negativa de las sombras en la salida del balance de color. Este parámetro está habilitado cuando el parámetro balancing_method tiene el valor GLOBAL_FIT. NO_REDUCE_SHADOW—La influencia de las sombras no se reducirá. Esta es la opción predeterminada. REDUCE_SHADOW—Se reducirá la influencia de las sombras. Utilice esta opción cuando el dataset de mosaico tenga muchas sombras.	Boolean
reduce_cloud (Opcional)	Especifica si se reducirá la influencia negativa de las nubes en la salida del balance de color. Este parámetro se activa si el parámetro balancing_method está establecido como DODGING o GLOBAL_FIT. NO_REDUCE_CLOUD—La influencia de las nubes no se reducirá. Esta es la opción predeterminada. REDUCE_CLOUD—Se reducirá la influencia de las nubes.	Boolean

Salida derivada

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

Muestra de código

Ejemplo 1 de ColorBalanceMosaicDataset (ventana de Python)

Esta es una muestra de Python para la función 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 de script de Python para la función 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)

Ejemplo 3 de ColorBalanceMosaicDataset (ventana de Python)

Esta es una muestra de Python para la función ColorBalanceMosaicDataset.

# Color Correction Mosaic Dataset with block field

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

mdname = "CC.gdb/cc2"
ccmethod = "HISTOGRAM"
dogesurface = "#"
targetras = "#"
excluderas = "#"
prestretch = "NONE"
gamma = "#"
blockfield = "BLOCKNAME"

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

Entornos

Factor de procesamiento en paralelo