Farbausgleich-Mosaik-Dataset (Data Management)
Zusammenfassung
Führt einen Farbausgleich für ein Mosaik-Dataset aus, damit die Kacheln nahtlos angezeigt werden.
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.
- Alle Raster-Datasets weisen die gleiche Anzahl von Bändern auf.
- Alle Raster-Datasets weisen denselben Pixeltyp und dieselbe Pixeltiefe auf. Es werden nur die Bit-Tiefen 8-Bit ohne Vorzeichen und 16-Bit ohne Vorzeichen unterstützt.
- Keinem der Raster-Datasets ist eine Colormap zugeordnet.
-
Die Vorverarbeitungsoptionen werden ausgeführt, bevor ein Farbausgleich vorgenommen wird.
-
Es sind drei Ausgleichalgorithmen verfügbar: Dodging, Histogramm und Standardabweichung.
-
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.
-
Mit der Option Ziel-Raster können Sie das Ziel für den Ausgleich der Raster angeben.
- Bei Verwendung von "Dodging-Ausgleich" hängt die Zielfarbe von der ausgewählten Zielfarboberfläche ab. Bei der Option "Einzelfarbe" wird der Durchschnittswert des Referenzzielbildes verwendet. Bei der Option "Farbraster" wird ein Resampling des Referenzzielbildes zu einem geeigneten Gitter durchgeführt. Bei der Option "Polynom-Ordnung" werden die Koeffizienten des Polynoms mit der LSF-Methode (Methode der kleinsten Quadrate) vom Referenzzielbild übernommen.
- Beim Histogrammausgleich wird das Zielhistogramm vom Referenzzielbild übernommen.
- Beim Standardabweichungsausgleich wird die Zielstandardabweichung vom Referenzzielbild übernommen.
Zum Entfernen einer Farbkorrektur klicken Sie mit der rechten Maustaste in ArcCatalog oder in das Fenster "Katalog" auf das Mosaik-Dataset, und klicken Sie auf Entfernen > Farbkorrektur entfernen.
Syntax
| Parameter | Erläuterung | Datentyp |
in_mosaic_dataset |
Geben Sie das Mosaik-Dataset ein, für das Sie einen Farbausgleich durchführen möchten, oder navigieren Sie dorthin. | Mosaic Layer; Mosaic Dataset |
balancing_method (optional) |
Wählen Sie den zu verwendenden Ausgleichalgorithmus aus.
| String |
color_surface_type (optional) |
Der Farboberflächentyp der Zielfarbe ist nur bei Verwendung des Dodging-Verfahrens verfügbar. Bei Verwendung des Dodging-Verfahrens benötigt jedes Pixel eine Zielfarbe, die durch den ausgewählten Oberflächentyp bestimmt wird.
| String |
target_raster (optional) |
Mit dem Ziel-Raster-Bild können Sie das Ziel-Raster für den Ausgleich der Raster angeben. Bei Verwendung von "DODGING" hängt die Zielfarbe vom ausgewählten Oberflächentyp der Zielfarbe ab. Bei der Option "SINGLE_COLOR" wird der Durchschnittswert des Referenz-Zielbildes verwendet. Für "COLOR_GRID" wird ein Resampling des Referenz-Zielbildes zu einem geeigneten Gitter durchgeführt. Für die Optionen zur Polynom-Ordnung 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 Ausgleich mit Standardabweichung wird die Zielstandardabweichung vom Referenz-Zielbild übernommen. | Raster Layer |
gamma (optional) |
Geben Sie den Gammawert ein, der in der Vorverarbeitungsstreckung verwendet werden soll. Er ist nur verfügbar, wenn die Vorstreckung mit Standardabweichung oder mit Minimal-/Maximalwert ausgewählt wird. Über die Gamma-Streckung können Sie die Gesamthelligkeit eines Bildes steuern. Wenn der Gamma-Koeffizient zu niedrig eingestellt wird, erscheinen die mittleren Farbtöne zu dunkel. Wird der Gamma-Koeffizient jedoch zu hoch eingestellt, erscheinen die mittleren Farbtöne zu hell. Durch den Gamma-Wert ändert sich nicht nur die Helligkeit, sondern auch das Verhältnis von Rot zu Grün zu Blau. | Double |
exclude_raster (optional) |
Navigieren Sie zu dem Raster, das Sie als auszuschließenden Layer verwenden möchten. Das Werkzeug Ausschlussfläche erstellen kann zum Erstellen der Ausschlussfläche verwendet werden. Die Ausschlussfläche wird berücksichtigt, bevor ein Farbausgleich vorgenommen wird. | Raster Layer |
stretch_type (optional) |
Eine Vorstreckung kann für jedes Element im Raster-Katalog vor allen anderen Farbkorrekturen ausgeführt werden. Dadurch werden im Farbkorrekturprozess die gestreckten Pixelwerte statt die unbearbeiteten Pixelwerte des ursprünglichen Raster-Katalogelements verwendet. Diese Option ist nützlich, wenn Sie die Farbe vor dem Anwenden der Farbkorrektur in eine erwartete Verteilung ändern möchten.
| String |
Codebeispiel
Dies ist ein Python-Beispiel für "ColorBalanceMosaicDataset".
import arcpy
ColorBalanceMosaicDataset_management("C:/workspace/fgdb.gdb/mosData","DODGING",\
"COLOR_GRID", "C:/workspace/target.tif",\
"C:/temp/excludeArea.tif","NONE","1", \
"BlockName")
Dies ist ein Python-Skriptbeispiel für "ColorBalanceMosaicDataset".
##===========================
##Color Balance Mosaic Dataset
##Usage: ColorBalanceMosaicDataset_management(in_mosaic_dataset, {DODGING |
## HISTOGRAM | STANDARD_DEVIATION},
## {SINGLE_COLOR | COLOR_GRID |
## FIRST_ORDER | SECOND_ORDER | THIRD_ORDER},
## {target_raster}, {exclude_raster},
## {NONE | STANDARD_DEVIATION | MINIMUM_MAXIMUM
## | ADAPTIVE}, {gamma}), {block_field}
try:
import arcpy
arcpy.env.workspace = "c:/workspace"
# Color Correction Mosaic Dataset with target layer
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc1", "DODGING", "SINGLE_COLOR",
"Aerial_photo.lyr", "#", "NONE", "#", "BlockName")
# Color Correction Mosaic Dataset with exclude area dataset and prestretch
arcpy.ColorBalanceMosaicDataset_management("CC.gdb/cc2", "DODGING", "COLOR_GRID",
"#", "excludearea.tif", "STANDARD_DEVIATION",
"3", "BlockName")
except:
print "Color Balance Mosaic Dataset example failed."
print arcpy.GetMessages()