Feature in Linie (Data Management Tools)

Zusammenfassung

Hiermit wird eine Feature-Class mit Linien erstellt, die durch Konvertieren von Polygongrenzen in Linien oder durch Teilen von Linien- oder Polygon-Features oder von beiden Features an ihren Schnittpunkten generiert werden.

Abbildung

Abbildung: Werkzeug "Feature in Linie"

Verwendung

Eingabeattribute können optional in der Ausgabe-Feature-Class beibehalten werden. Dies wird über den Parameter Attribute beibehalten festgelegt.
Wenn mehrere Feature-Classes oder -Layer in der Liste der Eingabe-Features angegeben werden, wirkt sich die Reihenfolge der Einträge in der Liste nicht auf den Ausgabe-Feature-Typ aus, aber der Raumbezug des ersten Wertes des Parameters Eingabe-Features wird während der Verarbeitung verwendet und auf die Ausgabe festgelegt.
Wenn sich Eingabelinien oder -Polygongrenzen an anderen Stellen als an den Start- oder Endstützpunkten berühren, kreuzen oder überlappen, werden sie an diesen Schnittpunkten geteilt. Jede der geteilten Linien wird zu einem Ausgabe-Linien-Feature. Wenn eine Eingabelinie oder -Polygongrenze nicht von einem anderen Feature geschnitten wird, wird ihr gesamtes Shape trotzdem als Linien-Feature ausgeschrieben.
Bei Multipart-Eingabe-Features haben die Ausgabelinien den Typ "Singlepart".
Bei Eingabe-Features, die parametrische (echte) Kurven sind, bleiben die Ausgabelinien auch bei Teilung echte Kurven. Dies gilt nicht für Shapefile-Daten.
Wenn der Parameter Attribute beibehalten aktiviert ist, werden die Attribute aller Eingabeeinträge in der Ausgabe in der Reihenfolge beibehalten, in der sie in der Eingabeliste aufgeführt sind. Der Ausgabe wird für jeden Eingabeeintrag ein neues Feld, FID_xxx, hinzugefügt und auf die Quell-Feature-IDs festgelegt, wobei "xxx" der Name der Quell-Feature-Class eines bestimmten Eingabeeintrags ist. Die Ausgabelinien werden mit ihren Attributen auf folgende Weise verknüpft:
- Bei lagegleichen Linien oder Polygongrenzen in demselben Eingabe-Feature-Set, z. B. der Grenze zwischen zwei Polygonen, werden zwei Linien-Features mit identischer Geometrie in die Ausgabe geschrieben. Beide weisen die Attribute ihres Quell-Features auf.
- Bei lagegleichen Linien oder Polygongrenzen aus zwei verschiedenen Eingabe-Feature-Sets, z. B. einer Linie, die eine Polygongrenze überlappt, wird nur ein Linien-Feature mit den Attributen beider Quell-Features in die Ausgabe geschrieben.
- Wenn eine Ausgabelinie kein Feature in einem bestimmten Eingabe-Feature-Set überlappt, weist das Feld "FID_xxx" den Wert -1 auf, und die anderen Felder aus diesem Feature-Set weisen den Wert 0 oder NULL-Werte auf.
Wenn der Parameter Attribute beibehalten deaktiviert ist, wird keines der Eingabeattribute in der Ausgabe-Feature-Class beibehalten. Ein einzelnes Linien-Feature wird für jeden Satz von lagegleichen Linien oder Polygongrenzen in die Ausgabe geschrieben.
Wenn Eingabe-Features benachbarte Polygone enthalten, verwenden Sie stattdessen das Werkzeug Polygon in Linie, um die gemeinsame Grenzlinie mit den IDs des linken und des rechten Polygon-Features als Attribute in der Ausgabe zu erhalten.
Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter "Gekachelte Verarbeitung großer Datasets".

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Features, die den Typ "Linie" oder "Polygon" oder beides haben können.	Feature Layer
Ausgabe-Feature-Class	Die Ausgabe-Line-Feature-Class	Feature Class
XY-Toleranz (Optional)	Der Mindestabstand zwischen allen Feature-Koordinaten sowie die Strecke, um die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) während einer räumlichen Berechnung bewegt werden kann. Der Standardwert beträgt 0,001 Meter oder dessen Äquivalent in Feature-Einheiten. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit
Attribute beibehalten (Optional)	Gibt an, ob die Eingabeattribute in der Ausgabe-Feature-Class beibehalten oder weggelassen werden sollen. Aktiviert—Die Eingabeattribute werden in den Ausgabe-Features beibehalten. Dies ist die Standardeinstellung. Deaktiviert—Die Eingabeattribute werden in den Ausgabe-Features weggelassen.	Boolean

arcpy.management.FeatureToLine(in_features, out_feature_class, {cluster_tolerance}, {attributes})

Name	Erläuterung	Datentyp
in_features [in_features,...]	Die Eingabe-Features, die den Typ "Linie" oder "Polygon" oder beides haben können.	Feature Layer
out_feature_class	Die Ausgabe-Line-Feature-Class	Feature Class
cluster_tolerance (Optional)	Der Mindestabstand zwischen allen Feature-Koordinaten sowie die Strecke, um die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) während einer räumlichen Berechnung bewegt werden kann. Der Standardwert beträgt 0,001 Meter oder dessen Äquivalent in Feature-Einheiten. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit
attributes (Optional)	Gibt an, ob die Eingabeattribute in der Ausgabe-Feature-Class beibehalten oder weggelassen werden sollen. `ATTRIBUTES`—Die Eingabeattribute werden in den Ausgabe-Features beibehalten. Dies ist die Standardeinstellung. `NO_ATTRIBUTES`—Die Eingabeattribute werden in den Ausgabe-Features weggelassen.	Boolean

Codebeispiel

FeatureToLine: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion FeatureToLine im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToLine(["majorrds.shp", "habitat_analysis.gdb/futrds"],
                               "c:/output/output.gdb/allroads",
                               "0.001 Meters", "ATTRIBUTES")

FeatureToLine: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Anwendung der Funktion FeatureToLine in einer Skriptumgebung.

# Name: FeatureToLine_Example2.py
# Description: Use FeatureToLine function to combine features from two
#                  street feature classes into a single feature class,
#                  then determine an area of impact around all streets
#                  by buffering

# import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

#  Set local variables
oldStreets = "majorrds.shp"
newStreets = "habitat_analysis.gdb/futrds"
uptodateStreets = "c:/output/output.gdb/allroads"

# Use FeatureToLine function to combine features into single feature class
arcpy.management.FeatureToLine([oldStreets, newStreets], uptodateStreets,
                               "0.001 Meters", "ATTRIBUTES")

# Use Buffer function to determine area of impact around streets
roadsBuffer = "c:/output/output.gdb/buffer_output"
arcpy.analysis.Buffer(uptodateStreets, roadsBuffer, "50 Feet",
                      "FULL", "ROUND", "ALL")

Umgebungen

Aktueller Workspace, Scratch-Workspace, Standard-Ausgabe-Z-Werte, M-Auflösung, M-Toleranz, Ausgabe-M-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Lizenzierungsinformationen

Basic: Nein
Standard: Ja
Advanced: Ja