Zusammenfassung
Lässt Übergänge von einem Bild zu einem benachbarten Bild nahtlos erscheinen.
Verwendung
Ein Farbausgleich kann nur erfolgen, wenn die Daten folgende Bedingungen erfüllen:
- Die Statistiken sämtlicher Bänder wurden berechnet.
- Die Histogramme sämtlicher Bänder wurden erstellt.
- Es werden nur die Bittiefen 8-Bit ohne Vorzeichen und 16-Bit ohne Vorzeichen unterstützt.
- Keinem der Raster-Datasets ist eine Colormap zugeordnet.
Die Bänder im Ziel-Raster müssen dieselbe Reihenfolge aufweisen wie die Bänder im Eingabe-Mosaik-Dataset. Im Idealfall sollten alle Bänder identisch sein. Wenn mehrere Bänder im Eingabe-Mosaik-Dataset vorhanden sind, werden die Ziel-Raster sequenziell wiederverwendet.
Wenn die Bit-Tiefe des Eingabe-Mosaik-Datasets und das Ziel-Raster sich unterscheiden, werden die Pixelwerte automatisch skaliert, sodass sie beide dieselbe Bit-Tiefe aufweisen.
Die von den Parametern Raster des Ausschlussbereichs, Streckungstyp und Gamma definierten Aktionen (exclude_raster, stretch_type und gamma in Python) werden ausgeführt, bevor ein Farbausgleich stattfindet. Diese Parameter befinden sich im Dialogfeld des Werkzeugs in der Parameterkategorie Vorverarbeitungsoptionen.
Die Zielfarboberfläche ist nur bei Verwendung des Dodging-Verfahrens verfügbar. Bei Verwendung des Dodging-Verfahrens benötigt jedes Pixel eine Zielfarbe, die aus der Zielfarboberfläche übernommen wird. Es stehen fünf Zieloberflächentypen zur Auswahl: Einzelfarbe, Farbraster sowie Oberfläche erster, zweiter und dritter Ordnung.
Der Farbausgleich erfolgt anhand des Ziel-Rasters.
- Bei Verwendung der Dodging-Methode hängt die Zielfarbe von der ausgewählten Zielfarboberfläche ab. Bei der Option "Einzelfarbe" wird der Durchschnittswert des Referenz-Zielbildes verwendet. Bei der Option "Farbraster" wird ein Resampling des Referenz-Zielbildes zu einem geeigneten Gitter durchgeführt. Bei den Optionen zur Polynomordnung werden die Koeffizienten des Polynoms mit der LSF-Methode (Methode der kleinsten Quadrate) vom Referenz-Zielbild übernommen.
- Beim Histogrammausgleich wird das Zielhistogramm vom Referenz-Zielbild übernommen.
- Beim Standardabweichungsausgleich wird die Zielstandardabweichung vom Referenz-Zielbild übernommen.
Klicken Sie zum Aufheben einer Farbkorrektur mit der rechten Maustaste auf das Mosaik-Dataset im Bereich Katalog, und klicken Sie dann auf Entfernen > Farbausgleich entfernen
Syntax
arcpy.management.ColorBalanceMosaicDataset(in_mosaic_dataset, {balancing_method}, {color_surface_type}, {target_raster}, {exclude_raster}, {stretch_type}, {gamma}, {block_field})
Parameter | Erklärung | Datentyp |
in_mosaic_dataset | Das Mosaik-Dataset, für das der Farbausgleich ausgeführt werden soll. | Mosaic Layer |
balancing_method (optional) | Der zu verwendende Ausgleichalgorithmus.
| String |
color_surface_type (optional) | Bei Verwendung der Ausgleichsmethode Dodging benötigt jedes Pixel eine Zielfarbe, die durch den ausgewählten Oberflächentyp bestimmt wird.
| String |
target_raster (optional) | Das Raster, das Sie für den Farbausgleich der anderen Bilder verwenden möchten. Die Ausgleichsmethode und ggf. der Farboberflächentyp werden aus diesem Bild abgeleitet. | Raster Dataset; Raster Layer; Internet Tiled Layer; Map Server Layer |
exclude_raster (optional) | Wenden Sie vor dem Farbausgleich des Mosaik-Datasets eine Maske an. Erstellen Sie die Maske mit dem Werkzeug Ausschlussfläche erstellen. | Raster Layer |
stretch_type (optional) | Streckt den Wertebereich vor dem Farbausgleich. Wählen Sie eine der folgenden Optionen aus:
| String |
gamma (optional) | Passt die Gesamthelligkeit eines Bildes an. Ein niedriger Wert minimiert den Kontrast zwischen mäßigen Werten, indem sie dunkler erscheinen. Höhere Werte erhöhen den Kontrast, indem sie heller erscheinen. | Double |
block_field (optional) | Der Name des Feldes innerhalb der Attributtabelle eines Mosaik-Datasets zum Identifizieren der Elemente, die bei bestimmten Berechnungen und Operationen als ein Element betrachtet werden sollen. | String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_mosaic_dataset | Das aktualisierte Mosaik-Dataset. | Mosaik-Layer |
Codebeispiel
Dies ist ein Python-Beispiel für das Werkzeug ColorBalanceMosaicDataset.
import arcpy
arcpy.ColorBalanceMosaicDataset_management(
"C:/workspace/CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"C:/workspace/Aerial.lyr", "#", "STANDARD_DEVIATION", "3", "BLOCKNAME")
Dies ist ein Python-Skriptbeispiel für das Werkzeug 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)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja