Equilibrer les couleurs de la mosaïque (Gestion des données)
Récapitulatif
Equilibre les couleurs d'une mosaïque pour que les tuiles apparaissent transparentes.
Utilisation
-
L'équilibrage des couleurs requiert que vos données respectent les conditions suivantes :
- Les statistiques de tous les canaux ont été calculées.
- Les histogrammes de tous les canaux ont été créés.
- Tous les jeux de données raster ont le même nombre de canaux.
- Tous les jeux de données raster ont les mêmes type de pixel et espace par pixel. Seules les profondeurs de couleur non signées 8 bits et non signées 16 bits sont prises en charge.
- Aucun des jeux de données raster n'a de palette de couleurs associée.
-
Les Options de prétraitement sont effectuées avant que tout équilibrage des couleurs ait lieu.
-
Trois algorithmes d'équilibrage des couleurs sont disponibles : Eclaircissement, Histogramme et Ecart type.
-
La surface de couleur cible est uniquement disponible si la technique d'équilibrage par éclaircissement est sélectionnée. Lorsque vous utilisez la technique d'éclaircissement, chaque pixel doit se voir affecter une couleur cible, qui est sélectionnée dans la surface de couleur cible. Il y a cinq types de surfaces de couleur cible disponibles pour sélection : couleur unique, grille de couleurs, surface de premier ordre, surface de second ordre et surface de troisième ordre.
-
Raster cible vous permet de spécifier la cible pour équilibrer vos rasters.
- Lorsque vous utilisez l'équilibrage par éclaircissement, la couleur cible qui sera dérivée dépend du type de surface de couleur cible sélectionné. Pour le type couleur unique, c'est la valeur moyenne de l'image cible de référence qui est utilisée. Pour le type grille de couleurs, l'image cible de référence est rééchantillonnée en une grille appropriée. Pour les surfaces d'ordre polynomiale, les coefficients polynomiaux sont obtenus via l'algorithme LSF (least square fitting), à partir de l'image cible de référence.
- Lorsque vous utilisez l'équilibrage des histogrammes, l'histogramme cible est obtenu à partir de l'image cible de référence.
- Lorsque vous utilisez l'équilibrage de l'écart type, l'écart type cible est obtenu à partir de l'image cible de référence.
Pour supprimer une correction des couleurs, cliquez avec le bouton droit sur la mosaïque dans ArcCatalog ou la fenêtre Catalogue et cliquez sur Supprimer > Supprimer la correction des couleurs.
Syntaxe
| Paramètre | Explication | Type de données |
in_mosaic_dataset |
Saisissez la mosaïque dont vous voulez équilibrer les couleurs ou accédez-y. | Mosaic Layer; Mosaic Dataset |
balancing_method (Facultatif) |
Choisissez l'algorithme d'équilibrage à utiliser.
| String |
color_surface_type (Facultatif) |
Le Type de couleur de surface cible est disponible uniquement si la technique d'équilibrage par éclaircissement est sélectionnée. Lorsque vous utilisez la technique d'éclaircissement, chaque pixel a besoin d'une couleur cible, qui est déterminée par le type de surface choisi.
| String |
target_raster (Facultatif) |
L'image raster cible vous permet de spécifier le raster cible pour équilibrer vos rasters. Lorsque vous utilisez l'équilibrage par éclaircissement, la couleur cible qui sera dérivée dépend du type de surface de couleur cible sélectionné. Pour Couleur unique, c'est la valeur moyenne de l'image cible de référence qui est utilisée. Pour Grille de couleurs, l'image cible de référence est rééchantillonnée en une grille appropriée. Pour les surfaces d'ordre polynomiale, les coefficients polynomiaux sont obtenus via l'algorithme LSF (least square fitting), à partir de l'image cible de référence. Lorsque vous utilisez Equilibrage des histogrammes, l'histogramme cible est obtenu à partir de l'image cible de référence. Lorsque vous utilisez Equilibrage de l'écart type, l'écart type cible est obtenu à partir de l'image cible de référence. | Raster Layer |
gamma (Facultatif) |
Saisissez la valeur gamma à utiliser dans le pré-traitement d'étirement. Ceci est disponible uniquement si le type de pré-étirement Ecart type ou Minimum-Maximum est choisi. En appliquant l'étirement gamma, vous pouvez contrôler la luminosité globale d'une image. Si le coefficient gamma est trop faible, les demi-teintes apparaissent trop sombres ; cependant, si le coefficient gamma est trop élevé, elles apparaissent trop claires. La valeur gamma modifie non seulement la luminosité, mais également les ratios de rouge, vert et bleu. | Double |
exclude_raster (Facultatif) |
Accédez au raster que vous voulez utiliser comme couche exclue. L'outil Générer une zone exclue permet de créer la zone exclue. La zone exclue est prise en compte avant tout équilibrage des couleurs. | Raster Layer |
stretch_type (Facultatif) |
Le pré-étirement peut être effectué sur chaque éléments de catalogue d'images avant toute autre correction des couleurs. Cela signifie que l'élément du catalogue d'images d'origine utilisera les valeurs de pixel étirées, plutôt que les valeurs de pixel brutes, dans le processus de correction des couleurs. Vous pouvez utiliser cette option pour modifier la couleur en une distribution prévue avant d'appliquer la correction des couleurs.
| String |
Exemple de code
Ceci est un exemple Python pour ColorBalanceMosaicDataset.
import arcpy
ColorBalanceMosaicDataset_management("C:/workspace/fgdb.gdb/mosData","DODGING",\
"COLOR_GRID", "C:/workspace/target.tif",\
"C:/temp/excludeArea.tif","NONE","1", \
"BlockName")
Ceci est un exemple de script Python pour ColorBalanceMosaicDataset.
##===========================
##Color Balance Mosaic Dataset
##Usage: ColorBalanceMosaicDataset_management(in_mosaic_dataset, {DODGING |
## HISTOGRAM | STANDARD_DEVIATION},
## {SINGLE_COLOR | COLOR_GRID |
## FIRST_ORDER | SECOND_ORDER | THIRD_ORDER},
## {target_raster}, {exclude_raster},
## {NONE | STANDARD_DEVIATION | MINIMUM_MAXIMUM
## | ADAPTIVE}, {gamma}), {block_field}
try:
import arcpy
arcpy.env.workspace = "c:/workspace"
# Color Correction Mosaic Dataset with target layer
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"Aerial_photo.lyr", "#", "NONE", "#", "BlockName")
# Color Correction Mosaic Dataset with exclude area dataset and prestretch
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc2", "DODGING", "COLOR_GRID",
"#", "excludearea.tif", "STANDARD_DEVIATION",
"3", "BlockName")
except:
print "Color Balance Mosaic Dataset example failed."
print arcpy.GetMessages()