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
BuildPyramidsandStatistics_management (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 | Erläuterung | 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. | Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace |
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 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 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 |
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
- ArcGIS Desktop Basic: Ja
- ArcGIS Desktop Standard: Ja
- ArcGIS Desktop Advanced: Ja