Zusammenfassung
Fügt einem Mosaik-Dataset aus mehreren Quellen, z. B. einer Datei, einem Ordner, einer Tabelle oder einem Web-Service, Raster-Datasets hinzu.
Verwendung
Die hinzugefügten Raster-Daten sind nicht verwaltet. Wenn Raster-Daten gelöscht oder verschoben werden, wirkt sich dies auf das Mosaik-Dataset aus.
Sie können nur einem Mosaik-Dataset, das in einer Geodatabase enthalten ist, Raster hinzufügen. Datasets, die außerhalb einer Geodatabase erstellt wurden, können nur den Inhalt eines Raster-Katalogs oder eines zuvor erstellten Mosaik-Datasets enthalten.
Der Parameter Raster-Typ identifiziert die zum Laden von Daten in das Mosaik-Dataset erforderlichen Metadaten.
Für eine schnellere Anzeige und Verarbeitung kann der Pixel-Cache für ein Mosaik-Dataset generiert werden, wenn die Option Pixel-Cache aktivieren ausgewählt ist.
Syntax
arcpy.management.AddRastersToMosaicDataset(in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs})| Parameter | Erklärung | Datentyp |
in_mosaic_dataset | Der Pfad und der Name des Mosaik-Datasets, dem die Raster-Daten hinzugefügt werden. | Mosaic Layer |
raster_type | Der Raster-Typ ist spezifisch für Bilddatenprodukte. Damit werden Metadaten, z. B. Georeferenzierung, Erwerbsdatum und Sensortyp, sowie ein Raster-Format angegeben. Wenn Sie einen LAS-, LAS-Dataset- oder Terrain-Raster-Typ verwenden, muss eine .art-Datei verwendet werden, wenn die Zellgröße angegeben ist. Eine Liste von Raster-Typen finden Sie in der Liste der unterstützten Raster- und Bilddatenformate. | Raster Type |
input_path [input_path,...] | Gibt den Pfad und den Namen der Eingabedatei, des Ordners, des Raster-Datasets, des Mosaik-Datasets, der Tabelle oder des Service an. Es sind nicht alle Eingabeoptionen verfügbar. Der ausgewählte Raster-Typ bestimmt die verfügbaren Optionen.
| File; Image Service; LAS Dataset Layer; Layer File; Map Server; Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (optional) | Gibt an, ob die Zellgrößenbereiche der einzelnen Raster im Mosaik-Dataset berechnet werden. Diese Werte werden in der Attributtabelle in die Felder minPS und maxPS geschrieben.
| Boolean |
update_boundary (optional) | Gibt an, ob das Grenzpolygon eines Mosaik-Datasets generiert oder aktualisiert wird. Standardmäßig führt die Grenze alle Footprint-Polygone zusammen, um eine einzelne Grenze zu erstellen, die die Ausdehnung der gültigen Pixel darstellt.
| Boolean |
update_overviews (optional) | Gibt an, ob Übersichten für ein Mosaik-Dataset definiert und generiert werden.
| Boolean |
maximum_pyramid_levels (optional) | Die maximale Anzahl der Pyramidenebenen, die im Mosaik-Dataset verwendet werden. Bei einem Wert von "2" werden beispielsweise nur die ersten zwei Pyramidenebenen des Quell-Rasters verwendet. Wird dieser Parameter leer gelassen oder der Wert -1 eingegeben, werden Pyramiden für alle Ebenen berechnet. Dieser Wert wirkt sich auf die Anzeige und die Anzahl der generierten Übersichten aus. | Long |
maximum_cell_size (optional) | Die maximale Pyramiden-Zellgröße, die im Mosaik-Dataset verwendet wird. | Double |
minimum_dimension (optional) | Die kleinsten Dimensionen der Raster-Pyramide, die im Mosaik-Dataset verwendet werden. | Long |
spatial_reference (optional) | Das Raumbezugssystem der Eingabe-Daten. Dieser Wert sollte angegeben werden, wenn für die Daten kein Koordinatensystem vorhanden ist. Andernfalls wird das Koordinatensystem des Mosaik-Datasets verwendet. Mit diesem Wert kann außerdem das Koordinatensystem der Eingabedaten überschrieben werden. | Spatial Reference |
filter (optional) | Ein Filter für die Daten, die dem Mosaik-Dataset hinzugefügt werden. Sie können SQL-Ausdrücke für die Erstellung des Datenfilters verwenden. Die Platzhalter für den Filter funktionieren für den vollständigen Pfad zu den Eingabedaten. Die folgende SQL-Anweisung wählt die Zeilen aus, in denen die folgenden Objekt-IDs übereinstimmen:
Um nur ein TIFF-Bild hinzuzufügen, fügen Sie ein Sternchen vor einer Dateierweiterung hinzu.
Um nur ein Bild mit dem Wort "Sensor" im Dateipfad oder Dateinamen hinzuzufügen, fügen Sie vor und nach dem Wort "Sensor" ein Sternchen ein.
Sie können auch PERL-Syntax für die Erstellung eines Datenfilters verwenden.
Die folgende PERL-Syntax mit mehreren lexikalischen Gruppierungen als Teil des Ausdrucks wird nicht unterstützt:
Sie können auch die folgende Syntax verwenden:
| String |
sub_folder (optional) | Gibt an, ob Unterordner rekursiv untersucht werden.
| Boolean |
duplicate_items_action (optional) | Gibt an, wie doppelte Raster verarbeitet werden. Es wird eine Prüfung ausgeführt, um zu ermitteln, ob die einzelnen Raster mit dem ursprünglichen Pfad und dem Dateinamen bereits hinzugefügt wurden. Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn doppelte Pfad- oder Dateinamen gefunden werden.
| String |
build_pyramids (optional) | Berechnet für jedes Quell-Raster Pyramiden.
| Boolean |
calculate_statistics (optional) | Gibt an, ob Statistiken für jedes Quell-Raster berechnet werden.
| Boolean |
build_thumbnails (optional) | Gibt an, ob Miniaturansichten für jedes Quell-Raster erstellt werden.
| Boolean |
operation_description (optional) | Die Beschreibung, mit der Sie den Vorgang des Hinzufügens von Raster-Daten darstellen. Sie wird der Raster-Typ-Tabelle hinzugefügt, die für die Suche oder als Referenz verwendet werden kann. | String |
force_spatial_reference (optional) | Gibt das Koordinatensystem an. Verwenden Sie das im Parameter spatial_reference angegebene Koordinatensystem für alle Raster, wenn Sie Daten in das Mosaik-Dataset laden.
| Boolean |
estimate_statistics (optional) | Gibt an, ob Statistiken für das Mosaik-Dataset zur schnellere Darstellung und Verarbeitung auf der Mosaik-Dataset-Ebene geschätzt werden.
| Boolean |
aux_inputs [aux_inputs,...] (optional) | Die Raster-Typ-Einstellungen, die auf der Seite Raster-Typ-Eigenschaften definiert werden. Mit den Einstellungen in diesem Parameter werden die Einstellungen überschrieben, die auf der Seite Raster-Typ-Eigenschaften definiert sind. | Value Table |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_mosaic_dataset | Das aktualisierte Mosaik-Dataset. | Mosaic Layer |
Codebeispiel
AddRastersToMosaicDataset – Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für die Funktion AddRastersToMosaicDataset.
import arcpy
arcpy.AddRastersToMosaicDataset_management(
"c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+",
"c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
"UPDATE_OVERVIEWS", "2", "#", "#", "GCS_WGS_1984.prj",
"*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE",
"NO_STATISTICS", "", "USE_PIXEL_CACHE",
r"C:\test\cachelocation")
AddRastersToMosaicDataset – Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für die Funktion AddRastersToMosaicDataset.
#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja