Workspace in Raster-Dataset (Data Management)
Zusammenfassung
Mosaikiert alle im angegebenen Workspace gespeicherten Raster-Datasets in ein Raster-Dataset.
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 "Letzte(r)", um Raster-Datasets mit einem vorhandenen Raster-Dataset in einer File-Geodatabase oder ArcSDE-Geodatabase zu mosaikieren. Dies ist mit Abstand die effizienteste Vorgehensweise.
-
Beim Erstellen eines Mosaiks aus diskontinuierlichen Daten erzielen Sie mit dem Mosaikoperator FIRST, MINIMUM oder MAXIMUM 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 und Personal-Geodatabase-Raster muss der Wert für Hintergrund ignorieren auf denselben Wert wie NoData gesetzt werden, damit der Hintergrundwert ignoriert wird. File-Geodatabase-Raster und ArcSDE-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 des Nächster-Nachbar-Resamplings erneut berechnet, das für kontinuierliche Datentypen nicht geeignet ist.
Syntax
| Parameter | Erläuterung | Datentyp |
in_workspace |
Der Workspace, der alle mosaikartig in das Raster-Dataset einzufügenden Raster-Datasets enthält. | Workspace |
in_raster_dataset |
Das Raster-Dataset, in dem alle Raster aus dem Workspace mosaikiert werden. Das Raster-Dataset muss bereits vorhanden sein. | 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.
Weitere Informationen zu den einzelnen Mosaikoperatoren finden Sie unter Mosaikoperator. | String |
colormap (optional) |
Die Methode, mit der Sie auswählen können, welche Colormap aus den Eingabe-Rastern auf die Mosaikausgabe angewendet wird.
Weitere Informationen zu den einzelnen Colormap-Modi finden Sie unter Colormap-Modus des Mosaiks. | 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 null 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 der Wert für "Hintergrund ignorieren" auf denselben Wert wie "NoData" gesetzt werden, damit der Hintergrundwert ignoriert wird. ArcSDE- 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 ArcSDE. Wenn 1-Bit-Raster-Datasets in ein Dateisystem gespeichert werden, verfügen diese über 8-Bit-Pyramiden-Layer. In ArcSDE 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 ArcSDE 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) |
Bei der mosaikartigen Erstellung stimmen die Ziel- und Ursprungspixel nicht immer hundertprozentig überein. Wenn die Pixel nicht genau aneinander ausgerichtet sind, muss eine 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 eingehenden Dataset und dem Ziel-Dataset größer ist als die Toleranz, wird ein Resampling ausgeführt. Wenn der Unterschied bei der Pixelausrichtung zwischen dem eingehenden 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,9999 liegt. Ein Pixel kann höchstens um den Wert 0,5 verschoben werden. Somit wird bei jeder Einstellung über 0,5 auf jeden Fall eine Verschiebung vorgenommen. Bei einer Toleranz von null 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) |
Wählen Sie die Farbabgleichmethode aus, 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 |
Codebeispiel
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", "")
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}
try:
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")
except:
print "Workspace To Raster Dataset example failed."
print arcpy.GetMessages()