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

  • Die 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 in 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 der ausgewählten Projektionsmethode für Zellengröße projiziert.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Punkt-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
Feld

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
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 Standardeinstellung für die Nachbarschaft ist "Rechteck".

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.

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 "Gleitkomma" ist, sind nur die Statistiken für Maximum, Mittelwert, Minimum, Bereich, Standardabweichung und Summe verfügbar.

  • MittelwertDer Durchschnitt der Feldwerte in jeder Nachbarschaft wird berechnet.
  • MehrheitDer am häufigsten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • MaximumDer größte Feldwert in jeder Nachbarschaft wird bestimmt.
  • MedianwertDer 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.
  • MinimumDer kleinste Feldwert in jeder Nachbarschaft wird bestimmt.
  • MinderheitDer am seltensten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • BereichDer Bereich (Differenz zwischen dem größten und kleinsten Wert) der Feldwerte in jeder Nachbarschaft wird berechnet.
  • StandardabweichungDie Standardabweichung der Feldwerte in jeder Nachbarschaft wird berechnet.
  • SummeDie Summe der Feldwerte in jeder Nachbarschaft wird berechnet.
  • VarianzDie Anzahl der einzelnen Feldwerte in jeder Nachbarschaft wird berechnet.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für "Punkt-Statistiken".

Raster

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
NameErlä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 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 Standardeinstellung für die Nachbarschaft ist "Rechteck".

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.

  • MEANDer Durchschnitt der Feldwerte in jeder Nachbarschaft wird berechnet.
  • MAJORITYDer am häufigsten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • MAXIMUMDer größte Feldwert in jeder Nachbarschaft wird bestimmt.
  • MEDIANDer 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.
  • MINIMUMDer kleinste Feldwert in jeder Nachbarschaft wird bestimmt.
  • MINORITYDer am seltensten auftretende Feldwert in jeder Nachbarschaft wird bestimmt. Wenn mehrere Werte gleich häufig vorkommen, wird der niedrigere Wert verwendet.
  • RANGEDer Bereich (Differenz zwischen dem größten und kleinsten Wert) der Feldwerte in jeder Nachbarschaft wird berechnet.
  • STDDie Standardabweichung der Feldwerte in jeder Nachbarschaft wird berechnet.
  • SUMDie Summe der Feldwerte in jeder Nachbarschaft wird berechnet.
  • VARIETYDie Anzahl der einzelnen Feldwerte in jeder Nachbarschaft wird berechnet.

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 "Gleitkomma" ist, sind nur die Statistiken für Maximum, Mittelwert, Minimum, Bereich, Standardabweichung und Summe verfügbar.

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

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

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

Lizenzinformationen

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

Verwandte Themen