Zusammenfassung
Erstellt Raster-Pyramiden für Ihr Raster-Dataset.
Sie können mit diesem Werkzeug auch Pyramiden löschen. Legen Sie den Parameter Pyramidenebenen auf 0 fest, um Pyramiden zu löschen.
Abbildung
Verwendung
Das Berechnen von Pyramiden verbessert die Anzeigegeschwindigkeit von Raster-Datasets.
Sie müssen Pyramiden nur einmal pro Dataset berechnen. Auf die Pyramiden wird jedes Mal, wenn Sie das Raster-Dataset anzeigen, zugegriffen.
Pyramiden werden für Raster-Datasets mit einer Größe von weniger als 1024 Pixel (Zeile oder Spalte) nicht berechnet. In diesem Fall sind keine Pyramiden erforderlich, da diese Raster-Datasets so klein sind, dass die Performance durch das Berechnen von Pyramiden nicht verbessert wird.
Für Wavelet-komprimierte Raster-Datasets, z. B. ECW und MrSID, müssen keine Pyramiden berechnet werden. Diese Formate verfügen über interne Pyramiden, die bei der Codierung erstellt werden.
Sie können den Komprimierungstyp für die Übersichtspyramidendatei in den Raster-Speicherumgebungen auswählen. Durch die Komprimierung wird eine kleinere .ovr-Datei erstellt. Durch das IMAGINE-Format und ältere Versionen von ArcGIS werden Dataset-Dateien mit geringerer Auflösung (.rrd) erstellt, für die keine Komprimierung verfügbar ist.
Bei der standardmäßigen Pyramidenkomprimierung wird der optimale Komprimierungstyp für den jeweiligen Datentyp verwendet. Sie können auch manuell festlegen, ob LZ77, JPEG oder keine Komprimierung verwendet werden soll.
Die JPEG-Komprimierung kann nur mit Dateiformaten verwendet werden, die Daten gemäß den JPEG-Spezifikationen speichern können. Unter dem Thema Unterstützte Dateiformate für Raster-Datasets werden die Spezifikationen aufgelistet, die das JPEG-Format unterstützen kann.
Syntax
arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
Parameter | Erklärung | Datentyp |
in_raster_dataset | Das Raster-Dataset, für das Raster-Pyramiden berechnet werden sollen. Die Eingabe muss mehr als 1024 Zeilen und 1024 Spalten aufweisen. | Raster Dataset; Raster Layer |
pyramid_level (optional) | Bestimmen Sie, wie viele Dataset-Layer mit reduzierter Auflösung erstellt werden. Der Standardwert ist -1, um vollständige Pyramiden zu erstellen. Beim Wert 0 werden keine Pyramidenebenen erstellt. Legen Sie die Anzahl der Ebenen auf 0 fest, um Pyramiden zu löschen. Es können maximal 29 Pyramidenebenen festgelegt werden. Jeder Wert von 30 oder höher wird auf den Wert -1 zurückgesetzt, wobei ein vollständiger Satz von Pyramiden erstellt wird. | Long |
SKIP_FIRST (optional) | Sie können die erste Pyramidenebene überspringen. Wenn Sie die erste Ebene überspringen, benötigen Sie etwas weniger Speicherplatz, aber die Performance bei diesem Maßstab wird verlangsamt.
| Boolean |
resample_technique (optional) | Die Resampling-Methode zum Erstellen der Pyramiden.
| String |
compression_type (optional) | Der Komprimierungstyp, der beim Erstellen der Rasterpyramiden zu verwenden ist.
| String |
compression_quality (optional) | Die Komprimierungsqualität, die beim Erstellen von Pyramiden mit der JPEG-Komprimierungsmethode zu verwenden ist. Der Wert muss zwischen 0 und 100 liegen. Ein Wert nahe bei 100 erzeugt eine höhere Bildqualität, aber die Komprimierungsstufe ist niedriger. | Long |
skip_existing (optional) | Legen Sie fest, ob Pyramiden nur berechnet werden sollen, wenn sie fehlen, oder ob sie neu erstellt werden sollen, obwohl sie bereits vorhanden sind.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_raster | Das Ausgabe-Raster-Dataset. | Raster-Dataset |
Codebeispiel
BuildPyramids – Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für das Werkzeug BuildPyramids.
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
BuildPyramids – Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für das Werkzeug BuildPyramids.
#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BatchBuildPyramids_management(
inras, pylevels, skipfirst, resample, compress,
quality, skipexist)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja