Résumé
Rend invisibles les transitions d'une image à une image contiguë.
Utilisation
L'équilibrage des couleurs requiert que vos données respectent les conditions suivantes :
- Les statistiques de tous les canaux ont été calculées.
- L'histogramme de tous les canaux a été créé.
- 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 canaux du raster cible doivent être dans le même ordre que les canaux de la mosaïque en entrée. Dans l'idéal, le nombre de canaux doit être identique. Si la mosaïque comporte plus de canaux, ceux du raster cible seront réutilisés, séquentiellement.
Si la profondeur des couleurs de la mosaïque en entrée est différente de celle du raster cible, les valeurs de pixel sont automatiquement ajustées afin d'adopter la même profondeur des couleurs.
Les actions définies par les paramètresExclure un raster de surface, Type d'étirement et Gamma (exclude_raster, stretch_type et gamma dans Python) sont réalisées avant tout équilibrage des couleurs. Dans la boîte de dialogue de l'outil, ces trois paramètres se trouvent dans la catégorie des paramètres Options de prétraitement.
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.
Le raster cible permet de guider l'équilibrage des couleurs.
- 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 de la souris sur la mosaïque dans ArcCatalog ou la fenêtre Catalogue, puis sélectionnez Supprimer > Supprimer l'équilibrage des couleurs.
Syntaxe
arcpy.management.ColorBalanceMosaicDataset(in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})
Paramètre | Explication | Type de données |
in_mosaic_dataset | Mosaïque dont vous voulez équilibrer les couleurs. | Mosaic Layer |
balancing_method (Facultatif) | Algorithme d'équilibrage à utiliser.
| String |
color_surface_type (Facultatif) | Lorsque vous utilisez la méthode d'équilibrage Eclaircissement, chaque pixel a besoin d'une couleur cible, qui est déterminée par le type de surface.
| String |
target_raster (Facultatif) | Raster que vous voulez utiliser pour équilibrer les couleurs des autres images. La méthode d'équilibrage et le type de surface de couleur, le cas échéant, découleront de cette image. | Raster Dataset; Raster Layer; Internet Tiled Layer; Map Server Layer |
exclude_raster (Facultatif) | Appliquez un masque avant d'équilibrer les couleurs de la mosaïque. Créez le masque à l'aide de l'outil Générer une zone d'exclusion. | Raster Layer |
stretch_type (Facultatif) | Etirer la plage de valeurs avant l'équilibrage des couleurs. Choisissez l'une des options suivantes :
| String |
gamma (Facultatif) | Ajuste la luminosité globale d'une image. Une valeur faible réduit le contraste entre les valeurs modérées en les assombrissant. Des valeurs élevées augmentent le contraste en les éclaircissant. | Double |
block_field (Facultatif) | Nom du champ dans une table attributaire de mosaïques utilisé pour identifier les éléments à prendre en compte lors des calculs et des opérations. | String |
Sortie dérivée
Nom | Explication | Type de données |
out_mosaic_dataset | Jeu de données mosaïque mis à jour. | Couche de mosaïque |
Exemple de code
Exemple 1 d'utilisation de l'outil ColorBalanceMosaicDataset (fenêtre Python)
Il s’agit d'un exemple Python d'utilisation de l'outil ColorBalanceMosaicDataset.
import arcpy
arcpy.ColorBalanceMosaicDataset_management(
"C:/workspace/CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"C:/workspace/Aerial.lyr", "#", "STANDARD_DEVIATION", "3", "BLOCKNAME")
Exemple 2 d'utilisation de l'outil ColorBalanceMosaicDataset (script autonome)
Il s’agit d'un exemple de script Python d'utilisation de l'outil 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)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui