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

BeschriftungErläuterungDatentyp
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 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.

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

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

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

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