Linearer Richtungsmittelwert (Spatial Statistics Tools)

Zusammenfassung

Identifiziert die mittlere Richtung, die mittlere Länge und den mittleren geographischen Mittelpunkt für einen Satz von Linien.

Weitere Informationen über die Funktionsweise des Werkzeugs "Linearer Richtungsmittelwert"

Abbildung

Abbildung des Werkzeugs "Linearer Richtungsmittelwert"

Verwendung

Die Eingabe muss eine Line-Feature-Class sein.
Bei diesem Werkzeug wird die 3D-Eigenschaft von Punktdaten berücksichtigt, und X-, Y- und Z-Werte werden in den Berechnungen verwendet, wenn Z-Werte verfügbar sind. Da es sich bei diesen Ergebnissen um 3D-Ergebnisse handelt, müssen sie in einer Szene visualisiert werden. Stellen Sie sicher, dass Sie die Analyse in einer Szene ausführen, oder kopieren Sie den Ergebnis-Layer in eine Szene, damit die Analyseergebnisse richtig visualisiert werden.
Wenn die Eingabe-Features 2D-Features sind, enthalten die Attributwerte für das Ausgabe-Linien-Feature Folgendes:
- CompassA—Der Kompasswinkel (im Uhrzeigersinn von Norden aus)
- DirMean—Der Richtungsmittelwert (entgegen dem Uhrzeigersinn von Osten aus)
- CirVar—Die Kreisabweichung (ein Maß dafür, wie stark die Linienrichtungen oder -ausrichtungen vom Richtungsmittelwert abweichen)
- AveX und AveY: Die X- und Y-Koordinaten des Mittelwertes für Mittelpunkt
- AveLen—Die mittlere Linienlänge
Wenn die Eingabe-Features 3D-Features sind, enthalten die Attributwerte für das Ausgabe-Linien-Feature Folgendes:
- CompassA—Der Kompasswinkel (im Uhrzeigersinn von Norden aus) in der XY-Ebene des Richtungsmittelwertes
- DirMean—Der Richtungsmittelwert (entgegen dem Uhrzeigersinn von Osten aus)
- DirMeanZ—Der Winkel zwischen der XY-Ebene und dem Vektor des Richtungsmittelwertes
- SphVar—Die sphäroidische Abweichung (ein Maß dafür, wie stark die Linienrichtungen oder -ausrichtungen vom Richtungsmittelwert abweichen)
- AveX, AveY und AveZ:Die X-, Y- und Z-Koordinaten des Mittelwertes für Mittelpunkt
- AveLen3D—Die in drei Dimensionen berechnete mittlere Linienlänge
Wenn ein Untersuchungsfeld angegeben ist, wird es auch der Ausgabe-Feature-Class hinzugefügt.
Analog zu einem Maß für die Standardabweichung gibt der Wert der Kreisabweichung (CirVar) an, wie gut der Richtungsmittelwertvektor die Eingabevektoren wiedergibt. Kreisabweichungen liegen zwischen 0 und 1. Wenn alle Eingabevektoren gleiche (oder sehr ähnliche) Richtungen aufweisen, ist die Kreisabweichung klein (fast 0). Wenn Eingabevektorrichtungen den gesamten Kompass umfassen, ist die Kreisabweichung groß (fast 1). Dieses Maß wird als SphVar für die sphäroidische Varianz in drei Dimensionen angegeben.
Ein Rayleigh-Einheitlichkeitstest wird für den Richtungsmittelwert durchgeführt. Er gibt an, ob der Richtungsmittelwert deutlich anders ist als eine Gleichverteilung. In 2D bedeutet eine Gleichverteilung, dass die Linien gleichmäßig um den Kompass herum verteilt sind. In 3D bedeutet eine Gleichverteilung, dass die Linien gleichmäßig um eine Kugel herum verteilt sind. ZScore und PValue geben an, ob Sie die Nullhypothese der kreisförmigen Einheitlichkeit ablehnen können. RefValue ist der kritische Wert der Rayleigh-Teststatistik. UnifTest enthält den Text Nonuniform, wenn die Nullhypothese abgelehnt wurde; andernfalls enthält sie den Text Uniform.
Das Untersuchungsfeld wird verwendet, um Features für separate Berechnungen der linearen Richtungsmittelwerte zu gruppieren. Wenn ein Untersuchungsfeld angegeben ist, werden die Eingabe-Linien-Features zuerst nach Untersuchungsfeld-Werten gruppiert; anschließend wird ein Ausgabe-Linien-Feature für jede Gruppe erstellt. Das Untersuchungsfeld kann eine ganze Zahl, ein Datum oder eine Zeichenfolge aufweisen. Datensätze, die für das Untersuchungsfeld NULL-Werte aufweisen, werden aus der Analyse ausgeschlossen.
Beim Messen der Richtung berücksichtigt das Werkzeug nur die ersten und letzten Punkte einer Linie. Das Werkzeug berücksichtigt nicht alle Stützpunkte entlang einer Linie.
Zum Definieren der Eingabe-Feature-Class können Karten-Layer verwendet werden. Beim Verwenden eines Layers mit einer Auswahl sind nur die ausgewählten Features in der Analyse enthalten.
Der Ausgabe-Features-Layer wird dem Inhaltsverzeichnis automatisch mit Standard-Rendering (Richtungsvektoren) hinzugefügt. Das Rendering wird durch eine Layer-Datei in <ArcGIS Pro>\\Resources\\ArcToolBox\\Templates\\Layers definiert. Sie können das Standard-Rendering nach Bedarf erneut anwenden, indem Sie das Werkzeug Symbolisierung aus Layer anwenden verwenden.
Wenn dieses Werkzeug ausgeführt wird, wird die Ausgabe-Feature-Class dem Inhaltsverzeichnis automatisch mit Standard-Rendering (Richtungsvektoren) hinzugefügt. Das Rendering wird durch eine Layer-Datei in <ArcGIS>/ArcToolbox/Templates/Layers definiert. Sie können das Standard-Rendering nach Bedarf erneut anwenden, indem Sie das Werkzeug Symbolisierung aus Layer anwenden verwenden.

Achtung:

Denken Sie beim Verwenden von Shapefiles daran, dass diese keine NULL-Werte speichern können. Werkzeuge oder andere Verfahren zur Erstellung von Shapefiles aus Nicht-Shapefile-Eingaben speichern oder interpretieren NULL-Werte möglicherweise als Wert 0. In manchen Fällen werden NULL-Werte in Shapefiles als sehr große negative Werte gespeichert. Dies kann zu unerwarteten Ergebnissen führen. Weitere Informationen finden Sie unter Überlegungen zur Geoverarbeitung für die Shapefile-Ausgabe.

Beschriftung	Erläuterung	Datentyp
Eingabe-Feature-Class	Die Feature-Class mit Vektoren, für die die mittlere Richtung berechnet wird	Feature Layer
Ausgabe-Feature-Class	Eine Line-Feature-Class, die die Features mit den mittleren Richtungen der Eingabe-Feature-Class enthält.	Feature Class
Nur Ausrichtung	Gibt an, ob Richtungsinformationen (Ausgangs- und Zielknoten) in der Analyse enthalten sind. Aktiviert—Ausgangs- und Zielknoteninformationen werden ignoriert. Deaktiviert—Ausgangs- und Zielknoten werden bei der Berechnung des Mittelwertes berücksichtigt. Dies ist die Standardeinstellung.	Boolean
Untersuchungsfeld (Optional)	Das Feld, das zur Gruppierung von Features für separate Berechnungen des Richtungsmittelwertes verwendet wird. Das Untersuchungsfeld kann eine ganze Zahl, ein Datum oder eine Zeichenfolge aufweisen.	Field

arcpy.stats.DirectionalMean(Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})

Name	Erläuterung	Datentyp
Input_Feature_Class	Die Feature-Class mit Vektoren, für die die mittlere Richtung berechnet wird	Feature Layer
Output_Feature_Class	Eine Line-Feature-Class, die die Features mit den mittleren Richtungen der Eingabe-Feature-Class enthält.	Feature Class
Orientation_Only	Gibt an, ob Richtungsinformationen (Ausgangs- und Zielknoten) in der Analyse enthalten sind. `ORIENTATION_ONLY`—Ausgangs- und Zielknoteninformationen werden ignoriert. `DIRECTION`—Ausgangs- und Zielknoten werden bei der Berechnung des Mittelwertes berücksichtigt. Dies ist die Standardeinstellung.	Boolean
Case_Field (Optional)	Das Feld, das zur Gruppierung von Features für separate Berechnungen des Richtungsmittelwertes verwendet wird. Das Untersuchungsfeld kann eine ganze Zahl, ein Datum oder eine Zeichenfolge aufweisen.	Field

Codebeispiel

LinearDirectionalMean Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion LinearDirectionalMean verwenden.

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.DirectionalMean("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION")

LinearDirectionalMean Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion LinearDirectionalMean verwenden.

# Measure the geographic distribution of auto thefts

# Import system modules
import arcpy

# Local variables...
workspace = "C:/data"
locations = "AutoTheft.shp"
links = "AutoTheft_links.shp"
standardDistance = "auto_theft_SD.shp"
stardardEllipse = "auto_theft_SE.shp"
linearDirectMean = "auto_theft_LDM.shp"

# Set the workspace (to avoid having to type in the full path to the data every
# time)
arcpy.env.workspace = workspace

# Process: Standard Distance of auto theft locations...
arcpy.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")

# Process: Directional Distribution (Standard Deviational Ellipse) of auto
# theft locations...
arcpy.stats.DirectionalDistribution(locations, standardEllipse,
                                    "1_STANDARD_DEVIATION")

# Process: Linear Directional Mean of auto thefts...
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")

Umgebungen

Ausgabe-Koordinatensystem, Geographische Transformationen, Aktueller Workspace, Scratch-Workspace, Vollständig qualifizierte Feldnamen beibehalten, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Werte, Z-Auflösung, Z-Toleranz, XY-Auflösung, XY-Toleranz

Sonderfälle

Ausgabe-Koordinatensystem: Feature geometry is projected to the output coordinate system prior to analysis. All mathematical computations are based on the output coordinate system spatial reference.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja