Equilibrage des couleurs des mosaïques

Récapitulatif

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.
  • 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 actions définies par les paramètres Exclure 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 l'onglet 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

ColorBalanceMosaicDataset_management (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. DODGING —Modifie chaque valeur de pixel de façon à obtenir une couleur cible. Avec cette technique, vous devez également sélectionner le type de surface de couleur cible qui influe sur la couleur cible. L'éclaircissement donne le meilleur résultat dans la plupart des cas. HISTOGRAM —Modifie chaque valeur de pixel en fonction de sa relation avec un histogramme cible. L'histogramme cible peut découler de tous les rasters. Vous pouvez également spécifier un raster. Cette technique est efficace lorsque tous les rasters partagent un même histogramme. STANDARD_DEVIATION —Modifie chaque valeur de pixel en fonction de sa relation avec l'histogramme du raster cible, au sein d'un écart type. L'écart type peut être calculé à partir de tous les rasters de la mosaïque. Vous pouvez également spécifier un raster cible. Cette technique est optimale lorsque tous les rasters ont des distributions normales.	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. SINGLE_COLOR —A utiliser lorsque le nombre de jeux de données raster est réduit et que les différents types d'objets au sol sont peu nombreux. S'il y a trop de jeux de données raster ou trop de types de sol, la couleur en sortie peut devenir floue. Tous les pixels sont modifiés en fonction d'un point de couleur unique, qui représente la moyenne de tous les pixels. COLOR_GRID — A utiliser lorsque les jeux de données raster sont nombreux ou lorsque des zones présentent un grand nombre d'objets différents au sol. Les pixels sont modifiés en fonction de plusieurs couleurs cibles, qui sont réparties dans toute la mosaïque. FIRST_ORDER — Cette technique génère un dégradé des couleurs plus lisse et utilise un espace de stockage moindre dans la table auxiliaire, mais le traitement peut prendre plus de temps par rapport à la surface de type Grille de couleurs. Tous les pixels sont modifiés en fonction d'une multitude de points, obtenus à partir du plan oblique polynomial bidimensionnel. SECOND_ORDER — Cette technique génère un dégradé des couleurs plus lisse et utilise un espace de stockage moindre dans la table auxiliaire, mais le traitement peut prendre plus de temps par rapport à la surface de type Grille de couleurs. Tous les pixels en entrée sont modifiés en fonction de plusieurs ensembles de points, obtenus à partir de la surface parabolique polynomiale bidimensionnelle. THIRD_ORDER — Cette technique génère un dégradé des couleurs plus lisse et utilise un espace de stockage moindre dans la table auxiliaire, mais le traitement peut prendre plus de temps par rapport à la surface de type Grille de couleurs. Tous les pixels en entrée sont modifiés en fonction de plusieurs points, obtenus à partir de la surface cubique.	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.	Internet Tiled Layer; Map Server Layer; Raster Layer
exclude_raster (Facultatif)	Applique 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 une des options suivantes : NONE — Utilisez les valeurs de pixel d'origine. Il s'agit de l'option par défaut. ADAPTIVE — Un pré-étirement adaptatif sera appliqué avant tout traitement. MINIMUM_MAXIMUM — Etirez les valeurs entre leurs valeurs minimum et maximum réelles. STANDARD_DEVIATION — Etirez les valeurs entre le nombre par défaut d’écarts types.	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

Exemple de code

Exemple 1 d'utilisation de l'outil ColorBalanceMosaicDataset (fenêtre Python)

Ceci est un exemple Python pour 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)

Ceci est un exemple de script Python pour 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

Cet outil n'utilise aucun environnement de géotraitement

Informations de licence

• ArcGIS for Desktop Basic: Annuler
• ArcGIS for Desktop Standard: Oui
• ArcGIS for Desktop Advanced: Oui

Vous avez un commentaire à formuler concernant cette rubrique ?