Punktdichte (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet die Größe pro Flächeneinheit auf Basis von Punkt-Features, die sich innerhalb einer bestimmten Nachbarschaft um die einzelnen Zellen befinden.

Weitere Informationen zur Funktionsweise des Werkzeugs "Punktdichte"

Abbildung

Abbildung zur Punktdichte
OutRas = PointDensity(InPts, None, 30)

Verwendung

  • Nur die Punkte, die innerhalb der Nachbarschaft liegen, werden bei der Berechnung der Dichte berücksichtigt. Wenn keine Punkte in der Nachbarschaft einer bestimmten Zelle liegen, wird dieser Zelle der Wert "NoData" zugewiesen.

  • Die Werte im Ausgabe-Raster sind immer Gleitkommawerte.

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

  • Größere Werte des Radiusparameters führen zu einem stärker generalisierten Dichte-Raster. Kleinere Werte erzeugen ein Raster, in dem weitere Details angezeigt werden.

  • Bei Datenformaten mit Unterstützung für NULL-Werte wie beispielsweise File-Geodatabase-Feature-Classes werden als Eingabe verwendete NULL-Werte ignoriert.

  • Wenn die Maßstabsfaktoreinheiten für Flächeneinheiten im Verhältnis zur Entfernung zwischen den Punkten klein sind, sind die Ausgabe-Raster-Werte möglicherweise klein. Um größere Werte zu erhalten, verwenden Sie den Flächeneinheits-Maßstabsfaktor für größere Einheiten (z. B. Quadratkilometer statt Quadratmeter).

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Punkt-Features

Die Eingabe-Punkt-Features, für die die Dichte berechnet werden soll.

Feature Layer
Feld mit Grundgesamtheit

Feld, das die Populationswerte für die einzelnen Punkte angibt. Das "Feld mit Grundgesamtheit" ist die Anzahl, die bei der Berechnung einer kontinuierlichen Oberfläche verwendet werden soll.

Das Feld mit Grundgesamtheit kann sowohl Ganzzahl- als auch Gleitkommawerte enthalten.

Die Optionen und das Standardverhalten des Feldes werden weiter unten aufgeführt.

  • Wählen Sie NONE aus, wenn kein Element oder besonderer Wert verwendet und jedes Feature einmal gezählt wird.

  • Wenn die Eingabe-Features Z-Werte enthalten, können Sie das Feld Shape verwenden.

  • Andernfalls lautet die Standardeinstellung POPULATION. Darüber hinaus gelten möglicherweise die folgenden Bedingungen:

    • Wenn das Feld POPULATION nicht vorhanden ist, jedoch ein Feld namens POPULATIONabcd, wird dieses standardmäßig verwendet. Dabei steht "abcd" für beliebige gültige Zeichen, z. B. POPULATION6, POPULATION1974 oder POPULATIONROADTYPE.
    • Wenn keines der Felder POPULATION oder POPULATIONabcd vorhanden ist, jedoch ein Feld namens POP, wird standardmäßig das Feld POP verwendet.
    • Wenn keines der Felder POPULATION, POPULATIONabcd oder POP vorhanden ist, jedoch ein Feld namens POPabcd, wird standardmäßig das Feld POPabcd verwendet.
    • Wenn keines der Felder POPULATION, POPULATIONabcd, POP oder POPabcd vorhanden ist, wird standardmäßig NONE verwendet.
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)

Schreibt die Form der Fläche um jede Zelle vor, die verwendet wird, um den Dichtewert zu berechnen.

  • Kreisring – Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist.
  • Kreis – Eine kreisförmige Nachbarschaft mit dem gegebenen Radius. Dies ist die Standardvorgabe, wenn der Radius dem kürzeren Wert der Breite bzw. Höhe der Ausdehnung der Eingabe-Punkt-Features im Ausgabe-Raumbezug, dividiert durch 30, entspricht.
  • Rechteck – Eine rechteckige Nachbarschaft mit der gegebenen Höhe und Breite.
  • Keil – Eine keilförmige Nachbarschaft. Ein Keil wird durch einen Anfangswinkel, einen Endwinkel und einen Radius angegeben. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Winkel werden in arithmetischen Grad (gegen den Uhrzeigersinn ausgehend von der positiven X-Achse) angegeben. Es können negative Winkel verwendet werden.
  • Zelle | Karte – Definiert die Einheiten der ausgewählten Nachbarschaftsmessungen in Zellen- oder Karteneinheiten (auf Grundlage der linearen Einheit der Projektion des Ausgabe-Raumbezugs).
Neighborhood
Flächeneinheiten
(optional)

Gibt die Flächeneinheiten für die Ausgabedichtewerte an.

Die Standardeinheit ergibt sich aus der linearen Einheit des Ausgabe-Raumbezugs. Sie können diese Einstellung in die gewünschte Einheit ändern, um die Dichteausgabe zu konvertieren. Bei Werten für die Liniendichte werden die Einheiten von Länge und Fläche gleichermaßen konvertiert.

Wurde kein Ausgabe-Raumbezug angegeben, ist dieser mit der Eingabe-Feature-Class identisch. Die Standardeinheiten der Ausgabedichte ergeben sich aus den linearen Einheiten des Ausgabe-Raumbezugs. Sind die linearen Ausgabeeinheiten in Meter angegeben, wird als Ausgabeflächendichte-Einheit Quadratkilometer festgelegt, sodass für Punkt-Features Quadratkilometer oder für Polylinien-Features Kilometer pro Quadratkilometer ausgegeben werden. Sind die linearen Ausgabeeinheiten in Fuß angegeben, wird als Ausgabeflächendichte-Einheit Quadratmeilen festgelegt.

Sind die linearen Ausgabeeinheiten weder in Meter noch in Fuß angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt. Das heißt, die Einheiten der Ausgabedichte entsprechen dem Quadrat der linearen Einheiten des Ausgabe-Raumbezugs. Sind die linearen Ausgabeeinheiten beispielsweise in Zentimeter angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt, hier also Quadratzentimeter. Sind die linearen Ausgabeeinheiten in Kilometer angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt, hier also Quadratkilometer.

Die verfügbaren Optionen und die entsprechenden Ausgabedichte-Einheiten lauten wie folgt:

  • Quadrat-KarteneinheitenEs wird das Quadrat der linearen Einheiten des Ausgabe-Raumbezugs verwendet.
  • QuadratmeilenEs werden Meilen (US) verwendet.
  • QuadratkilometerEs werden Kilometer verwendet.
  • AcresEs werden Acres (US) verwendet.
  • HektarEs werden Hektar verwendet.
  • QuadratyardEs werden Yards (US) verwendet.
  • QuadratfußEs werden Fuß (US) verwendet.
  • QuadratzollEs werden Zoll (US) verwendet.
  • QuadratmeterEs werden Meter verwendet.
  • QuadratzentimeterEs werden Zentimeter verwendet.
  • QuadratmillimeterEs werden Millimeter verwendet.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für "Punktdichte".

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

PointDensity(in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
NameErläuterungDatentyp
in_point_features

Die Eingabe-Punkt-Features, für die die Dichte berechnet werden soll.

Feature Layer
population_field

Feld, das die Populationswerte für die einzelnen Punkte angibt. Das "Feld mit Grundgesamtheit" ist die Anzahl, die bei der Berechnung einer kontinuierlichen Oberfläche verwendet werden soll.

Das Feld mit Grundgesamtheit kann sowohl Ganzzahl- als auch Gleitkommawerte enthalten.

Die Optionen und das Standardverhalten des Feldes werden weiter unten aufgeführt.

  • Wählen Sie NONE aus, wenn kein Element oder besonderer Wert verwendet und jedes Feature einmal gezählt wird.

  • Wenn die Eingabe-Features Z-Werte enthalten, können Sie das Feld Shape verwenden.

  • Andernfalls lautet die Standardeinstellung POPULATION. Darüber hinaus gelten möglicherweise die folgenden Bedingungen:

    • Wenn das Feld POPULATION nicht vorhanden ist, jedoch ein Feld namens POPULATIONabcd, wird dieses standardmäßig verwendet. Dabei steht "abcd" für beliebige gültige Zeichen, z. B. POPULATION6, POPULATION1974 oder POPULATIONROADTYPE.
    • Wenn keines der Felder POPULATION oder POPULATIONabcd vorhanden ist, jedoch ein Feld namens POP, wird standardmäßig das Feld POP verwendet.
    • Wenn keines der Felder POPULATION, POPULATIONabcd oder POP vorhanden ist, jedoch ein Feld namens POPabcd, wird standardmäßig das Feld POPabcd verwendet.
    • Wenn keines der Felder POPULATION, POPULATIONabcd, POP oder POPabcd vorhanden ist, wird standardmäßig NONE verwendet.
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)

Schreibt die Form der Fläche um jede Zelle vor, die verwendet wird, um den Dichtewert zu berechnen.

Dies ist eine Neighborhood-Klasse.

Es gibt vier Typen von Nachbarschaftsklassen: NbrAnnulus, NbrCircle, NbrRectangle und NbrWedge.

