Zusammenfassung
Fügt einem Mosaik-Dataset aus mehreren Quellen, einschließlich einer Datei, eines Ordners, einer Tabelle oder eines Web-Service, Raster-Datasets hinzu.
Verwendung
Die hinzugefügten Raster-Daten sind nicht verwaltet. Wenn also 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.
Syntax
AddRastersToMosaicDataset_management (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})| Parameter | Erläuterung | Datentyp |
in_mosaic_dataset | Der Pfad und der Name des Mosaik-Datasets, dem die Raster-Daten hinzugefügt werden. | Image Service; Mosaic Layer; String |
raster_type | Der Raster-Typ wird speziell für Bildprodukte verwendet. Damit werden Metadaten, z. B. Georeferenzierung, Erwerbsdatum und Sensortyp, sowie ein Raster-Format angegeben. Eine Liste von Raster-Typen finden Sie in der Liste der unterstützten Raster- und Bilddatenformate. Wenn Sie einen LAS-, LAS-Dataset- oder Terrain-Raster-Typ verwenden, muss eine .art-Datei verwendet werden, in der die Zellengröße angegeben ist. | Raster Type |
input_path [input_path,...] | Pfad und Name der Datei, des Ordners, des Raster-Datasets, des Mosaik-Datasets, der Tabelle oder des Service. Es sind nicht alle Eingabeoptionen verfügbar. Die verfügbaren Optionen hängen vom ausgewählten Raster-Typ ab.
| File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (optional) | Berechnet die Zellengrößenbereiche der einzelnen Raster im Mosaik-Dataset. Diese Werte werden in der Attributtabelle in die Spalten minPS und maxPS geschrieben.
| Boolean |
update_boundary (optional) | Generiert oder aktualisiert das Grenzpolygon eines Mosaik-Datasets. 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) | Definiert und generiert Übersichten für ein Mosaik-Dataset.
| Boolean |
maximum_pyramid_levels (optional) | Definiert 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 Wert 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 Übersichten aus, die erstellt werden. | Long |
maximum_cell_size (optional) | Definiert die maximale Pyramiden-Zellengröße, die im Mosaik-Dataset verwendet wird. | Double |
minimum_dimension (optional) | Definiert 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) | Untersucht Unterordner rekursiv.
| Boolean |
duplicate_items_action (optional) | 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 aus, welche Aktion 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) | Berechnet Statistiken für jedes Quell-Raster.
| Boolean |
build_thumbnails (optional) | Erstellt für jedes Quell-Raster Miniaturansichten.
| Boolean |
operation_description (optional) | Eine benutzerdefinierte Beschreibung, mit der Sie den Vorgang des Hinzufügens der 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) | Verwenden Sie das Koordinatensystem für Eingabedaten für alle Raster, wenn Sie Daten in das Mosaik-Dataset laden.
| Boolean |
Codebeispiel
AddRastersToMosaicDataset – Beispiel 1 (Python-Fenster)
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",
"NO_OVERVIEWS", "UPDATE_OVERVIEWS", "2", "#", "#",
"GCS_WGS_1984.prj","*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE")
AddRastersToMosaicDataset – Beispiel 2 (eigenständiges Skript)
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 = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Nein
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja