Linie an Punkt teilen (Data Management)

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

BeschriftungErläuterungDatentyp
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

arcpy.management.SplitLineAtPoint(in_features, point_features, out_feature_class, {search_radius})
NameErläuterungDatentyp
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

SplitLineAtPoint: Beispiel 1 (Python-Fenster)

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")
SplitLineAtPoint: Beispiel 2 (eigenständiges Skript)

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)

Verwandte Themen