ArcMap

Punkt-Statistiken

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

  • Wenn das angegebene Feld ganzzahlig ist, stehen folgende Auswahlmöglichkeiten für Überlagerungsstatistiken zur Verfügung: Mittelwert, Mehrheit, Maximum, Median, Minimum, Minderheit, Bereich, Standardabweichung, Summe und Varianz. Wenn das Feld den Typ "Gleitkomma" aufweist, sind lediglich folgende Statistiktypen zulässig: Mittelwert, Maximum, Minimum, Bereich, Standardabweichung und Summe.

  • Für diese Statistiktypen ist der Ausgabedatentyp des Rasters gleich dem Eingabefeldtyp: "Mehrheit", "Maximum", "Medianwert", "Minimum", "Minderheit", "Bereich" und "Summe". Bei den Statistiktypen "Mittelwert" und "Standardabweichung" werden im Ausgabe-Raster immer Gleitkommazahlen verwendet. Bei "Varianz" ist das Ausgabe-Raster stets ganzzahlig.

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

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Syntax

PointStatistics (in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
ParameterErläuterungDatentyp
in_point_features

Die Eingabe-Punkt-Features für die die Statistik in einer Nachbarschaft um jede Ausgabezelle berechnet werden soll.

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

Dies kann das Feld "Shape" sein, wenn die Eingabe-Features Z-Werte enthalten.

Field
cell_size
(optional)

Die Zellengröße für das Ausgabe-Raster-Dataset.

Dies ist der Wert in der Umgebung, wenn dieser ausdrücklich festgelegt wurde. Wenn dies in der Umgebung nicht festgelegt wurde, wird die Breite oder Höhe (der kleinere Wert von beiden) der Ausdehnung des Eingabe-Feature-Datasets im Ausgabe-Raumbezug dividiert durch 250 verwendet.

Analysis Cell Size
neighborhood
(optional)

Die Klasse Neighborhood definiert die Form der Fläche um jeden Eingabepunkt, die zum Berechnen der Statistik verwendet wird.

Folgende Nachbarschaftstypen sind verfügbar: NbrAnnulus, NbrCircle, NbrRectangle, und NbrWedge.

Folgende Nachbarschaftsformen sind verfügbar:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

Die Standardnachbarschaft ist das Quadrat NbrRectangle mit einer Breite und Höhe von drei Zellen.

Neighborhood
statistics_type
(optional)

Der zu berechnende Statistiktyp.

Die Berechnung wird anhand der Werte des angegebenen Feldes der Punkteingabe in der Nachbarschaft jeder Ausgabe-Raster-Zelle durchgeführt.

  • MEAN — Berechnet den Durchschnitt der Feldwerte in jeder Nachbarschaft.
  • MAJORITY — Bestimmt den am häufigsten auftretenden Feldwert in jeder Nachbarschaft. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • MAXIMUM — Ermittelt den größten Feldwert in jeder Nachbarschaft.
  • MEDIAN — Ermittelt den mittleren Feldwert in jeder Nachbarschaft. Im Fall einer geraden Zahl von Punkten in der Nachbarschaft ist das Ergebnis der niedrigere der beiden mittleren Werte.
  • MINIMUM — Ermittelt den kleinsten Feldwert in jeder Nachbarschaft.
  • MINORITY — Bestimmt den am seltensten auftretenden Feldwert in jeder Nachbarschaft. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • RANGE — Berechnet den Bereich (Differenz zwischen größtem und kleinstem Wert) der Feldwerte in jeder Nachbarschaft.
  • STD — Berechnet die Standardabweichung der Feldwerte in jeder Nachbarschaft.
  • SUM — Berechnet den Gesamtwert der Feldwerte in jeder Nachbarschaft.
  • VARIETY — Berechnet die Anzahl der eindeutigen Feldwerte in jeder Nachbarschaft.

Die verfügbaren Optionen für den Statistiktyp werden durch den numerischen Typ des angegebenen Feldes bestimmt.

String

Rückgabewert

NameErläuterungDatentyp
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")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

Umgebungen

Lizenzinformationen

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

Verwandte Themen