Linearer Richtungsmittelwert (Räumliche Statistiken)

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"

Bild

Verwendung

• Die Eingabe muss eine Line-Feature-Class sein.

• Attributwerte für die Ausgabe-Linien-Features umfassen CompassA für den Kompasswinkel (im Uhrzeigersinn von Norden), DirMean für den Richtungsmittelwert (gegen den Uhrzeigersinn von Osten), CirVar für die Kreisabweichung (gibt an, wie viele Linienrichtungen oder -ausrichtungen vom Richtungsmittelwert abweichen), AveX und AveY für die X- und Y-Koordinaten des arithmetischen Mittelpunktes und AveLen für die mittlere Länge. Wenn ein Untersuchungsfeld angegeben ist, wird es auch der Ausgabe-Feature-Class hinzugefügt.

• Analog zu einem Standardabweichungsmesswert gibt der Kreisabweichungswert 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).

• Das Untersuchungsfeld wird verwendet, um Features für separate Berechnungen des linearen Richtungsmittelwertes zu gruppieren. Wenn ein Untersuchungsfeld angegeben wird, 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 Ganzzahl, 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.

• Wenn dieses Werkzeug in ArcMap ausgeführt wird, wird dem Inhaltsverzeichnis mit Standard-Rendering (Richtungsvektoren) die Ausgabe-Feature-Class automatisch 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-Symbologie importieren.

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.

Syntax

DirectionalMean_stats (Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})

Parameter	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	DIRECTION —Ausgangs- und Zielknoteninformationen werden ignoriert. ORIENTATION_ONLY —Ausgangs- und Zielknoten werden bei der Berechnung des Mittelwertes (Standardwert) berücksichtigt.	Boolean
Case_Field (optional)	Das Feld, das zur Gruppierung von Features für separate Berechnungen des Richtungsmittelwertes verwendet wird. Das Untersuchungsfeld kann eine Ganzzahl, ein Datum oder eine Zeichenfolge aufweisen.	Field

Codebeispiel

LinearDirectionalMean – Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug "LinearDirectionalMean" verwenden.

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

LinearDirectionalMean – Beispiel (eigenständiges Python-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"
 
try:
    # 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", "#")
 
except:
    # If an error occurred while running a tool, print the messages 
    print arcpy.GetMessages()

Umgebung

Output Coordinate System, Current Workspace, Scratch Workspace, Qualified Field Names, Output has M values, Output has Z values, Default Output Z Value

Output Coordinate System

Die Feature-Geometrie wird vor der Analyse auf das Ausgabe-Koordinatensystem projiziert.

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja

ArcGIS for Desktop Standard: Ja

ArcGIS for Desktop Advanced: Ja