Die Formate und Beschreibungen der Klassen lauten wie folgt:

  • NbrAnnulus ({innerRadius}, {outerRadius}, {units})

    Eine kreisringförmige Nachbarschaft, die durch einen inneren und äußeren Radius definiert ist.

  • NbrCircle ({radius}, {units})

    Eine kreisförmige Nachbarschaft mit dem gegebenen Radius.

  • NbrRectangle ({width}, {height}, {units})

    Eine rechteckige Nachbarschaft mit der gegebenen Breite und Höhe.

  • NbrWedge ({radius}, {startAngle}, {endAngle}, {units})

    Eine keilförmige (tortenförmige) Nachbarschaft. Ein Keil wird durch einen Anfangswinkel, einen Endwinkel und einen Radius angegeben. Der Keil dehnt sich gegen den Uhrzeigersinn vom Anfangswinkel zum Endwinkel aus. Winkel werden in arithmetischen Grad (gegen den Uhrzeigersinn ausgehend von der positiven X-Achse) angegeben. Es können negative Winkel verwendet werden.

  • {units}

    Definiert die Einheiten entweder als Anzahl der Zellen oder als Wert in Karteneinheiten.

Die Standardeinstellung ist NbrCircle, wobei radius der Breite oder Höhe (je nachdem, welcher Wert niedriger ist) der Ausgabeausdehnung im Ausgabe-Raumbezug dividiert durch 30 entspricht.

Neighborhood
area_unit_scale_factor
(optional)

Gibt die Flächeneinheiten für die Ausgabedichtewerte an.

Die Standardeinheit ergibt sich aus der linearen Einheit des Ausgabe-Raumbezugs. Sie können diese Einstellung in die gewünschte Einheit ändern, um die Dichteausgabe zu konvertieren. Bei Werten für die Liniendichte werden die Einheiten von Länge und Fläche gleichermaßen konvertiert.

Wurde kein Ausgabe-Raumbezug angegeben, ist dieser mit der Eingabe-Feature-Class identisch. Die Standardeinheiten der Ausgabedichte ergeben sich aus den linearen Einheiten des Ausgabe-Raumbezugs. Sind die linearen Ausgabeeinheiten in Meter angegeben, wird als Ausgabeflächendichte-Einheit Quadratkilometer festgelegt, sodass für Punkt-Features Quadratkilometer oder für Polylinien-Features Kilometer pro Quadratkilometer ausgegeben werden. Sind die linearen Ausgabeeinheiten in Fuß angegeben, wird als Ausgabeflächendichte-Einheit Quadratmeilen festgelegt.

Sind die linearen Ausgabeeinheiten weder in Meter noch in Fuß angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt. Das heißt, die Einheiten der Ausgabedichte entsprechen dem Quadrat der linearen Einheiten des Ausgabe-Raumbezugs. Sind die linearen Ausgabeeinheiten beispielsweise in Zentimeter angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt, hier also Quadratzentimeter. Sind die linearen Ausgabeeinheiten in Kilometer angegeben, wird als Ausgabeflächendichte-Einheit Quadrat-Karteneinheiten festgelegt, hier also Quadratkilometer.

Die verfügbaren Optionen und die entsprechenden Ausgabedichte-Einheiten lauten wie folgt:

  • SQUARE_MAP_UNITSEs wird das Quadrat der linearen Einheiten des Ausgabe-Raumbezugs verwendet.
  • SQUARE_MILESEs werden Meilen (US) verwendet.
  • SQUARE_KILOMETERSEs werden Kilometer verwendet.
  • ACRESEs werden Acres (US) verwendet.
  • HECTARESEs werden Hektar verwendet.
  • SQUARE_YARDSEs werden Yards (US) verwendet.
  • SQUARE_FEETEs werden Fuß (US) verwendet.
  • SQUARE_INCHESEs werden Zoll (US) verwendet.
  • SQUARE_METERSEs werden Meter verwendet.
  • SQUARE_CENTIMETERSEs werden Zentimeter verwendet.
  • SQUARE_MILLIMETERSEs werden Millimeter verwendet.
String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster für "Punktdichte".

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

Codebeispiel

PointDensity – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Dichte-Raster aus einem Punkt-Shapefile berechnet.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
PointDensity – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Dichte-Raster aus einem Punkt-Shapefile berechnet.

# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point 
#    features that fall within a neighborhood around each cell.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60

# Create the Neighborhood Object
radius = 2500
myNbrCirc = NbrCircle(radius, "MAP")

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")

Lizenzinformationen

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

Verwandte Themen