Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Eingabe-Linien-Features, die geteilt werden sollen. | Feature Layer |
Punkt-Features | Die Eingabe-Punkt-Features, deren Positionen zum Teilen der Eingabelinien herangezogen werden. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Feature-Class, die die geteilten Linien enthält. | Feature Class |
Suchradius (optional) | Die Entfernung, mit der Linien anhand ihrer Nähe zu Punkt-Features geteilt werden. Um Linien an der nächsten Position zum Punkt entlang des Liniensegments zu teilen, werden Punkte innerhalb der Suchentfernung zu einer Eingabelinie verwendet. Wird dieser Parameter nicht angegeben, wird das Linien-Feature mithilfe des einzelnen nächsten Punktes geteilt. Wird ein Radius angegeben, wird die Linie mit allen Punkten innerhalb des Radius geteilt. | Linear Unit |
Zusammenfassung
Teilt Linien-Features auf Grundlage eines Schnittpunktes oder der Nähe zu Punkt-Features.
Verwendung
Die Attribute der Eingabe-Features werden in der Ausgabe-Feature-Class beibehalten. Der Ausgabe-Feature-Class werden die folgenden Felder hinzugefügt:
- ORIG_FID: Speichert die Feature-ID der Eingabe-Features
- ORIG_SEQ: Speichert die Sequenznummer für jede Ausgabelinie, die der Reihenfolge der Segmente ab dem Startstützpunkt des Eingabe-Features folgt
Wird kein Wert für den Parameter Suchradius angegeben, wird das Linien-Feature mithilfe des nächstgelegenen Punktes geteilt. Wenn mehrere Punkte lagegleich mit der Linie sind, wird nur einer der Punkte zum Teilen der Linie verwendet. Wird ein Wert für den Parameter Suchradius angegeben, wird die Linie mit allen Punkten innerhalb des Suchradius geteilt.
Um genaue Ergebnisse zu erzielen, sollten Sie ein projiziertes Koordinatensystem für die Eingaben verwenden. Sie können das Werkzeug Projizieren verwenden, um räumliche Daten aus einem geographischen Koordinatensystem in ein projiziertes Koordinatensystem zu projizieren, bevor Sie das Werkzeug Linie an Punkt teilen verwenden.
Parameter
arcpy.management.SplitLineAtPoint(in_features, point_features, out_feature_class, {search_radius})
Name | Erläuterung | Datentyp |
in_features | Die Eingabe-Linien-Features, die geteilt werden sollen. | Feature Layer |
point_features | Die Eingabe-Punkt-Features, deren Positionen zum Teilen der Eingabelinien herangezogen werden. | Feature Layer |
out_feature_class | Die Ausgabe-Feature-Class, die die geteilten Linien enthält. | Feature Class |
search_radius (optional) | Die Entfernung, mit der Linien anhand ihrer Nähe zu Punkt-Features geteilt werden. Um Linien an der nächsten Position zum Punkt entlang des Liniensegments zu teilen, werden Punkte innerhalb der Suchentfernung zu einer Eingabelinie verwendet. Wird dieser Parameter nicht angegeben, wird das Linien-Feature mithilfe des einzelnen nächsten Punktes geteilt. Wird ein Radius angegeben, wird die Linie mit allen Punkten innerhalb des Radius geteilt. | Linear Unit |
Codebeispiel
Dieses Beispiel zeigt, wie die Funktion SplitLineAtPoint in einem Python-Fenster ausgeführt wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SplitLineAtPoint("streets.shp", "events.shp",
"splitline_out.shp", "20 Meters")
In diesem Beispiel wird gezeigt, wie die Funktion SplitLineAtPoint mit einem Python-Skript ausgeführt wird.
# Name: SplitLineAtPoint_Example.py
# Description: Split line features based on near point features.
import arcpy
arcpy.env.workspace = "C:/data"
inFeatures = "streets.shp"
pointFeatures = "events.shp"
outFeatureclass = "splitline_out.shp"
searchRadius = "20 Meters"
arcpy.management.SplitLineAtPoint(inFeatures, pointFeatures, outFeatureclass,
searchRadius)