Pyramiden und Statistiken berechnen (Data Management)—ArcGIS Pro

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.
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.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabedaten oder Eingabe-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
Unterverzeichnisse einbeziehen (optional)	Gibt an, ob Unterverzeichnisse einbezogen werden. Deaktiviert: Unterverzeichnisse werden nicht einbezogen. Aktiviert: Beim Laden werden alle Raster-Datasets in den Unterverzeichnissen einbezogen. Dies ist die Standardeinstellung. Mosaik-Datasets müssen als Eingabe-Workspace angegeben werden, wenn die im Mosaik-Dataset enthaltenen Elemente einbezogen werden sollen. Anderenfalls werden nur die dem Mosaik-Dataset zugeordneten Statistiken verwendet.	Boolean
Pyramiden berechnen (optional)	Geben Sie an, ob Pyramiden berechnet werden sollen. Deaktiviert: Es werden keine Pyramiden berechnet. Aktiviert: Es werden Pyramiden berechnet. Dies ist die Standardeinstellung.	Boolean
Statistiken berechnen (optional)	Gibt an, ob Statistiken berechnet werden sollen. Deaktiviert: Es werden keine Statistiken berechnet. Aktiviert – Es werden Statistiken berechnet. Dies ist die Standardeinstellung.	Boolean
Quell-Datasets einbeziehen (optional)	Geben Sie an, ob Sie 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. Deaktiviert: Statistiken werden für jedes Raster-Element im Mosaik-Dataset (d. h. jede Zeile in der Attributtabelle) berechnet. Bevor die Statistiken generiert werden, werden alle dem Raster-Element hinzugefügten Funktionen angewendet. Dies ist die Standardeinstellung. Aktiviert: Es werden Statistiken für die Quelldaten des Mosaik-Datasets berechnet.	Boolean
Block-Feld (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
Mosaik-Dataset-Statistiken schätzen (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. Deaktiviert: Für das Mosaik-Dataset werden keine Statistiken berechnet. Dies ist die Standardeinstellung. Aktiviert: Für das Mosaik-Dataset werden Statistiken berechnet.	Boolean
X-Sprungfaktor (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-Sprungfaktor (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
Ausschlusswerte (optional)	Die Pixelwerte, die bei der Berechnung der Statistik ausgelassen werden sollen. Das Standardelement ist kein Wert.	Long
Pyramidenebenen (optional)	Die Anzahl der erstellten Dataset-Layer mit reduzierter Auflösung. 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
Erste Ebene überspringen (optional)	Gibt an, ob die erste Pyramidenebene übersprungen wird. Wenn Sie die erste Ebene überspringen, benötigen Sie etwas weniger Speicherplatz, aber die Performance bei diesem Maßstab wird verlangsamt. Deaktiviert: Die erste Pyramidenebene wird nicht übersprungen; sie wird erstellt. Dies ist die Standardeinstellung. Aktiviert: Die erste Pyramidenebene wird übersprungen; sie wird nicht erstellt.	Boolean
Resampling-Verfahren für Pyramiden (optional)	Gibt die zum Erstellen der Pyramiden verwendete Resampling-Methode an. Nächster Nachbar—Der Wert des nächstgelegenen Pixels wird verwendet, um dem Ausgabepixel beim Resampling einen Wert zuzuweisen. Dies ist die Standardeinstellung. Bilinear—Der neue Wert eines Pixels basiert auf einem gewichteten Entfernungsdurchschnitt der vier nächstgelegenen Eingabepixelmittelpunkte. Kubisch—Der neue Wert eines Pixels basiert auf einer geglättete Kurve, die durch die Mittelpunkte der 16 nächstgelegenen Eingabepixel angepasst wird.	String
Pyramidenkomprimierungstyp (optional)	Gibt den Komprimierungstyp an, der beim Erstellen der Rasterpyramiden verwendet wird. Standard—Wenn die Quelldaten mit einer Wavelet-Komprimierung komprimiert werden, werden Pyramiden mit der JPEG-Komprimierung berechnet. Andernfalls wird LZ77 verwendet. Dies ist die Standardeinstellung. LZ77-Komprimierung—Der LZ77-Komprimierungsalgorithmus wird zum Erstellen der Pyramiden verwendet. LZ77 kann für jeden Datentyp verwendet werden. JPEG-Komprimierung—Der JPEG-Komprimierungsalgorithmus wird zum Erstellen von Pyramiden verwendet. Dieser Komprimierungstyp kann nur für Daten verwendet werden, für die die JPEG-Komprimierungsspezifikationen eingehalten werden. Wenn Sie JPEG auswählen, können Sie anschließend den Wert für die Komprimierungsqualität festlegen. JPEG Luma und Chroma—Es wird eine verlustbehaftete Komprimierung mit den Farbraumkomponenten Luma (Y) und Chroma (Cb und Cr) verwendet. Keine Komprimierung—Beim Erstellen der Pyramiden wird keine Komprimierung verwendet.	String
Komprimierungsqualität (1 – 100) (optional)	Die Komprimierungsqualität, die beim Erstellen von Pyramiden mit der JPEG-Komprimierungsmethode verwendet wird. 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
Vorhandene überspringen (optional)	Geben Sie an, ob Statistiken nur dort erstellt werden sollen, wo keine vorhanden sind, oder ob auch vorhandene neu erstellt werden sollen. Aktiviert: Statistiken werden nur berechnet, wenn sie noch nicht vorhanden sind. Dies ist die Standardeinstellung. Deaktiviert: Statistiken werden berechnet, auch wenn sie bereits vorhanden sind. Vorhandene Statistiken werden überschrieben.	Boolean
Abfragedefinition (optional)	Ein SQL-Ausdruck zur Auswahl von Raster-Datasets, die verarbeitet werden sollen.	SQL Expression
SIPS-Modus (optional)	Gibt an, ob die Erstellung von Pyramidendateien anhand der Kernprozesse und Algorithmen gemäß SIPS (Softcopy Image Processing Standard), NGA.STND.0014, aktiviert wird. Deaktiviert: Pyramiden werden mit standardmäßigen Subsampling-Methoden erstellt. Dies ist die Standardeinstellung. Aktiviert: Pyramiden werden mit SIPS-Verarbeitung erstellt.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabedaten	Der aktualisierte Ausgabe-Workspace.	Text File; Workspace; Raster Layer; Mosaic Layer

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})

Name	Erläuterung	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)	Gibt an, ob Unterverzeichnisse einbezogen werden. NONE—Unterverzeichnisse werden nicht einbezogen. INCLUDE_SUBDIRECTORIES—Beim Laden werden alle Raster-Datasets in den Unterverzeichnissen einbezogen. Dies ist die Standardeinstellung. 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. NONE—Es werden keine Pyramiden berechnet. BUILD_PYRAMIDS—Es werden Pyramiden berechnet. Dies ist die Standardeinstellung.	Boolean
calculate_statistics (optional)	Gibt an, ob Statistiken berechnet werden sollen. NONE—Es werden keine Statistiken berechnet. CALCULATE_STATISTICS—Es werden Statistiken berechnet. Dies ist die Standardeinstellung.	Boolean
BUILD_ON_SOURCE (optional)	Geben Sie an, ob Sie 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. NONE—Statistiken werden für jedes Raster-Element im Mosaik-Dataset (d. h. jede Zeile in der Attributtabelle) berechnet. Bevor die Statistiken generiert werden, werden alle dem Raster-Element hinzugefügten Funktionen angewendet. Dies ist die Standardeinstellung. BUILD_ON_SOURCE—Es werden Statistiken für die Quelldaten des Mosaik-Datasets berechnet.	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. NONE—Für das Mosaik-Dataset werden keine Statistiken berechnet. Dies ist die Standardeinstellung. ESTIMATE_STATISTICS—Für das Mosaik-Dataset werden Statistiken berechnet.	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)	Die Anzahl der erstellten Dataset-Layer mit reduzierter Auflösung. 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)	Gibt an, ob die erste Pyramidenebene übersprungen wird. Wenn Sie die erste Ebene überspringen, benötigen Sie etwas weniger Speicherplatz, aber die Performance bei diesem Maßstab wird verlangsamt. NONE—Die erste Pyramidenebene wird nicht übersprungen; sie wird erstellt. Dies ist die Standardeinstellung. SKIP_FIRST—Die erste Pyramidenebene wird übersprungen; sie wird nicht erstellt.	Boolean
resample_technique (optional)	Gibt die zum Erstellen der Pyramiden verwendete Resampling-Methode an. NEAREST—Der Wert des nächstgelegenen Pixels wird verwendet, um dem Ausgabepixel beim Resampling einen Wert zuzuweisen. Dies ist die Standardeinstellung. BILINEAR—Der neue Wert eines Pixels basiert auf einem gewichteten Entfernungsdurchschnitt der vier nächstgelegenen Eingabepixelmittelpunkte. CUBIC—Der neue Wert eines Pixels basiert auf einer geglättete Kurve, die durch die Mittelpunkte der 16 nächstgelegenen Eingabepixel angepasst wird.	String
compression_type (optional)	Gibt den Komprimierungstyp an, der beim Erstellen der Rasterpyramiden verwendet wird. DEFAULT—Wenn die Quelldaten mit einer Wavelet-Komprimierung komprimiert werden, werden Pyramiden mit der JPEG-Komprimierung berechnet. Andernfalls wird LZ77 verwendet. Dies ist die Standardeinstellung. LZ77—Der LZ77-Komprimierungsalgorithmus wird zum Erstellen der Pyramiden verwendet. LZ77 kann für jeden Datentyp verwendet werden. JPEG—Der JPEG-Komprimierungsalgorithmus wird zum Erstellen von Pyramiden verwendet. Dieser Komprimierungstyp kann nur für Daten verwendet werden, für die die JPEG-Komprimierungsspezifikationen eingehalten werden. Wenn Sie JPEG auswählen, können Sie anschließend den Wert für die Komprimierungsqualität festlegen. JPEG_YCBCR—Es wird eine verlustbehaftete Komprimierung mit den Farbraumkomponenten Luma (Y) und Chroma (Cb und Cr) verwendet. NONE—Beim Erstellen der Pyramiden wird keine Komprimierung verwendet.	String
compression_quality (optional)	Die Komprimierungsqualität, die beim Erstellen von Pyramiden mit der JPEG-Komprimierungsmethode verwendet wird. 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. SKIP_EXISTING—Statistiken werden nur berechnet, wenn sie noch nicht vorhanden sind. Dies ist die Standardeinstellung. OVERWRITE—Statistiken werden berechnet, auch wenn sie bereits vorhanden sind. Vorhandene Statistiken werden überschrieben.	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. NONE—Pyramiden werden mit standardmäßigen Subsampling-Methoden erstellt. Dies ist die Standardeinstellung. SIPS_MODE—Pyramiden werden mit SIPS-Verarbeitung erstellt.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	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)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Sonderfälle

Lizenzinformationen

Verwandte Themen

In diesem Thema