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 Ausgabezellengröß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 der Parameter und die Umgebung für die Zellengröße nicht angegeben wurden, aber die Umgebung Fang-Raster festgelegt wurde, wird die Zellengröße des Fang-Rasters verwendet. Wenn kein Wert angegeben wird, 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 die Ausdehnung in der Umgebung im Ausgabekoordinatensystem angegeben.

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

  Wenn die Zellengröße mit einem Raster-Dataset angegeben wird, zeigt der Parameter anstelle des Zellengrößenwerts den Pfad des Raster-Datasets an. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, vorausgesetzt der Raumbezug stimmt mit dem Ausgabe-Raumbezug überein. 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 zur Geoverarbeitung von Umgebungen mit diesem 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 Ausgabe-Rasters, das erstellt wird. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.	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 ring- oder kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Radius muss einen Wert von mindestens 1 Zelle aufweisen, und der äußere Radius muss größer sein als der innere Radius. Der innere Radius darf einen Wert von maximal 2046 Zellen, der äußere Radius von maximal 2047 Zellen aufweisen. Der Standardkreisring hat einen inneren Radius von 1 Zelle und einen äußeren Radius von 3 Zellen. Kreis, Radius, Einheitentyp Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen. Rechteck, Höhe, Breite, Einheitentyp Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Die Breite bzw. Höhe muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 4096 Zellen aufweisen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen. Keil, Radius, Anfangswinkel, Endwinkel, Einheitentyp Eine keilförmige Nachbarschaft, die durch einen Radius, einen Anfangswinkel und einen Endwinkel definiert wird. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. 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 Ausgabe-Rasters, das erstellt wird. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.	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 ring- oder kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist. Der Radius muss einen Wert von mindestens 1 Zelle aufweisen, und der äußere Radius muss größer sein als der innere Radius. Der innere Radius darf einen Wert von maximal 2046 Zellen, der äußere Radius von maximal 2047 Zellen aufweisen. Der Standardkreisring hat einen inneren Radius von 1 Zelle und einen äußeren Radius von 3 Zellen. NbrCircle({radius}, {units} Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. Der Standardradius beträgt 3 Zellen. NbrRectangle({width}, {height}, {units}) Eine rechteckige Nachbarschaft, die durch Breite und Höhe definiert ist. Die Breite bzw. Höhe muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 4096 Zellen aufweisen. Der Standard ist das Quadrat mit einer Breite und Höhe von drei Zellen. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Eine keilförmige Nachbarschaft, die durch einen Radius, einen Anfangswinkel und einen Endwinkel definiert wird. Der Radius muss einen Wert von mindestens 1 Zelle und darf einen Wert von maximal 2047 Zellen aufweisen. 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