Workspace in Raster-Dataset (Data Management)

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})
ParameterErklärungDatentyp
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.

  • NONEUnterverzeichnisse werden nicht einbezogen. Dies ist die Standardeinstellung.
  • INCLUDE_SUBDIRECTORIESBeim Laden werden alle Raster-Datasets in den Unterverzeichnissen einbezogen.
Boolean
mosaic_type
(optional)

Die Verarbeitungsweise für überlappende Flächen im Mosaik.

  • FIRSTDer Ausgabezellenwert der überlappenden Flächen ist der Wert aus dem ersten Raster-Dataset, der an dieser Position mosaikiert wurde.
  • LASTDer Ausgabezellenwert der überlappenden Flächen ist der Wert aus dem letzten Raster-Dataset, der an dieser Position mosaikiert wurde. Dies ist die Standardeinstellung.
  • BLENDDer Ausgabezellenwert der überlappenden Flächen ist eine horizontal gewichtete Berechnung von den Werten der Zellen in der überlappenden Fläche.
  • MEANDer Ausgabezellenwert der überlappenden Flächen ist der Mittelwert der überlappenden Zellen.
  • MINIMUMDer Ausgabezellenwert der überlappenden Flächen ist der Minimalwert der überlappenden Zellen.
  • MAXIMUMDer Ausgabezellenwert der überlappenden Flächen ist der Maximalwert der überlappenden Zellen.
  • SUMDer Ausgabezellenwert der überlappenden Flächen ist der Gesamtwert der überlappenden Zellen.
String
colormap
(optional)

Die Methoden, mit denen Sie auswählen können, welche Colormap aus den Eingabe-Rastern auf die Mosaikausgabe angewendet wird.

  • FIRSTDie Colormap des ersten Raster-Datasets in der Liste wird auf das Ausgabe-Raster-Mosaik angewendet. Dies ist die Standardeinstellung.
  • LASTDie Colormap des letzten Raster-Datasets in der Liste wird auf das Ausgabe-Raster-Mosaik angewendet.
  • MATCHBeim Erstellen des Mosaiks werden alle Colormaps berücksichtigt. Wenn alle möglichen Werte bereits ausgeschöpft sind (für die Bittiefe), wird die ähnlichste verfügbare Farbe verwendet.
  • REJECTNur die Raster-Datasets, denen keine Colormap zugeordnet ist, werden in das Mosaik aufgenommen.
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 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.

  • NONEEs findet keine Konvertierung statt. Dies ist die Standardeinstellung.
  • OneBitTo8BitDas Eingabe-Raster wird konvertiert.
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.

  • NONEBeim Mosaikieren von Raster-Datasets wird kein Farbabgleich angewendet.
  • STATISTIC_MATCHINGDiese Methode verwendet beschreibende Statistiken aus den überlappenden Flächen. Die Transformation wird anschließend auf das gesamte Ziel-Dataset angewendet.
  • HISTOGRAM_MATCHINGDiese Methode gleicht das Histogramm aus der als Referenz verwendeten Überlappung mit der als Quelle verwendeten Überlappung ab. Die Transformation wird anschließend auf das gesamte Ziel-Dataset angewendet.
  • LINEARCORRELATION_MATCHINGBei dieser Methode werden überlappende Pixel abgeglichen und dann für den Rest des Quell-Datasets interpoliert. Für Pixel ohne Eins-zu-Eins-Beziehung wird ein gewichteter Durchschnitt verwendet.
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.

  • NONEEs erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • ColormapToRGBDas Eingabe-Dataset wird konvertiert.
Boolean

Abgeleitete Ausgabe

NameErklärungDatentyp
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

Verwandte Themen