Workspace in Raster-Dataset (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Mosaikiert alle im angegebenen Workspace gespeicherten Raster-Datasets in ein Raster-Dataset.

Verwendung

Syntax

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

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

Weitere Informationen zu den einzelnen Mosaikoperatoren finden Sie unter Mosaikoperator.

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.

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 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. 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.

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

Wählen Sie die Farbabgleichmethode aus, die auf die Raster angewendet werden soll.

  • NONEBeim Mosaikieren von Raster-Datasets wird kein Farbabgleich angewendet.
  • STATISTICS_MATCHINGDiese Methode gleicht die statistischen Abweichungen (Minimum, Maximum und Mittelwert) zwischen der als Referenz verwendeten Überlappung und der als Quelle verwendeten Überlappung ab. 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 der Quelle interpoliert. Für Pixel ohne Eins-zu-eins-Beziehung wird ein gewichteter Mittelwert 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

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}
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()

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013