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 Liste der unterstützten Dateiformate für Raster-Datasets wird die Spezifikation aufgelistet, die das JPEG-Format unterstützen kann. 
Syntax
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
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")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
- Pyramide
- Pyramidenebene, Pyramidenkomprimierung und Resampling-Methode werden nicht auf das IMG-Format angewendet. 
- Faktor für parallele Verarbeitung
- Unterstützt nur für das CRF-Format. 
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja