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 zuvor erstellten Mosaik-Datasets enthalten.
Der Parameter Raster-Typ identifiziert die zum Laden von Daten in das Mosaik-Dataset erforderlichen Metadaten.
Weitere Informationen zu Raster-Typen
Der Raster-Typ ist spezifisch für Bilddatenprodukte. Damit werden Metadaten, z. B. Georeferenzierung, Erfassungsdatum und Sensortyp, sowie ein Raster-Format angegeben.
Die Verarbeitungsvorlagen-Optionen enthalten Funktionen, die auf Elemente angewendet werden, die Ihrem Mosaik-Dataset hinzugefügt werden, sowie die Art und Weise oder Reihenfolge ihrer Anwendung.
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}, {enable_pixel_cache}, {cache_location})
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, Erfassungsdatum und Sensortyp, sowie ein Raster-Format angegeben. Eine Liste der unterstützten Sensoren und Raster-Typen finden Sie in der Liste der unterstützten Sensoren. Wenn Sie einen LAS-, LAS-Dataset- oder Terrain-Raster-Typ verwenden, muss eine .art-Datei verwendet werden, wenn die Zellengröße angegeben ist. | 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; MapServer; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (optional) | Gibt an, ob die Zellengröß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-Zellengröß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:
Wenn Sie nur ein TIFF-Bild hinzufügen möchten, fügen Sie ein Sternchen vor einer Dateierweiterung hinzu.
Wenn Sie ein Bild mit dem Wort "Sensor" im Dateipfad oder Dateinamen hinzufügen möchten, 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 |
enable_pixel_cache (optional) | Gibt an, ob der Pixel-Cache für eine schnellere Anzeige und Verarbeitung des Mosaik-Datasets generiert wird.
| Boolean |
cache_location (optional) | Der Speicherort des Pixel-Cache. Wenn kein Speicherort definiert wird, wird der Cache in C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\ gespeichert. Nachdem Sie den Speicherort definiert haben, müssen Sie den Pfad nicht neu definieren, wenn Sie dem Mosaik-Dataset neue Raster hinzufügen. Sie müssen nur den Parameter Pixel-Cache aktivieren (enable_pixel_cache = "USE_PIXEL_CACHE" in Python) aktivieren, wenn Sie neue Daten hinzufügen. | Folder; String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_mosaic_dataset | Das aktualisierte Mosaik-Dataset. | Mosaik-Layer |
Codebeispiel
Dies ist ein Python-Beispiel für das Werkzeug 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")
Dies ist ein Python-Skriptbeispiel für das Werkzeug 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 = "#"
estimatestats = "ESTIMATE_STATISTICS"
auxilaryinput = ""
enablepixcache = "USE_PIXEL_CACHE"
cachelocation = "c:\\test\\cachelocation"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr, estimatestats
auxilaryinput, enablepixcache, cachelocation)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja