Equilibrage des couleurs des mosaïques (Gestion des données)

Récapitulatif

Equilibre les couleurs d'une mosaïque pour que les tuiles soient 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 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	Accédez à la mosaïque dont vous voulez équilibrer les couleurs ou saisissez-la.	Mosaic Layer
balancing_method (Facultatif)	Choisissez l'algorithme d'équilibrage à utiliser. DODGING —Il s'agit de la technique d'éclaircissement photogrammétrique traditionnelle, où chaque valeur de pixel est modifiée en fonction de la couleur cible. Ces valeurs permettent de déterminer la valeur en sortie pour chaque pixel. Si vous sélectionnez Eclaircissement, vous devez également sélectionner le type de surface de couleur cible à utiliser, qui influera sur la nature de la couleur cible. L'équilibrage par éclaircissement donne généralement les meilleurs résultats. HISTOGRAM —Cette technique modifie chaque valeur de pixel en fonction de l'histogramme cible. L'histogramme cible peut être calculé automatiquement à partir de tous les rasters ; un raster cible peut également être spécifié. L'équilibrage des histogrammes est efficace lorsque tous les rasters partagent une même forme d'histogramme. STANDARD_DEVIATION —Cette technique modifie chaque valeur de pixel en fonction du calcul de l'écart type. La valeur d'écart type peut être calculée automatiquement à partir de tous les rasters ou à partir d'un raster cible spécifique. L'équilibrage de l'écart type est efficace lorsque tous les rasters partagent une même distribution de valeurs normalisées d'histogramme.	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. SINGLE_COLOR —Tous les pixels sont éclaircis en fonction d'un point de couleur unique, qui représente une moyenne. Une surface de couleur unique est efficace lorsque le nombre de rasters est réduit et que les différents types d'objets au sol sont peu nombreux. S'il y a trop de rasters ou trop de types de sol, la couleur en sortie peut devenir floue. COLOR_GRID —Tous les pixels en entrée sont éclaircis en fonction de plusieurs ensembles de points, répartis dans toute la mosaïque. La grille de couleurs donne de bons résultats quand il y a un grand nombre de rasters ou des zones présentant un grand nombre d'objets différents au sol. FIRST_ORDER —Tous les pixels en entrée sont éclaircis en fonction d'une multitude de points, obtenus à partir du plan oblique polynomial bidimensionnel. Comparé à une surface de type Grille de couleurs, une surface de type ordre polynomial présente un dégradé des couleurs plus lisse et nécessite moins de place dans la table auxiliaire mais le traitement prend généralement plus de temps. SECOND_ORDER —Tous les pixels en entrée sont éclaircis en fonction de plusieurs ensembles de points, obtenus à partir de la surface parabolique polynomiale bidimensionnelle. Comparé à une surface de type Grille de couleurs, une surface de type ordre polynomial présente un dégradé des couleurs plus lisse et nécessite moins de place dans la table auxiliaire mais le traitement prend généralement plus de temps. THIRD_ORDER —Tous les pixels en entrée sont éclaircis en fonction de plusieurs points, obtenus à partir de la surface cubique. Comparé à une surface de type Grille de couleurs, une surface de type ordre polynomial présente un dégradé des couleurs plus lisse et nécessite moins de place dans la table auxiliaire mais le traitement prend généralement plus de temps.	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.	Internet Tiled Layer; Map Server Layer; Raster Layer
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. NONE — Aucun pré-étirement ne sera appliqué. Il s'agit de l'option par défaut. ADAPTIVE — Un pré-étirement adaptatif sera appliqué avant tout traitement. MINIMUM_MAXIMUM — Un pré-étirement minimum-maximum sera appliqué avant tout traitement. STANDARD_DEVIATION — Un pré-étirement d'écart type sera appliqué avant tout traitement.	String
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
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