Zusammenfassung
Führt mehrere Raster-Datasets zu einem neuen Raster-Dataset zusammen.
Verwendung
Die Eingabe-Raster-Datasets sind alle Raster-Datasets, die Sie mosaikartig zusammenfügen möchten. Die Eingaben müssen die gleiche Anzahl von Bändern und die gleiche Bittiefe aufweisen. Andernfalls wird das Werkzeug unter Anzeige einer Fehlermeldung geschlossen.
Gerade wenn Datasets in ein vorhandenes Raster eingefügt werden sollen, bietet das Werkzeug Mosaik mehr Parameter, wie beispielsweise Optionen zum Ignorieren der Hintergrundwerte und NoData-Werte.
Der Pixeltyp sollte an die vorhandenen Eingabe-Raster-Datasets angepasst werden. Wird kein Pixeltyp angegeben, wird der Standardwert von 8 Bit verwendet. Dies kann zu einer falschen Ausgabe führen.
Sie können die Ausgabe in den Formaten BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF oder in einem 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.
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 Parameterwert für den Colormap-Modus des Mosaiks auswählen. Wenn Sie einen ungeeigneten Colormap-Modus auswählen, kann Ihre Ausgabe anders als erwartet ausfallen.
Die Umgebungseinstellung Ausgabeausdehnung im Werkzeug wird für Enterprise-Geodatabases nicht berücksichtigt. Wenn Sie eine bestimmte Ausdehnung für das Ausgabe-Raster wünschen, verwenden Sie das Werkzeug Ausschneiden. Sie können entweder vor Anwendung des Werkzeugs die Eingabe-Raster oder die Ausgabe des Werkzeugs ausschneiden.
Syntax
arcpy.management.MosaicToNewRaster(input_rasters, output_location, raster_dataset_name_with_extension, {coordinate_system_for_the_raster}, {pixel_type}, {cellsize}, number_of_bands, {mosaic_method}, {mosaic_colormap_mode})
Parameter | Erklärung | Datentyp |
input_rasters [input_raster,...] | Die Raster-Datasets, die Sie zusammenführen möchten. Die Eingaben müssen dieselbe Anzahl von Bändern und dieselbe Bit-Tiefe aufweisen. | Mosaic Dataset; Raster Dataset; Raster Layer |
output_location | Der Ordner oder die Geodatabase zum Speichern des Rasters. | Workspace |
raster_dataset_name_with_extension | Der Name des Datasets, das Sie erstellen. Wenn Sie das Raster-Dataset in einem Dateiformat speichern, müssen Sie die Dateierweiterung angeben:
Fügen Sie beim Speichern eines Raster-Datasets in einer Geodatabase dem Namen des Raster-Datasets keine Dateierweiterung hinzu. 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. | String |
coordinate_system_for_the_raster (optional) | Das Koordinatensystem für das Ausgabe-Raster-Dataset. | Coordinate System |
pixel_type (optional) | Bittiefe bzw. radiometrische Auflösung des Mosaik-Datasets. Wird kein Pixeltyp angegeben, wird der Standardwert von 8 Bit verwendet. Dies kann zu einer falschen Ausgabe führen.
| String |
cellsize (optional) | Die Zellengröße für das neue Raster-Dataset. | Double |
number_of_bands | Die Anzahl von Bändern, über die das Ausgabe-Raster verfügt. | Long |
mosaic_method (optional) | Die Verarbeitungsweise für überlappende Flächen im Mosaik.
Weitere Informationen zu den einzelnen Mosaikoperatoren finden Sie im Hilfethema "Mosaikoperator". | String |
mosaic_colormap_mode (optional) | Wird angewendet, wenn die Eingabe-Raster-Datasets eine Colormap besitzen. Gibt die Methoden an, mit denen Sie auswählen können, welche Colormap aus den Eingabe-Rastern auf die Mosaikausgabe angewendet wird.
| String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
output_raster_dataset | Das Ausgabe-Raster-Dataset. | Raster-Dataset |
Codebeispiel
Dies ist ein Python-Beispiel für das Werkzeug MosaicToNewRaster.
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MosaicToNewRaster_management("land1.tif;land2.tif", "Mosaic2New", \
"landnew.tif", "World_Mercator.prj",\
"8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
Dies ist ein Python-Skriptbeispiel für das Werkzeug MosaicToNewRaster.
##==================================
##Mosaic To New Raster
##Usage: MosaicToNewRaster_management inputs;inputs... output_location raster_dataset_name_with_extension
## {coordinate_system_for_the_raster} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT
## | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_FLOAT | 32_BIT_UNSIGNED
## | 32_BIT_SIGNED | | 64_BIT {cellsize} number_of_bands {LAST | FIRST | BLEND | MEAN
## | MINIMUM | MAXIMUM} {FIRST | REJECT | LAST | MATCH}
import arcpy
arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
##Mosaic several TIFF images to a new TIFF image
arcpy.MosaicToNewRaster_management("landsatb4a.tif;landsatb4b.tif","Mosaic2New", "landsat.tif", "World_Mercator.prj",\
"8_BIT_UNSIGNED", "40", "1", "LAST","FIRST")
Umgebungen
- Ausdehnung
Gilt nicht für Enterprise-Geodatabases
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja