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 Mosaikieren von diskontinuierlichen Daten führen die Optionen Erste(r), Minimum oder Maximum unter Mosaik-Operator zu den aussagekräftigsten Ergebnissen. Die Optionen Verschmelzen und Mittelwert sind am besten 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", die für kontinuierliche Datentypen nicht geeignet ist, erneut berechnet.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Workspace

Der Ordner mit den Raster-Datasets, die zusammengeführt werden sollen.

Workspace
Ziel-Raster-Dataset

Ein vorhandenes Raster-Dataset, in dem alle Raster-Datasets aus dem Eingabe-Workspace zusammengeführt werden sollen.

Raster Dataset
Unterverzeichnisse einbeziehen
(optional)

Gibt an, ob Unterverzeichnisse einbezogen werden.

  • Deaktiviert: Unterverzeichnisse werden nicht einbezogen. Dies ist die Standardeinstellung.
  • Aktiviert: Alle Raster-Datasets in den Unterverzeichnissen werden beim Laden einbezogen.
Boolean
Mosaik-Operator
(optional)

Gibt die Methode an, die auf überlappende Flächen im Mosaik angewendet wird.

  • 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-Modus des Mosaiks
(optional)

Gibt die Methoden an, 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 Mosaikieren werden alle Colormaps berücksichtigt. Wenn bereits alle möglichen Werte (für die Bit-Tiefe) verwendet wurden, gleicht das Werkzeug den Wert mit der ähnlichsten verfügbaren Farbe ab.
  • REJECTNur die Raster-Datasets, denen keine Colormap zugeordnet ist, werden in das Mosaik aufgenommen.
String
Hintergrundwert ignorieren
(optional)

Unerwünschte Werte, die um die ursprünglichen Raster-Daten erstellt wurden, werden entfernt. 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.

Double
NoData-Wert
(optional)

Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt.

Double
1-Bit-Daten in 8-Bit konvertieren
(optional)

Gibt an, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert wird. 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 geringeren 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.

  • Deaktiviert: Es erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • Aktiviert: Das Eingabe-Raster wird konvertiert.
Boolean
Mosaik-Toleranz
(optional)

Beim Mosaikieren stimmen die Ziel- und Ursprungspixel nicht immer hundertprozentig überein. Wenn die Pixel nicht genau aneinander ausgerichtet sind, müssen Sie entscheiden, ob ein Resampling stattfinden oder die Daten verschoben werden sollen. Die Mosaiktoleranz bestimmt, ob ein Resampling der Pixel stattfindet oder 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, sondern eine Verschiebung ausgeführt.

Die Toleranz wird in Pixeln angegeben, mit einem gültigen Wertebereich zwischen 0 und 0,5. Eine Toleranz von 0,5 garantiert, dass eine Verschiebung 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
Farbabgleichmethode
(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 in RGB
(optional)

Gibt an, ob das Eingabe-Raster-Dataset in ein Ausgabe-Raster-Dataset mit drei Bändern konvertiert wird, wenn das Eingabe-Raster-Dataset über eine Colormap verfügt. Dies erweist sich beim mosaikartigen Einfügen von Rastern mit unterschiedlichen Colormaps als nützlich.

  • Deaktiviert: Es erfolgt keine Konvertierung. Dies ist die Standardeinstellung.
  • Aktiviert: Das Eingabe-Dataset wird konvertiert.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Ziel-Raster-Dataset

Das aktualisierte Raster-Dataset.

Raster-Dataset

arcpy.management.WorkspaceToRasterDataset(in_workspace, in_raster_dataset, {include_subdirectories}, {mosaic_type}, {colormap}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {mosaicking_tolerance}, {MatchingMethod}, {colormap_to_RGB})
NameErläuterungDatentyp
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)

Gibt an, ob Unterverzeichnisse einbezogen werden.

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

Gibt die Methode an, die auf überlappende Flächen im Mosaik angewendet wird.

  • 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)

Gibt die Methoden an, 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 Mosaikieren werden alle Colormaps berücksichtigt. Wenn bereits alle möglichen Werte (für die Bit-Tiefe) verwendet wurden, gleicht das Werkzeug den Wert mit der ähnlichsten verfügbaren Farbe ab.
  • REJECTNur die Raster-Datasets, denen keine Colormap zugeordnet ist, werden in das Mosaik aufgenommen.
String
background_value
(optional)

Unerwünschte Werte, die um die ursprünglichen Raster-Daten erstellt wurden, werden entfernt. 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.

Double
nodata_value
(optional)

Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt.

Double
onebit_to_eightbit
(optional)

Gibt an, ob das 1-Bit-Eingabe-Raster-Dataset in ein 8-Bit-Raster-Dataset konvertiert wird. 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 geringeren 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 erfolgt keine Konvertierung. 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, müssen Sie entscheiden, ob ein Resampling stattfinden oder die Daten verschoben werden sollen. Die Mosaiktoleranz bestimmt, ob ein Resampling der Pixel stattfindet oder 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, sondern eine Verschiebung ausgeführt.

Die Toleranz wird in Pixeln angegeben, mit einem gültigen Wertebereich zwischen 0 und 0,5. Eine Toleranz von 0,5 garantiert, dass eine Verschiebung 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)

Gibt an, ob das Eingabe-Raster-Dataset in ein Ausgabe-Raster-Dataset mit drei Bändern konvertiert wird, wenn das Eingabe-Raster-Dataset über eine Colormap verfügt. 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

NameErläuterungDatentyp
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.

Verwandte Themen