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
Verwendung
Die Eingabe muss eine Line-Feature-Class sein.
Zu den Attributwerten für das Ausgabe-Linien-Feature gehören die folgenden:
- CompassA: Kompasswinkel (im Uhrzeigersinn von genau Norden)
- DirMean: Richtungsmittelwert (gegen den Uhrzeigersinn von genau Osten)
- CirVar: Kreisabweichung (gibt an, um wie viel Linienrichtungen oder -ausrichtungen vom Richtungsmittelwert abweichen)
- AveX und AveY: X- und Y-Koordinate des arithmetischen Mittelpunktes
- AveLen: Länge der Mittellinie
Analog zu einem Standardabweichungsmesswert gibt der Kreisabweichungswert (CirVar) an, wie gut der Richtungsmittelwertvektor den Satz von Eingabevektoren darstellt. 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). Dieser Messwert wird für die sphäroidische Varianz in drei Dimensionen als SphVar angegeben.
Das Case-Feld wird verwendet, um Features für separate Berechnungen des linearen Richtungsmittelwertes zu gruppieren. Wenn ein Case-Feld angegeben wird, werden die Eingabe-Linien-Features zuerst nach Case-Feld-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.
-
Sie können Karten-Layer verwenden, um die Eingabe-Feature-Class zu definieren. Beim Verwenden eines Layers mit einer Auswahl sind nur die ausgewählten Features in der Analyse enthalten.
-
Die Ausgabe-Features werden dem Inhaltsverzeichnis automatisch mit Standard-Rendering (Richtungsvektoren) hinzugefügt. Das Rendering wird durch eine Layer-Datei in <ArcGIS>/Desktop10.x/ArcToolbox/Templates/Layers definiert. Sie können das Standard-Rendering nach Bedarf erneut anwenden, indem Sie die Vorlagen-Layer-Symbolisierung importieren.
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 die Vorlagen-Layer-Symbolisierung importieren.
Syntax
arcpy.stats.DirectionalMean(Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})
Parameter | Erklärung | 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.
| 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 veranschaulicht, wie das Werkzeug LinearDirectionalMean im Python-Fenster verwendet wird.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalMean_stats("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION")
LinearDirectionalMean – Beispiel 2 (eigenständiges Skript)
Das folgende eigenständige Python-Skript veranschaulicht, wie Sie das Werkzeug 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.StandardDistance_stats(locations, standardDistance, "1_STANDARD_DEVIATION")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations...
arcpy.DirectionalDistribution_stats(locations, standardEllipse, "1_STANDARD_DEVIATION")
# Process: Linear Directional Mean of auto thefts...
arcpy.DirectionalMean_stats(links, linearDirectMean, "DIRECTION")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja