Zusammenfassung
Führt alle Raster-Datasets eines Ordners zu einem Raster-Dataset zusammen.
Verwendung
Dieses Werkzeug kann nur ausgeführt werden, wenn das Ziel-Raster-Dataset bereits vorhanden ist.
Wenn noch kein Ziel-Raster-Dataset vorhanden ist, erstellen Sie mit dem Werkzeug Raster-Dataset erstellen ein neues Raster-Dataset.
Da ein mosaikartiges Einfügen erfolgt, müssen Sie die anzuwendende Mosaik-Methode und den zu verwendenden Colormap-Modus angeben.
Wenn das Ziel-Raster-Dataset leer ist, werden die Zellengröße und der Raumbezug des ersten Eingabe-Raster-Datasets auf das Mosaik angewendet.
Verwenden Sie nach Möglichkeit den Mosaikoperator "LAST", um Raster-Datasets mit einem vorhandenen Raster-Dataset in einer File-Geodatabase oder Enterprise-Geodatabase zu mosaikieren. Dies ist mit Abstand die effizienteste Vorgehensweise.
Beim Erstellen eines Mosaiks aus diskontinuierlichen Daten erzielen Sie mit den Mosaikoperatoren "FIRST", "MIN" oder "MAX" die besten Ergebnisse. Die Mosaikoperatoren "BLEND" und "MEAN" sind optimal für kontinuierliche Daten geeignet.
Über die Dropdown-Liste mit den Optionen für die Farbabgleichmethode können Sie einen Algorithmus wählen, um für die Datasets in Ihrem Mosaik den Farbabgleich durchzuführen.
Für dateibasierte Raster muss Hintergrundwert ignorieren auf denselben Wert wie NoData gesetzt werden, damit der Hintergrundwert ignoriert wird. Geodatabase-Raster funktionieren auch ohne diesen zusätzlichen Schritt.
Bei Gleitkomma-Raster-Datasets mit unterschiedlicher Auflösung oder fehlender Ausrichtung der Zellen wird empfohlen, alle Daten mittels bilinearer Interpolation oder kubischer Faltung neu zu berechnen, bevor Sie das Werkzeug Mosaik ausführen. Andernfalls werden die Raster-Datasets durch das Werkzeug Mosaik unter Verwendung der Resampling-Methode "Nächster Nachbar" erneut berechnet, die für kontinuierliche Datentypen nicht geeignet ist.
Syntax
WorkspaceToRasterDataset(in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod}, {colormap_to_RGB})| Parameter | Erklärung | Datentyp |
in_workspace | Der Ordner mit den Raster-Datasets, die zusammengeführt werden sollen. | Workspace |
in_raster_dataset | Ein vorhandenes Raster-Dataset, in dem alle Raster-Datasets aus dem Eingabe-Workspace zusammengeführt werden sollen. | Raster Dataset |
include_subdirectories (optional) | Geben Sie an, ob Unterverzeichnisse eingeschlossen werden sollen.
| Boolean |
mosaic_type (optional) | Die Verarbeitungsweise für überlappende Flächen im Mosaik.
| String |
colormap (optional) | Die Methoden, mit denen Sie auswählen können, welche Colormap aus den Eingabe-Rastern auf die Mosaikausgabe angewendet wird.
| String |
background_value (optional) | Verwenden Sie diese Option, um unerwünschte Werte zu entfernen, die um die ursprünglichen Raster-Daten erstellt wurden. Der angegebene Wert wird von den anderen wichtigen Daten im Raster-Dataset unterschieden. Beispielsweise wird ein Wert von 0 entlang der Grenzen des Raster-Datasets von den Nullwerten innerhalb des Raster-Datasets unterschieden. Der angegebene Pixelwert wird im Ausgabe-Raster-Dataset auf "NoData" gesetzt. Für dateibasierte Raster und Personal-Geodatabase-Raster muss Hintergrundwert ignorieren auf denselben Wert wie "NoData" gesetzt werden, damit der Hintergrundwert ignoriert wird. Enterprise- und File-Geodatabase-Raster funktionieren auch ohne diesen zusätzlichen Schritt. | Double |
nodata_value (optional) | Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt. | Double |
onebit_to_eightbit (optional) | Wählen Sie aus, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert werden soll. Bei dieser Konvertierung wird der Wert 1 des Eingabe-Raster-Datasets im Ausgabe-Raster-Dataset in 255 geändert. Dies eignet sich besonders für das Importieren von 1-Bit Raster-Datasets in eine Geodatabase. Wenn 1-Bit-Raster-Datasets in einem Dateisystem gespeichert werden, verfügen diese über 8-Bit-Pyramiden-Layer. In einer Geodatabase können 1-Bit-Raster-Datasets jedoch nur über 1-Bit-Pyramiden-Layer verfügen. Dies führt zu einer minderwertigen Anzeigequalität. Indem die Daten in einer Geodatabase in 8 Bit konvertiert werden, werden Pyramiden-Layer nicht mit 1 Bit, sondern mit 8 Bit erstellt. Dadurch wird das Raster-Dataset korrekt angezeigt.
| Boolean |
mosaicking_tolerance (optional) | Beim Mosaikieren stimmen die Ziel- und Ursprungspixel nicht immer hundertprozentig überein. Wenn die Pixel nicht genau aneinander ausgerichtet sind, muss die Entscheidung getroffen werden, ob ein Resampling stattfinden soll oder ob die Daten verschoben werden sollen. Die Mosaiktoleranz bestimmt, ob ein Resampling der Pixel stattfindet oder ob die Pixel verschoben werden. Wenn der Unterschied bei der Pixelausrichtung zwischen dem Eingabe-Dataset und dem Ziel-Dataset größer ist als die Toleranz, wird ein Resampling ausgeführt. Wenn der Unterschied bei der Pixelausrichtung zwischen dem Eingabe-Dataset und dem Ziel-Dataset geringer ist als die Toleranz, wird kein Resampling ausgeführt (stattdessen erfolgt eine Verschiebung). Die Toleranz wird in Pixeln angegeben, wobei der gültige Wertebereich zwischen 0 und 0,5 liegt. Eine Toleranz von 0,5 garantiert, dass ein Versatz stattfindet. Bei einer Toleranz von 0 wird im Falle einer falschen Ausrichtung der Pixel grundsätzlich ein Resampling durchgeführt. Die Ursprungs- und die Zielpixel weisen eine Ausrichtungsdiskrepanz von 0,25 auf. Ist die Mosaiktoleranz auf 0,2 festgelegt, erfolgt ein Resampling, da der Wert der falschen Pixelausrichtung größer ist als die Toleranz. Ist für die Mosaiktoleranz hingegen 0,3 festgelegt, werden die Pixel verschoben. | Double |
MatchingMethod (optional) | Die Farbabgleichmethode, die auf die Raster angewendet werden soll.
| String |
colormap_to_RGB (optional) | Wenn das Eingabe-Raster-Dataset über eine Colormap verfügt, kann das Ausgabe-Raster-Dataset in ein Dataset mit drei Bändern konvertiert werden. Dies erweist sich beim mosaikartigen Einfügen von Rastern mit unterschiedlichen Colormaps als nützlich.
| Boolean |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_raster_dataset | Das aktualisierte Raster-Dataset. | Raster-Dataset |
Codebeispiel
WorkspaceToRasterDataset – Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für das Werkzeug WorkspaceToRasterDataset.
import arcpy
arcpy.WorkspaceToRasterDataset_management("c:/data/WS2RD", "c:/fgdb.gdb/outdats",
"INCLUDE_SUBDIRECTORIES", "LAST",
"FIRST", "0", "9", "", "",
"HISTOGRAM_MATCHING", "")
WorkspaceToRasterDataset – Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für das Werkzeug WorkspaceToRasterDataset.
##==================================
##Workspace To Raster Dataset
##Usage: WorkspaceToRasterDataset_management in_workspace in_raster_dataset {NONE | INCLUDE_SUBDIRECTORIES}
## {LAST | FIRST | BLEND | MEAN | MINIMUM | MAXIMUM} {FIRST | REJECT
## | LAST | MATCH} {background_value} {nodata_value} {NONE | OneBitTo8Bit}
## {mosaicking_tolerance} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {NONE | ColormapToRGB}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic images to File Geodatabase Raster Dataset with Background and Nodata setting and Color Correction
arcpy.WorkspaceToRasterDataset_management("WS2RD", "fgdb.gdb\\dataset", "INCLUDE_SUBDIRECTORIES", "LAST", \
"FIRST", "0", "9", "", "", "HISTOGRAM_MATCHING", "")
##Mosaic Colormap image to RGB image
arcpy.WorkspaceToRasterDataset_management("WS2RD_clr","fgdb.gdb\\dataset2", "INCLUDE_SUBDIRECTORIES", "LAST",\
"FIRST", "", "", "", "0.3", "", "ColormapToRGB")
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja