Zusammenfassung
Durchläuft eine Ordnerstruktur, um Pyramiden zu erstellen und Statistiken für alle enthaltenen Raster-Datasets zu berechnen. Es können auch für alle Elemente in einem Mosaik-Dataset Pyramiden und Statistiken berechnet werden.
Verwendung
Das Berechnen von Pyramiden verbessert die Anzeigegeschwindigkeit von Raster-Datasets
Durch die Berechnung von Statistiken können ArcGIS-Anwendungen Raster-Daten ordnungsgemäß für die Anzeige strecken und symbolisieren.
Es werden alle unterstützten Raster-Formate verarbeitet.
Raster-Kataloge und Mosaik-Datasets müssen als Eingabe-Workspace angegeben werden. Wenn der Workspace einen Raster-Katalog oder ein Mosaik-Dataset enthält, werden diese Elemente beim Ausführen des Werkzeugs nicht einbezogen.
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.
Syntax
arcpy.management.BuildPyramidsandStatistics(in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing}, {where_clause})
Parameter | Erklärung | Datentyp |
in_workspace | Der Workspace, der alle zu verarbeitenden Raster-Datasets enthält, ein Mosaik-Dataset oder ein Raster-Katalog. Wenn der Workspace einen Raster-Katalog oder ein Mosaik-Dataset enthält, werden diese Elemente beim Ausführen des Werkzeugs nicht einbezogen. | Text File; Mosaic Dataset; Workspace; Raster Catalog Layer; Raster Dataset; Mosaic Layer |
include_subdirectories (optional) | Geben Sie an, ob Unterverzeichnisse eingeschlossen werden sollen.
Raster-Kataloge und Mosaik-Datasets müssen als Eingabe-Workspace angegeben werden. Wenn der Workspace einen Raster-Katalog oder ein Mosaik-Dataset enthält, werden diese Elemente beim Ausführen des Werkzeugs nicht einbezogen. | Boolean |
build_pyramids (optional) | Geben Sie an, ob Pyramiden berechnet werden sollen.
| Boolean |
calculate_statistics (optional) | Gibt an, ob Statistiken berechnet werden sollen.
| Boolean |
BUILD_ON_SOURCE (optional) | Geben Sie an, ob Sie Pyramiden und Statistiken zu den Quell-Raster-Datasets berechnen möchten, oder ob Statistiken zu den Raster-Elementen eines Mosaik-Datasets berechnet werden sollen. Diese Option gilt nur für Mosaik-Datasets.
| Boolean |
block_field (optional) | Der Name des Feldes innerhalb der Attributtabelle eines Mosaik-Datasets zum Identifizieren der Elemente, die bei bestimmten Berechnungen und Operationen als ein Element betrachtet werden sollen. | String |
estimate_statistics (optional) | Geben Sie an, ob Statistiken zum Mosaik-Dataset (und nicht zu den darin enthaltenen Rastern) berechnet werden sollen. Die Statistiken werden von den vorhandenen Statistiken abgeleitet, die für jedes Raster im Mosaik-Dataset berechnet wurden.
| Boolean |
x_skip_factor (optional) |
Die Anzahl der horizontalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Spaltenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Sprungfaktor. | Long |
y_skip_factor (optional) | Die Anzahl der vertikalen Pixel zwischen den Stichproben. Der Sprungfaktor steuert den Teil des Rasters, der bei der Berechnung von Statistiken verwendet wird. Der eingegebene Wert gibt den horizontalen oder vertikalen Sprungfaktor an. Bei einem Wert von 1 wird jedes Pixel verwendet, und bei einem Wert von 2 wird jedes zweite Pixel verwendet. Der Sprungfaktor muss zwischen 1 und der Anzahl der Spalten/Zeilen im Raster liegen. Der Wert muss größer null und kleiner oder gleich der Zeilenanzahl im Raster sein. Der Standardwert ist 1 oder der zuletzt verwendete Y-Sprungfaktor. | Long |
ignore_values [ignore_value,...] (optional) |
Die Pixelwerte, die bei der Berechnung der Statistik ausgelassen werden sollen. Das Standardelement ist kein Wert. | Long |
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. Es können maximal 29 Pyramidenebenen festgelegt werden. Bei einem Wert über 30 wird ein vollständiger Satz Pyramiden erstellt. | 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) | Geben Sie an, ob Statistiken nur dort erstellt werden sollen, wo keine vorhanden sind, oder ob auch vorhandene neu erstellt werden sollen.
| Boolean |
where_clause (optional) | Ein SQL-Ausdruck zur Auswahl von Raster-Datasets, die verarbeitet werden sollen. | SQL Expression |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_workspace | Der aktualisierte Ausgabe-Workspace. | Text File; Workspace; Raster Layer; Mosaic Layer |
Codebeispiel
BuildPyramidsAndStatistics – Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für das Werkzeug BuildPyramidsAndStatistics.
import arcpy
arcpy.BuildPyramidsAndStatistics_management(
"C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
"CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField",
"ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
"BILINEAR", "JPEG", "50", "OVERWRITE")
BuildPyramidsAndStatistics – Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für das Werkzeug BuildPyramidsAndStatistics.
#Build pyramids and calculate statistics for all raster in a folder
import arcpy
arcpy.env.workspace = "C:/Workspace"
inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BuildPyramidsAndStatistics_management(
inws, includedir, buildpy, calcstats, buildsource, blockfield,
estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
resample, compress, quality, skipexist)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja