Zusammenfassung
Mosaikiert den Inhalt eines Raster-Katalogs in ein neues Raster-Dataset.
Verwendung
Mit diesem Werkzeug können Sie einen Geodatabase-Raster-Katalog in ein Raster-Dataset konvertieren. Die Eingabe ist ein Raster-Katalog, und die Ausgabe ist ein neues Raster-Dataset. Dieses Werkzeug kann nicht zum Mosaikieren von Inhalten in ein vorhandenes Raster-Dataset verwendet werden.
Die Verwendung eines mosaikierten Raster-Datasets hat mehrere Vorteile: es wird in jedem Maßstab schneller angezeigt, spart Platz, weil keine überlappenden Daten vorhanden sind, und die Daten werden mit weniger Rändern dargestellt.
Der Pixeltyp sollte an die vorhandenen Eingabe-Raster-Datasets angepasst werden. Wenn Sie den Pixeltyp nicht festlegen, wird der Standardwert von 8 Bit verwendet, was zu einer falschen Ausgabe führen kann.
Sie können die Ausgabe in den Formaten BBIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF, CRF oder einem beliebigen Geodatabase-Raster-Dataset speichern.
Beim Speichern eines Raster-Datasets in einer JPEG-Datei, einer JPEG 2000-Datei oder einer Geodatabase können Sie im Dialogfeld Umgebungen einen Komprimierungstyp und eine Komprimierungsqualität festlegen.
Das GIF-Format unterstützt nur Einzelband-Raster-Datasets.
Die überlappenden Flächen des Mosaiks können auf verschiedene Weise verarbeitet werden. Sie können das Werkzeug beispielsweise so einstellen, dass nur die Daten des ersten Raster-Datasets erhalten bleiben oder dass die überlappenden Zellenwerte zusammengeführt werden. Weiterhin stehen verschiedene Optionen zur Verfügung, mit denen Sie festlegen können, wie ggf. eine Colormap verarbeitet wird. Sie können beispielsweise festlegen, dass die Colormap des letzten im Mosaik verwendeten Datasets beibehalten wird.
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.
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 mit Raster-Datasets, die Colormaps enthalten, ist es wichtig, die Unterschiede zwischen den Colormaps für die einzelnen zu mosaikierenden Raster-Datasets zu beachten. Verwenden Sie in diesem Fall das Werkzeug Mosaik für Raster mit unterschiedlichen Colormaps. Achten Sie darauf, dass Sie einen geeigneten Operator für den Colormap-Modus des Mosaiks auswählen. Bei einem unpassenden Colormap-Modus entspricht die Ausgabe möglicherweise nicht Ihren Erwartungen.
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.
Mittels Farbabgleich und Farbkorrektur können Sie eine nahtlosere Erstellung des Raster-Mosaiks sicherstellen.
Syntax
arcpy.management.RasterCatalogToRasterDataset(in_raster_catalog, out_raster_dataset, {where_clause}, {mosaic_type}, {colormap}, {order_by_field}, {ascending}, {pixel_type}, {ColorBalancing}, {MatchingMethod}, {ReferenceRaster}, {OID})
Parameter | Erklärung | Datentyp |
in_raster_catalog | Der Raster-Katalog, der zu einem Raster-Dataset mosaikiert wird. | Raster Catalog Layer |
out_raster_dataset | Name und Erweiterung des Raster-Dataset-Mosaiks, das ausgegeben wird. Wenn Sie das Raster-Dataset in einem Dateiformat speichern, müssen Sie die Dateierweiterung angeben:
Beim Speichern eines Raster-Datasets in einer Geodatabase darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden. Beim Speichern eines Raster-Datasets in einer JPEG-Datei, einer JPEG 2000-Datei, einer TIFF-Datei oder einer Geodatabase können Sie im Dialogfeld Umgebungseinstellungen einen Komprimierungstyp und eine Komprimierungsqualität festlegen. | Raster Dataset |
where_clause (optional) | Geben Sie die entsprechende SQL-Anweisung ein, um im Raster-Katalog bestimmte Zeilen auszuwählen. | SQL Expression |
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 Methoden, mit denen 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 |
order_by_field (optional) | Definieren Sie das Feld, nach dem die Raster-Katalogelemente sortiert werden sollen. | String |
ascending (optional) | Legen Sie fest, ob der Wert "Aufsteigend" für order_by_field verwendet werden soll. Wenn die Option "Aufsteigend" nicht ausgewählt wird, wird "Absteigend" verwendet.
| Boolean |
pixel_type (optional) | Gibt die Bittiefe des Ausgabe-Raster-Datasets an. Wenn hierbei keine Angabe erfolgt, entspricht die Bittiefe der Ausgabe der Bittiefe der Eingabe. Beim Auswählen eines anderen Pixeltyps findet keine erneute Skalierung der Raster-Werte statt. Wenn der Pixeltyp herabgestuft wird, werden die Raster-Werte, die außerhalb des gültigen Bereichs für diese Pixeltiefe liegen, abgeschnitten und gehen verloren.
| String |
ColorBalancing (optional) | Wählen Sie, ob Sie das Dodging-Verfahren verwenden möchten, um eine Farbkorrektur für Raster-Katalogelemente auszuführen. Gamma- und Kontrastwerte für den Farbausgleichsalgorithmus werden anhand sämtlicher Pixel im Raster-Katalog ermittelt.
| Boolean |
MatchingMethod (optional) | Wählen Sie die Farbabgleichmethode aus, die auf die Raster angewendet werden soll.
| String |
ReferenceRaster (optional) | Wenn Sie einen Farbabgleich verwenden, müssen Sie das Referenz-Raster angeben.
| String |
OID (optional) | Die Objekt-ID (OID) des Referenz-Rasters. Die OID ist ein eindeutiges Schlüsselfeld im Raster-Katalog. | Long |
Codebeispiel
RasterCatalogToRasterDataset - Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für das Werkzeug RasterCatalogToRasterDataset.
import arcpy
arcpy.RasterCatalogToRasterDataset_management("c:/data/fgdb.gdb/catalog1",
"c:/data/dataset.tif",
"OBJECTID>1", "LAST", "FIRST",
"", "", "8_BIT_UNSIGNED",
"COLOR_BALANCING",
"HISTOGRAM_MATCHING",
"CALCULATE_FROM_ALL", "")
RasterCatalogToRasterDataset - Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für das Werkzeug RasterCatalogToRasterDataset.
##==================================
##Raster Catalog To Raster Dataset
##Usage: RasterCatalogToRasterDataset_management in_raster_catalog out_raster_dataset {where_clause} {LAST | FIRST | MINIMUM | MAXIMUM
## | MEAN | BLEND} {FIRST | REJECT | LAST | MATCH} {order_by_field} {NONE | ASCENDING}
## {8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED | 16_BIT_UNSIGNED |
## 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
## {NONE | COLOR_BALANCING} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING
## | LINEARCORRELATION_MATCHING} {CACULATE_FROM_ALL | SPECIFY_OID | DEFINE_FROM_SELECTION}
## {OID}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic a Unmanaged Raster Catalog to a TIFF format Raster Dataset with Color Correction
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog1","RC2RD\\dataset1.tif", "OBJECTID>1", "LAST", "FIRST", "", "",\
"8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "CALCULATE_FROM_ALL", "")
##Mosaic using the According Order of cretain Field
arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog2","RC2RD\\dataset2.tif", "", "LAST", "FIRST", "POPULATION", \
"ASCENDING", "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "SPECIFY_OID", "2")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja