| 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.
| 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 |
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.
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
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 Null-Hypothese der kreisförmigen Einheitlichkeit ablehnen können. RefValue ist der kritische Wert der Rayleigh-Teststatistik. UnifTest enthält den Text Nonuniform, wenn die Null-Hypothese 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 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.
Der Ausgabe-Feature-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.
Vorsicht:
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.
Parameter
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.
| 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
Das folgende Skript für das 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")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, Qualifizierte Feldnamen, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Wert, Z-Auflösung, Z-Toleranz, XY-Auflösung, XY-Toleranz
Sonderfälle
- Ausgabe-Koordinatensystem
Die Feature-Geometrie wird vor der Analyse auf das Ausgabe-Koordinatensystem projiziert. Alle mathematischen Berechnungen basieren auf dem Raumbezug des Ausgabe-Koordinatensystems.