Punktdichte (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

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"

Bild

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

Verwendung

Syntax

PointDensity (in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
ParameterErlä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 Bevölkerungsfeld kann sowohl Ganzzahl- als auch Gleitkommawerte enthalten.

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

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

  • Wenn das Eingabe-Feature Z-Werte enthält, können Sie auch Shape verwenden.

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

    • Wenn das Feld POPULATION nicht vorhanden ist, es aber ein Feld namens POPULATIONxxxx gibt, wird dieses standardmäßig verwendet. Dabei steht "xxxx" für beliebige gültige Zeichen, z. B. POPULATION6, POPULATION1974 oder POPULATIONROADTYPE.
    • Ist weder ein Feld POPULATION, noch ein Feld POPULATIONxxxx vorhanden, gibt es jedoch ein Feld namens POP, wird dieses standardmäßig verwendet.
    • Ist weder ein Feld POPULATION, noch ein Feld POPULATIONxxxx, noch ein Feld POP vorhanden, gibt es jedoch ein Feld namens POPxxxx, wird dieses standardmäßig verwendet.
    • Ist keines der Felder POPULATION, POPULATIONxxxx, POP oder POPxxxx vorhanden, wird standardmäßig NONE verwendet.
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 die Umgebung nicht festgelegt wurde, wird als Zellengröße die Breite oder Höhe der Ausgabeausdehnung im Ausgabe-Raumbezug dividiert durch 250 verwendet (je nachdem, welcher Wert kleiner ist.

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 Nachbarschafts-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 Standardwert ist NbrCircle, dabei entspricht der Radius der kürzesten Breite oder Höhe der Ausgabe-Ausdehnung im Ausgabe-Raumbezug, dividiert durch 30.

Neighborhood
area_unit_scale_factor
(optional)

Die gewünschten Flächeneinheiten für die Ausgabedichtewerte.

Die Standardeinheit basiert auf der linearen Einheit der Projektion des Ausgaberaumbezugs. Sie können dieses Einstellung in die gewünschte Einheit ändern, wenn Sie die Dichteausgabe konvertieren möchten. Bei Werten für die Liniendichte werden die Einheiten von Länge und Fläche gleichermaßen konvertiert.

Beispiel: Wenn die Eingabeeinheit Meter ist, wird als standardmäßige Ausgabeflächendichteinheit für Punkt-Features Quadratkilometer oder für Polylinien-Features Kilometer pro Quadratkilometer verwendet.

Die Standarddichteeinheit basiert auf der Einheit des Eingabe-Features:

  • SQUARE_MAP_UNITS Für unbekannte Einheiten, Punkt oder Dezimalgrad
  • SQUARE_MILES Für Fuß, Yard, Meile oder Seemeile
  • SQUARE_KILOMETERS Für Meter oder Kilometer
  • SQUARE_INCHES Für Zoll
  • SQUARE_CENTIMETERS Für Zentimeter
  • SQUARE_MILLIMETERS Für Millimeter
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")

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

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

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst
6/5/2014