Liniendichte (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

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

Weitere Informationen zur Funktionsweise des Werkzeugs "Liniendichte"

Abbildung

OutRas = LineDensity(InRds, None, 30)

Verwendung

• Nur der Teil einer Linie, der innerhalb der Nachbarschaft liegt, wird bei der Berechnung der Dichte berücksichtigt. Wenn keine Linien in der Nachbarschaft einer bestimmten Zelle liegen, wird dieser Zelle der Wert "NoData" zugewiesen.

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

• Die Werte im Ausgabe-Raster sind immer Gleitkommawerte.

• Der Parameter 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 im 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 dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

• In Datenformaten, die NULL-Werte unterstützen (z. B. Feature-Classes in File-Geodatabases), wird ein als Eingabe verwendeter NULL-Wert ignoriert.

• Wenn die Maßstabsfaktoren für Flächeneinheiten im Verhältnis zu den Features (Länge der Linienabschnitte) klein sind, sind die Ausgabewerte 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 zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Polylinien-Features	Die Eingabe-Linien-Features, für die die Dichte berechnet werden soll.	Feature Layer
Feld mit Grundgesamtheit	Zahlenfeld, das Bevölkerungswerte (wie oft die Linie gezählt werden soll) für jede Polylinie angibt. 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 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
Suchradius (optional)	Der Suchradius, innerhalb dessen die Dichte berechnet wird. Die Einheit basiert auf der linearen Einheit der Projektion des Ausgaberaumbezugs. Wenn beispielsweise als Einheit Meter verwendet wird und Sie alle Features innerhalb eines Umkreises von einer Meile einschließen möchten, legen Sie einen Suchradius von 1609,344 (1 Meile = 1609,344 Meter) fest. Die Standardeinstellung entspricht der Breite oder Höhe (je nachdem, welcher Wert niedriger ist) der Ausgabeausdehnung im Ausgabe-Raumbezug dividiert durch 30.	Double
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-Karteneinheiten—Es wird das Quadrat der linearen Einheiten des Ausgabe-Raumbezugs verwendet. Quadratmeilen—Es werden Meilen (US) verwendet. Quadratkilometer—Es werden Kilometer verwendet. Acres—Es werden Acres (US) verwendet. Hektar—Es werden Hektar verwendet. Quadratyard—Es werden Yards (US) verwendet. Quadratfuß—Es werden Fuß (US) verwendet. Quadratzoll—Es werden Zoll (US) verwendet. Quadratmeter—Es werden Meter verwendet. Quadratzentimeter—Es werden Zentimeter verwendet. Quadratmillimeter—Es werden Millimeter verwendet.	String

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster für "Liniendichte". Es handelt sich stets um ein Gleitkomma-Raster.	Raster

Python

LineDensity(in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})

Name	Erläuterung	Datentyp
in_polyline_features	Die Eingabe-Linien-Features, für die die Dichte berechnet werden soll.	Feature Layer
population_field	Zahlenfeld, das Bevölkerungswerte (wie oft die Linie gezählt werden soll) für jede Polylinie angibt. 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 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
search_radius (optional)	Der Suchradius, innerhalb dessen die Dichte berechnet wird. Die Einheit basiert auf der linearen Einheit der Projektion des Ausgaberaumbezugs. Wenn beispielsweise als Einheit Meter verwendet wird und Sie alle Features innerhalb eines Umkreises von einer Meile einschließen möchten, legen Sie einen Suchradius von 1609,344 (1 Meile = 1609,344 Meter) fest. Die Standardeinstellung entspricht der Breite oder Höhe (je nachdem, welcher Wert niedriger ist) der Ausgabeausdehnung im Ausgabe-Raumbezug dividiert durch 30.	Double
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_UNITS—Es wird das Quadrat der linearen Einheiten des Ausgabe-Raumbezugs verwendet. SQUARE_MILES—Es werden Meilen (US) verwendet. SQUARE_KILOMETERS—Es werden Kilometer verwendet. ACRES—Es werden Acres (US) verwendet. HECTARES—Es werden Hektar verwendet. SQUARE_YARDS—Es werden Yards (US) verwendet. SQUARE_FEET—Es werden Fuß (US) verwendet. SQUARE_INCHES—Es werden Zoll (US) verwendet. SQUARE_METERS—Es werden Meter verwendet. SQUARE_CENTIMETERS—Es werden Zentimeter verwendet. SQUARE_MILLIMETERS—Es werden Millimeter verwendet.	String

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster für "Liniendichte". Es handelt sich stets um ein Gleitkomma-Raster.	Raster

Codebeispiel

LineDensity – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Dichte-Raster für ein Längenfeld eines Polylinien-Shapefile berechnet.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLDens = LineDensity("roads.shp", "LENGTH", 45, 1000, "SQUARE_MILES") 
outLDens.save("C:/sapyexamples/output/ldensout")

LineDensity – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Dichte-Raster für ein Längenfeld eines Polylinien-Shapefile berechnet.

# Name: LineDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from polyline features
#    that fall within a radius 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
inPolylineFeatures = "roads.shp"
populationField = "length"
cellSize = 120
searchRadius = 1500

# Execute LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
                             searchRadius, "SQUARE_MILES") 

# Save the output 
outLineDensity.save("C:/sapyexamples/output/linedensity")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzinformationen

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