Punkt-Statistiken (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet eine Statistik der Punkte in einer Nachbarschaft um jede Ausgabezelle.

Weitere Informationen zur Funktionsweise des Werkzeugs "Punkt-Statistiken"

Verwendung

• Es stehen mehrere Nachbarschaftsformen und Statistiktypen zur Auswahl. Die verfügbare Auswahl an Statistiken hängt vom Typ des angegebenen Feldes ab.

• Bei Feldern vom Typ "Integer" lauten die gültigen Auswahloptionen für Statistiktyp wie folgt: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Standardabweichung", "Summe" und "Varianz". Bei Float-Feldern lauten die gültigen Statistiken: "Maximum", "Mittelwert", "Minimum", "Bereich", "Standardabweichung" und "Summe". "Mehrheit", "Minderheit" und "Varianz" sind nicht verfügbar.

• Wenn der Feldtyp "Integer" lautet, ist die Ausgabe der folgenden Statistiken ein Integer­Raster: "Mehrheit", "Maximum", "Medianwert", "Minimum", "Minderheit", "Bereich", "Summe" und "Varianz". Bei den Statistiken "Mittelwert" und "Standardabweichung" ist die Ausgabe vom Typ "Float".

  Wenn es sich bei dem Feldtyp um "Float" handelt, weist auch die Ausgabe für alle verfügbaren Statistiktypen den Typ "Float" auf.

• Wenn es keine Punkte in der Nachbarschaft einer Raster-Zelle gibt, weist die Statistik Varianz den Wert 0 zu. Bei den anderen Statistiken wird "NoData" zugewiesen.

• Der Parameter Ausgabe-Zellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn die Zellengröße nicht im Parameter oder in der Umgebung angegeben ist, wohingegen die Umgebung für das Fang-Raster festgelegt ist, wird die Zellengröße des Fang-Rasters verwendet. Wenn nichts angegeben ist, wird die Zellengröße aus der Breite oder Höhe der Ausdehnung (je nachdem was kürzer ist) berechnet, indem der Wert durch 250 dividiert wird. Dabei wird für die Ausdehnung das in der Umgebung angegebene Ausgabekoordinatensystem verwendet.

• Wenn die Zellengröße mit einem numerischen Wert angegeben ist, wird dieser direkt für das Ausgabe-Raster verwendet.

  Wenn die Zellengröße mit einem Raster-Dataset angegeben ist, wird für den Parameter anstelle des Wertes für die Zellengröße der Pfad des Raster-Datasets angezeigt. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, sofern der Raumbezug des Datasets mit dem des Ausgabe-Raumbezugs übereinstimmt. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

• Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Punkt-Features	Die Eingabepunkte, die bei der Nachbarschaftsoperation verwendet werden sollen. Für jede Ausgabezelle werden die Eingabepunkte bestimmt, die in die definierte umgebende Nachbarschaftsform fallen. Für die ausgewählten Punkte werden Werte aus den angegebenen Attributen abgerufen, womit eine Statistik berechnet wird. Bei der Eingabe kann es sich um eine Point- oder Multipoint-Feature-Class handeln.	Feature Layer
Feld	Das Feld, für das die angegebene Statistik berechnet wird. Hierbei kann es sich um ein beliebiges Zahlenfeld der Eingabe-Punkt-Features handeln. Dies kann das Feld Shape sein, wenn die Eingabe-Features Z-Werte enthalten.	Field
Ausgabe-Zellengröße (optional)	Die Zellengröße des zu erstellenden Ausgabe-Rasters. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.	Analysis Cell Size
Nachbarschaft (optional)	Der Bereich um jede Verarbeitungszelle, in dem gefundene Eingabepunkte in der Statistikberechnung verwendet werden. Es stehen mehrere vordefinierte Nachbarschaftstypen zur Auswahl. Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standardnachbarschaft ist ein Quadrat mit einer Breite und Höhe von drei Zellen. Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben: Kreisring, Innerer Radius, Äußerer Radius, Einheitentyp Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Standardkreisring ist ein innerer Radius von einer Zelle und ein äußerer Radius von drei Zellen. Kreis, Radius, Einheitentyp Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Standardradius ist drei Zellen. Rechteck, Höhe, Breite, Einheitentyp Eine rechteckige Nachbarschaft, die durch Höhe und Breite definiert ist. Die Standardeinstellung ist ein Quadrat mit einer Höhe und Breite von drei Zellen. Keil, Radius, Anfangswinkel, Endwinkel, Einheitentyp Eine keilförmige Nachbarschaft, die durch einen Radius, den Anfangswinkel und den Endwinkel definiert wird. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Die Winkel werden in Grad angegeben, wobei 0 bzw. 360 Grad Osten darstellt. Es können negative Winkel verwendet werden. Der Standardkeil reicht von 0 bis 90 Grad mit einem Radius von drei Zellen. Die Entfernungseinheiten für die Parameter können als Einheiten der Zelle oder der Karte angegeben werden. Die Standardeinstellung sind Zelleneinheiten.	Neighborhood
Statistiktyp (optional)	Gibt den zu berechnenden Statistiktyp an. Die Berechnung erfolgt mit den Werten des angegebenen Feldes für die Punkte, die in der Nachbarschaft jeder Ausgabe-Raster-Zelle liegen. Der Standardstatistiktyp ist Mittelwert. Die verfügbaren Optionen für den Statistiktyp werden durch den numerischen Typ des angegebenen Feldes bestimmt. Wenn das Feld vom Typ "Integer" ist, sind alle Statistiktypen verfügbar. Wenn das Feld vom Typ "Float" ist, sind nur die Statistiken für Maximum, Mittelwert, Minimum, Bereich, Standardabweichung und Summe verfügbar. Mittelwert—Der Durchschnitt der Feldwerte in jeder Nachbarschaft wird berechnet. Mehrheit—Der am häufigsten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet. Maximum—Der größte Feldwert in jeder Nachbarschaft wird bestimmt. Medianwert—Der Medianwert für das Feld in jeder Nachbarschaft wird berechnet. Im Fall einer geraden Zahl von Punkten in der Nachbarschaft ist das Ergebnis der niedrigere der beiden mittleren Werte. Minimum—Der kleinste Feldwert in jeder Nachbarschaft wird bestimmt. Minderheit—Der am seltensten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet. Bereich—Der Bereich (Differenz zwischen dem größten und kleinsten Wert) der Feldwerte in jeder Nachbarschaft wird berechnet. Standardabweichung—Die Standardabweichung der Feldwerte in jeder Nachbarschaft wird berechnet. Summe—Die Summe der Feldwerte in jeder Nachbarschaft wird berechnet. Varianz—Die Anzahl der einzelnen Feldwerte in jeder Nachbarschaft wird berechnet.	String

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster für "Punkt-Statistiken".	Raster

Python

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})

