| Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Die Punkte, die zum Berechnen der Dichte verwendet werden. | Feature Layer |
Ausgabe-Feature-Class | Eine neue Feature-Class mit berechneten Dichtewerten. | Feature Class |
Abschnittstyp | Gibt das Abschnitts-Shape an, das in der Analyse verwendet wird.
| String |
Abschnittsgröße | Die Größe der Abschnitte, die zum Aggregieren von Eingabe-Features verwendet werden. Beim Erstellen von Abschnitten für Quadrate bestimmen die angegebene Zahl und die Einheiten die Höhe und Länge des Quadrats. Bei Hexagonen wird anhand der angegebenen Zahl und der Einheiten die Entfernung zwischen parallelen Seiten festgelegt. | Linear Unit |
Gewichtung | Gibt die Gewichtung an, die auf die Dichtefunktion angewendet wird.
| String |
Nachbarschaftsgröße | Der Suchradius, der für Dichteberechnungen angewendet wird. | Linear Unit |
Felder (optional) | Mindestens ein Feld, das die Grundgesamtheitswerte für die einzelnen Features angibt. Das "Feld mit Grundgesamtheit" ist die Anzahl oder Menge, die über die Landschaft verteilt werden soll, um eine kontinuierliche Oberfläche zu erstellen. Werte im Feld mit der Grundgesamtheit müssen numerisch sein. Standardmäßig wird die Dichte der Anzahl der Eingabepunkte immer berechnet. | Field |
Maßstabsfaktor für Flächeneinheiten (optional) | Gibt die Flächeneinheiten an, die für die Ausgabedichtewerte verwendet werden sollen. Die Standardeinheit basiert auf den Einheiten des Ausgabe-Raumbezugs.
| String |
Zeitschrittintervall (optional) | Ein Wert, der die Dauer des Zeitschritts angibt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. Zeitschritte können nur angewendet werden, wenn in der Eingabe Zeiteigenschaften aktiviert sind. | Time Unit |
Zeitschrittwiederholung (optional) | Ein Wert, der die Frequenz der Zeitschrittintervalle festlegt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. | Time Unit |
Zeitschrittbezug (optional) | Ein Datum, das die Bezugszeit festlegt, mit der die Zeitintervalle abgeglichen werden sollen. Die Standardeinstellung ist 1. Januar 1970 um 00:00 Uhr. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. | Date |
Zusammenfassung
Berechnet die Größe pro Flächeneinheit auf Basis von Punkt-Features, die sich innerhalb einer bestimmten Nachbarschaft um die einzelnen Zellen befinden.
Abbildung
Verwendung
-
Das Werkzeug Dichte berechnen erfordert eine einzelne Eingabe von Punkt-Features.
-
Die Dichte kann anhand eines oder mehrerer Zählfelder berechnet werden. Ein Zählfeld ist ein numerisches Feld, das die Anzahl der Ereignisse an jedem Standort angibt. Features wie Städte oder Fernstraßen können ein Zählfeld zum Berechnen der Bevölkerungs- bzw. Verkehrsdichte nutzen. Wenn Sie ein Zählfeld angeben, wird die Dichte für das Zählfeld zusätzlich zur Dichte der Punkte berechnet.
-
Für die Analyse werden die Eingabepunkte in Abschnitte aggregiert. Sie müssen die Größe der Abschnitte, in die die Daten aggregiert werden sollen, angeben. Ausgabeergebnisse werden standardmäßig in Quadratkilometer angegeben.
-
Eingabepunkte werden in Abschnitte mit einer angegebenen Größe und Form (Hexagon oder Quadrat) aggregiert. Beim Aggregieren in Hexagone entspricht die Abschnittsgröße d der Höhe jedes Hexagons und die Breite des resultierenden Hexagons der doppelten Höhe dividiert durch die Quadratwurzel von 3. Beim Aggregieren in Quadrate entspricht die Abschnittsgröße d der Höhe des Quadrats und damit der Breite.
-
Sie müssen eine Nachbarschaftsgröße angeben, die größer als die Abschnittsgröße ist. Die Nachbarschaftsgröße wird verwendet, um Eingabe-Features in derselben Nachbarschaft wie das gewünschte Feature (Abschnitt) zu suchen.
Größere Werte bei der Nachbarschaftsgröße ergeben eine stärker generalisierte Dichteausgabe. Kleinere Werte erzeugen eine Ausgabe, in der weitere Details angezeigt werden.
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 kein Wert zugewiesen.
-
Zum Berechnen der Dichte gibt es zwei Gewichtungsoptionen: Bei der Option Einheitlich werden alle Werte in der Nachbarschaft summiert und durch die Fläche dividiert. Bei der Option Kernel werden die Werte in der Nachbarschaft nach Entfernung vom gewünschten Feature gewichtet. Danach wird eine Kernel-Funktion verwendet, um für jeden Punkt eine sanft abgeschrägte Oberfläche anzupassen.
-
Zurückgegeben werden nur Flächen in der Nachbarschaft eines Abschnittes mit Punkten.
Wenn die Maßstabsfaktoreinheiten für Flächeneinheiten im Verhältnis zur Entfernung zwischen den Punkten klein sind, sind die Ausgabewerte möglicherweise auch sehr klein. Um größere Werte zu erhalten, verwenden Sie den Flächeneinheits-Maßstabsfaktor für größere Einheiten (verwenden Sie z. B. Quadratkilometer statt Quadratmeter).
Für Analysen mit Diskretisierung ist es erforderlich, dass die Eingabe projiziert oder das Ausgabe-Koordinatensystem auf ein projiziertes Koordinatensystem festgelegt wird. Wenn sich die Daten nicht in einem projizierten Koordinatensystem befinden und Sie keines einrichten, wird eine Projektion anhand der Ausdehnung der analysierten Daten verwendet.
Die Dichtewerte sind immer Gleitkommawerte.
-
Mit Dichte berechnen können Sie Analysen mithilfe von Zeitschritten durchführen. Jedes Zeitintervall wird unabhängig von den Features außerhalb des Zeitintervalls analysiert. Für die Verwendung von Zeitintervallen müssen Zeiteigenschaften für die Eingabedaten aktiviert sein und ein Zeitintervall darstellen. Bei Anwendung von Zeitschritten sind Ausgabe-Features Zeitintervalle, die durch die Felder dargestellt werden.
Wenn Eingabe-Features mit Zeitschritten analysiert werden, wird die Analyse für jeden Zeitschritt unabhängig von Features außerhalb des Zeitschritts ausgeführt.
Der Parameter Zeitintervallbezug kann einen Datums- und Uhrzeitwert oder nur einen Datumswert aufweisen, jedoch nicht nur einen Uhrzeitwert.
Folgende Felder sind in den Ausgabe-Features enthalten:
Feldname Beschreibung density
Die Dichte des angegebenen Polygons. Dieser Wert wird im Skalierungsfaktor der angegebenen Einheit zurückgegeben.
density_<fieldname>
Die nach einem bestimmten Feld gewichtete Dichte. Dieser Wert wird nur zurückgegeben, wenn mindestens ein Feld angegeben wird.
start_date
Wenn die Verwendung von Zeitschritten angegeben wird, weisen Ausgabe-Polygone ein Zeitintervall auf. Dieses Feld stellt die Startzeit dar.
end_date
Wenn die Verwendung von Zeitschritten angegeben wird, weisen Ausgabe-Polygone ein Zeitintervall auf. Dieses Feld stellt die Endzeit dar.
Mithilfe der folgenden Angaben können Sie die Performance des Werkzeugs Dichte berechnen verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Größere Abschnitte sind leistungsfähiger als kleinere Abschnitte. Wenn Sie nicht sicher sind, welche Größe Sie verwenden sollen, beginnen Sie mit einem größeren Abschnitt.
- Wie bei den Abschnitten sind auch größere Zeitintervalle leistungsfähiger als kleinere Zeitintervalle.
- Reduzieren Sie den Anteil der Nachbarschaftsgröße auf die Abschnittsgröße. Eine Nachbarschaftsgröße, die dreimal so groß ist wie der Abschnitt, ist leistungsfähiger als eine, die zehnmal so groß ist wie der Abschnitt.
- Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Bei Analysen auf Ihrem Desktop-Computer werden mehrere Kerne parallel verwendet. Weitere Informationen über die Ausführung der Analyse finden Sie unter Überlegungen zu GeoAnalytics Desktop-Werkzeugen.
Bei der Ausführung von GeoAnalytics Desktop-Werkzeugen wird die Analyse auf Ihrem Desktop-Computer durchgeführt. Für eine optimale Performance sollten die Daten auf Ihrem Desktop verfügbar sein. Wenn Sie einen gehosteten Feature-Layer verwenden, wird empfohlen, ArcGIS GeoAnalytics Server zu verwenden. Wenn Ihre Daten nicht lokal verfügbar sind, dauert die Ausführung eines Werkzeugs bedeutend länger. Informationen zur Verwendung von ArcGIS GeoAnalytics Server für Analysen finden Sie unter GeoAnalytics Tools.
Ähnliche Analysen können auch mit Folgendem durchgeführt werden:
- Punkte aggregieren in der Toolbox GeoAnalytics Desktop oder in der Toolbox GeoAnalytics Server
- Werkzeug Punktdichte in der Toolbox "Spatial Analyst"
- Werkzeug Kerndichte in der Toolbox "Spatial Analyst"
- Werkzeug Dichte berechnen in der Toolbox "Standard Feature Analysis"
Parameter
arcpy.geoanalytics.CalculateDensity(input_layer, out_feature_class, bin_type, bin_size, weight, neighborhood_size, {fields}, {area_unit_scale_factor}, {time_step_interval}, {time_step_repeat}, {time_step_reference})| Name | Erläuterung | Datentyp |
input_layer | Die Punkte, die zum Berechnen der Dichte verwendet werden. | Feature Layer |
out_feature_class | Eine neue Feature-Class mit berechneten Dichtewerten. | Feature Class |
bin_type | Gibt das Abschnitts-Shape an, das in der Analyse verwendet wird.
| String |
bin_size | Die Größe der Abschnitte, die zum Aggregieren von Eingabe-Features verwendet werden. Beim Erstellen von Abschnitten für Quadrate bestimmen die angegebene Zahl und die Einheiten die Höhe und Länge des Quadrats. Bei Hexagonen wird anhand der angegebenen Zahl und der Einheiten die Entfernung zwischen parallelen Seiten festgelegt. | Linear Unit |
weight | Gibt die Gewichtung an, die auf die Dichtefunktion angewendet wird.
| String |
neighborhood_size | Der Suchradius, der für Dichteberechnungen angewendet wird. | Linear Unit |
fields [fields,...] (optional) | Mindestens ein Feld, das die Grundgesamtheitswerte für die einzelnen Features angibt. Das "Feld mit Grundgesamtheit" ist die Anzahl oder Menge, die über die Landschaft verteilt werden soll, um eine kontinuierliche Oberfläche zu erstellen. Werte im Feld mit der Grundgesamtheit müssen numerisch sein. Standardmäßig wird die Dichte der Anzahl der Eingabepunkte immer berechnet. | Field |
area_unit_scale_factor (optional) | Gibt die Flächeneinheiten an, die für die Ausgabedichtewerte verwendet werden sollen. Die Standardeinheit basiert auf den Einheiten des Ausgabe-Raumbezugs.
| String |
time_step_interval (optional) | Ein Wert, der die Dauer des Zeitschritts angibt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. Zeitschritte können nur angewendet werden, wenn in der Eingabe Zeiteigenschaften aktiviert sind. | Time Unit |
time_step_repeat (optional) | Ein Wert, der die Frequenz der Zeitschrittintervalle festlegt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. | Time Unit |
time_step_reference (optional) | Ein Datum, das die Bezugszeit festlegt, mit der die Zeitintervalle abgeglichen werden sollen. Die Standardeinstellung ist 1. Januar 1970 um 00:00 Uhr. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen. | Date |
Codebeispiel
Das folgende eigenständige Skript veranschaulicht, wie die Funktion CalculateDensity verwendet wird.
# Name: CalculateDensity.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/HealthInfo.gdb"
# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\outbreaks.lyrx'
# MakeFeatureLayer converts the .lyrx to features
outbreaksLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "outbreaks_layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(outbreaksLayer, inputLyrx)
# By default, the count of points will be used in addition to any other fields
# that are specified
fields = "Severity"
# Set the size of bins and neighborhood and the time step size
binSize = "1 Kilometers"
neighborhoodSize = "2 Kilometers"
timeStepInterval = "1 Weeks"
# Specify output info
out = "OutbreakDensity"
# Run Calculate Density
arcpy.gapro.CalculateDensity(outbreaksLayer, out, 'HEXAGON', binSize,
'UNIFORM', neighborhoodSize, fields,
'SQUARE_KILOMETERS', timeStepInterval)