Dichte berechnen (GeoAnalytics Desktop)

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 von Zeitschritten

Abbildung

Abbildung des Werkzeugs "Dichte berechnen"

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.

    Hexagonale und quadratische Abschnitte

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

    FeldnameBeschreibung

    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:

Parameter

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

  • SquareDas Abschnitts-Shape ist quadratisch. Dies ist die Standardeinstellung.
  • HexagonDas Abschnitts-Shape ist sechseckig.
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.

  • EinheitlichEine Berechnung der Größe pro Fläche, in der jeder Abschnitt gleich gewichtet wird, wird verwendet. Dies ist die Standardeinstellung.
  • KernelEine Berechnung der Größe pro Fläche mit einem Glättungsalgorithmus (Kernel) wird verwendet, bei dem Abschnitte, die näher an den Punkten liegen, stärker gewichtet werden.
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.

  • Internationale AcresDie Flächeneinheiten sind internationale Acres.
  • HektarDie Flächeneinheiten sind Hektar.
  • Quadratmeilen (Britisch)Die Flächeneinheiten sind Quadratmeilen.
  • QuadratkilometerDie Flächeneinheiten sind Quadratkilometer.
  • QuadratmeterDie Flächeneinheiten sind Quadratmeter.
  • Quadratfuß (International)Die Flächeneinheiten sind internationale Quadratfuß.
  • Quadratyards (International)Die Flächeneinheiten sind internationale Quadratyards.
  • Quadratmeilen (US Survey)Die Flächeneinheiten sind US Survey Quadratmeilen.
  • Quadratfuß (US Survey)Die Flächeneinheiten sind US Survey Quadratfuß.
  • Quadratyards (US Survey)Die Flächeneinheiten sind US Survey Quadratyards.
  • Acres (US Survey)Die Flächeneinheiten sind US Survey Acres.
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

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})
NameErläuterungDatentyp
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.

  • SQUAREDas Abschnitts-Shape ist quadratisch. Dies ist die Standardeinstellung.
  • HEXAGONDas Abschnitts-Shape ist sechseckig.
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.

  • UNIFORMEine Berechnung der Größe pro Fläche, in der jeder Abschnitt gleich gewichtet wird, wird verwendet. Dies ist die Standardeinstellung.
  • KERNELEine Berechnung der Größe pro Fläche mit einem Glättungsalgorithmus (Kernel) wird verwendet, bei dem Abschnitte, die näher an den Punkten liegen, stärker gewichtet werden.
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.

  • ACRESDie Flächeneinheiten sind internationale Acres.
  • HECTARESDie Flächeneinheiten sind Hektar.
  • SQUARE_MILESDie Flächeneinheiten sind Quadratmeilen.
  • SQUARE_KILOMETERSDie Flächeneinheiten sind Quadratkilometer.
  • SQUARE_METERSDie Flächeneinheiten sind Quadratmeter.
  • SQUARE_FEETDie Flächeneinheiten sind Quadratfuß.
  • SQUARE_YARDSDie Flächeneinheiten sind Quadratyards.
  • SQUARE_MILES_USDie Flächeneinheiten sind US Survey Quadratmeilen.
  • SQUARE_FEET_USDie Flächeneinheiten sind US Survey Quadratfuß.
  • SQUARE_YARDS_USDie Flächeneinheiten sind US Survey Quadratyards.
  • ACRES_USDie Flächeneinheiten sind US Survey Acres.
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

CalculateDensity – Beispiel (eigenständiges Skript)

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)