Name	Erläuterung	Datentyp
in_point_features	Die Eingabepunkte, die bei der Nachbarschaftsoperation verwendet werden sollen. Für jede Ausgabezelle werden die Eingabepunkte bestimmt, die in die definierte umgebende Nachbarschaftsform fallen. Für die ausgewählten Punkte werden Werte aus den angegebenen Attributen abgerufen, womit eine Statistik berechnet wird. Bei der Eingabe kann es sich um eine Point- oder Multipoint-Feature-Class handeln.	Feature Layer
field	Das Feld, für das die angegebene Statistik berechnet wird. Hierbei kann es sich um ein beliebiges Zahlenfeld der Eingabe-Punkt-Features handeln. Dies kann das Feld Shape sein, wenn die Eingabe-Features Z-Werte enthalten.	Field
cell_size (optional)	Die Zellengröße des zu erstellenden Ausgabe-Rasters. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.	Analysis Cell Size
neighborhood (optional)	Der Bereich um jede Verarbeitungszelle, in dem gefundene Eingabepunkte in der Statistikberechnung verwendet werden. Es stehen mehrere vordefinierte Nachbarschaftstypen zur Auswahl. Nach Auswahl des Nachbarschaftstyps können weitere Parameter festgelegt werden, um die endgültige Definition von Form, Größe und Maßeinheiten vorzunehmen. Die Standardnachbarschaft ist ein Quadrat mit einer Breite und Höhe von drei Zellen. Die Form der Nachbarschaften um die einzelnen Eingabepunkte bestimmt sich aus der Klasse Neighborhood. Die verfügbaren Nachbarschaftstypen sind NbrAnnulus, NbrCircle, NbrRectangle, und NbrWedge. Im Folgenden sind die Formen der verfügbaren Nachbarschaftstypen beschrieben: NbrAnnulus({innerRadius}, {outerRadius}, {units}) Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Standardkreisring ist ein innerer Radius von einer Zelle und ein äußerer Radius von drei Zellen. NbrCircle({radius}, {units} Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Standardradius ist drei Zellen. NbrRectangle({width}, {height}, {units}) Eine rechteckige Nachbarschaft, die durch Höhe und Breite definiert ist. Die Standardeinstellung ist ein Quadrat mit einer Höhe und Breite von drei Zellen. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Eine keilförmige Nachbarschaft, die durch einen Radius, den Anfangswinkel und den Endwinkel definiert wird. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Die Winkel werden in Grad angegeben, wobei 0 bzw. 360 Grad Osten darstellt. Es können negative Winkel verwendet werden. Der Standardkeil reicht von 0 bis 90 Grad mit einem Radius von drei Zellen. Die Entfernungseinheiten für die Parameter können als Einheiten der CELL oder der MAP angegeben werden. Die Standardeinstellung sind Zelleneinheiten. Der standardmäßige Nachbarschaftstyp ist NbrRectangle mit einer Breite und Höhe von drei Zellen.	Neighborhood
statistics_type (optional)	Gibt den zu berechnenden Statistiktyp an. Die Berechnung erfolgt mit den Werten des angegebenen Feldes für die Punkte, die in der Nachbarschaft jeder Ausgabe-Raster-Zelle liegen. MEAN—Der Durchschnitt der Feldwerte in jeder Nachbarschaft wird berechnet. MAJORITY—Der am häufigsten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet. MAXIMUM—Der größte Feldwert in jeder Nachbarschaft wird bestimmt. MEDIAN—Der Medianwert für das Feld in jeder Nachbarschaft wird berechnet. Im Fall einer geraden Zahl von Punkten in der Nachbarschaft ist das Ergebnis der niedrigere der beiden mittleren Werte. MINIMUM—Der kleinste Feldwert in jeder Nachbarschaft wird bestimmt. MINORITY—Der am seltensten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet. RANGE—Der Bereich (Differenz zwischen dem größten und kleinsten Wert) der Feldwerte in jeder Nachbarschaft wird berechnet. STD—Die Standardabweichung der Feldwerte in jeder Nachbarschaft wird berechnet. SUM—Die Summe der Feldwerte in jeder Nachbarschaft wird berechnet. VARIETY—Die Anzahl der einzelnen Feldwerte in jeder Nachbarschaft wird berechnet. Der Standardstatistiktyp ist MEAN. Die verfügbaren Optionen für den Statistiktyp werden durch den numerischen Typ des angegebenen Feldes bestimmt. Wenn das Feld vom Typ "Integer" ist, sind alle Statistiktypen verfügbar. Wenn das Feld vom Typ "Float" ist, sind nur die Statistiken für Maximum, Mittelwert, Minimum, Bereich, Standardabweichung und Summe verfügbar.	String

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster für "Punkt-Statistiken".	Raster

Codebeispiel

PointStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird eine Statistik (die Summe) für die Punkt-Features des Eingabe-Shapefiles ermittelt, die in einer kreisförmigen Nachbarschaft um jede Ausgabe-Raster-Zelle liegen.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500, 
                                NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")

PointStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird eine Statistik (der Durchschnitt) für die Punkt-Features des Eingabe-Shapefiles ermittelt, die in einer kreisförmigen Nachbarschaft um jede Ausgabe-Raster-Zelle liegen.

# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified 
#    neighborhood outputting a raster.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzinformationen

• Basic: Erfordert Spatial Analyst
• Standard: Erfordert Spatial Analyst
• Advanced: Erfordert Spatial Analyst