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

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 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. 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.	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 : 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

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

Facteur de traitement parallèle

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui