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
Mit dem Berechnen von Pyramiden lässt sich die Anzeigeleistung von Raster-Datasets verbessern.
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.
Enthält der Workspace ein Mosaik-Dataset, werden lediglich die dem Mosaik-Dataset zugeordneten Statistiken einbezogen. Nicht einbezogen werden hingegen die den Elementen innerhalb des Mosaik-Datasets zugeordneten Statistiken.
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}, {sips_mode})| Parameter | Erklärung | Datentyp |
in_workspace | Der Workspace, der alle zu verarbeitenden Raster-Datasets oder Mosaik-Datasets enthält. Enthält der Workspace ein Mosaik-Dataset, werden lediglich die dem Mosaik-Dataset zugeordneten Statistiken einbezogen. Nicht einbezogen werden hingegen die den Elementen innerhalb des Mosaik-Datasets zugeordneten Statistiken. | Text File; Workspace; Raster Layer; Mosaic Layer |
include_subdirectories (optional) | Geben Sie an, ob Unterverzeichnisse eingeschlossen werden sollen.
Enthält der Workspace ein Mosaik-Dataset, werden lediglich die dem Mosaik-Dataset zugeordneten Statistiken einbezogen. Nicht einbezogen werden hingegen die den Elementen innerhalb des Mosaik-Datasets zugeordneten Statistiken. | 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 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 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 |
sips_mode (optional) | Gibt an, ob die Erstellung von Pyramidendateien anhand der Kernprozesse und Algorithmen gemäß SIPS (Softcopy Image Processing Standard), NGA.STND.0014, aktiviert wird.
| Boolean |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_workspace | Der aktualisierte Ausgabe-Workspace. | Textdatei; Workspace; Raster-Layer; Mosaik-Layer |
Codebeispiel
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")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)Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja