Turn-Feature-Class erstellen (Network Analyst)

Zusammenfassung

Erstellt eine Turn-Feature-Class, um Kantenübergangs-Features zu speichern, mit denen Richtungsänderungen in einem Netzwerk-Dataset modelliert werden.

Verwendung

  • Sie können einem Netzwerk nur dann eine Turn-Feature-Class als Kantenübergangsquellen hinzufügen, wenn Kantenübergänge vom Netzwerk-Dataset unterstützt werden. Um einem Netzwerk Kantenübergänge hinzuzufügen, das keine Kantenübergänge unterstützt, erstellen Sie ein neues Netzwerk-Dataset mit Unterstützung für Kantenübergänge.

  • Nach dem Erstellen der Turn-Feature-Class können die Kantenübergang-Features mithilfe der Befehle zum Erstellen linearer Features auf der Werkzeugleiste Editor erstellt werden.

Parameter

BeschriftungErläuterungDatentyp
Ausgabeverzeichnis

Die File-, Workgroup- oder Enterprise-Geodatabase bzw. der Ordner, in der/dem die Turn-Feature-Class der Ausgabe erstellt wird. Der Workspace muss bereits vorhanden sein.

Workspace; Feature Dataset
Name der Ausgabe-Turn-Feature-Class

Der Name der zu erstellenden Turn-Feature-Class.

String
Maximale Anzahl an Kanten
(optional)

Die maximale Anzahl von Kanten, die Kantenübergänge in der neuen Turn-Feature-Class abbilden können. Der Standardwert ist 5. Der Maximalwert lautet 50.

Long
Eingabe-Netzwerk-Dataset
(optional)

Das Netzwerk-Dataset, zu dem die Turn-Feature-Class gehört. Die resultierende Turn-Feature-Class wird dem Netzwerk-Dataset als Kantenübergangsquelle hinzugefügt. Wenn kein Netzwerk-Dataset angegeben wurde, wird die Turn-Feature-Class als nicht zu einem Netzwerk-Dataset gehörend erstellt.

Network Dataset Layer
Template-Feature-Class
(optional)

Die Feature-Class, die als Vorlage verwendet wird, um das Attributschema der neuen Turn-Feature-Class zu definieren.

Wenn die Template-Feature-Class die folgenden Felder enthält, werden diese nicht in der Ausgabe-Turn-Feature-Class erstellt: NODE_, NODE#, JUNCTION, F_EDGE, T_EDGE, F-EDGE, T-EDGE, ARC1_, ARC2_, ARC1#, ARC2#, ARC1-ID, ARC2-ID, AZIMUTH und ANGLE.

Feature Layer
Raumbezug
(optional)

Der auf die Ausgabe-Turn-Feature-Class anzuwendende Raumbezug. Dieser Parameter wird ignoriert, wenn die Ausgabe in ein Geodatabase-Feature-Dataset erfolgt, da die Ausgabe-Turn-Feature-Class den Raumbezug des Feature-Datasets übernimmt.

Spatial Reference
Konfigurationsschlüsselwort
(optional)

Das Konfigurationsschlüsselwort, das die Speicherparameter der neuen Turn-Feature-Class bestimmt. Dieser Parameter wird nur verwendet, wenn das Ausgabeverzeichnis eine Workgroup- oder Enterprise-Geodatabase ist.

String
Räumliches Gitter 1 der Ausgabe
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
Räumliches Gitter 2 der Ausgabe
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
Räumliches Gitter 3 der Ausgabe
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
Hat Z
(optional)

Gibt an, ob die Koordinaten in der Turn-Feature-Class über Höhenwerte (Z-Werte) verfügen.

  • Aktiviert: Die Koordinaten in der Turn-Feature-Class verfügen über Höhenwerte (Z-Werte). Dieser Parameter ist deaktivert, wenn das Eingabe-Netzwerk-Dataset angegeben wird und die Konnektivität auf der Grundlage der Z-Koordinatenwerte der Netzwerkquellen unterstützt wird.
  • Deaktiviert: Die Koordinaten in der Turn-Feature-Class verfügen nicht über Höhenwerte (Z-Werte).
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Turn-Feature-Class

Die Ausgabe-Turn-Feature-Class mit Kantenübergang-Features.

Feature Class

arcpy.management.CreateTurnFeatureClass(out_location, out_feature_class_name, {maximum_edges}, {in_network_dataset}, {in_template_feature_class}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {has_z})
NameErläuterungDatentyp
out_location

Die File-, Workgroup- oder Enterprise-Geodatabase bzw. der Ordner, in der/dem die Turn-Feature-Class der Ausgabe erstellt wird. Der Workspace muss bereits vorhanden sein.

Workspace; Feature Dataset
out_feature_class_name

Der Name der zu erstellenden Turn-Feature-Class.

String
maximum_edges
(optional)

Die maximale Anzahl von Kanten, die Kantenübergänge in der neuen Turn-Feature-Class abbilden können. Der Standardwert ist 5. Der Maximalwert lautet 50.

Long
in_network_dataset
(optional)

Das Netzwerk-Dataset, zu dem die Turn-Feature-Class gehört. Die resultierende Turn-Feature-Class wird dem Netzwerk-Dataset als Kantenübergangsquelle hinzugefügt. Wenn kein Netzwerk-Dataset angegeben wurde, wird die Turn-Feature-Class als nicht zu einem Netzwerk-Dataset gehörend erstellt.

Network Dataset Layer
in_template_feature_class
(optional)

Die Feature-Class, die als Vorlage verwendet wird, um das Attributschema der neuen Turn-Feature-Class zu definieren.

Wenn die Template-Feature-Class die folgenden Felder enthält, werden diese nicht in der Ausgabe-Turn-Feature-Class erstellt: NODE_, NODE#, JUNCTION, F_EDGE, T_EDGE, F-EDGE, T-EDGE, ARC1_, ARC2_, ARC1#, ARC2#, ARC1-ID, ARC2-ID, AZIMUTH und ANGLE.

Feature Layer
spatial_reference
(optional)

Der auf die Ausgabe-Turn-Feature-Class anzuwendende Raumbezug. Dieser Parameter wird ignoriert, wenn die Ausgabe in ein Geodatabase-Feature-Dataset erfolgt, da die Ausgabe-Turn-Feature-Class den Raumbezug des Feature-Datasets übernimmt.

Um den Raumbezug aus einer vorhandenen Feature-Class zu importieren, geben Sie seinen Pfad als Parameterwert an.

Spatial Reference
config_keyword
(optional)

Das Konfigurationsschlüsselwort, das die Speicherparameter der neuen Turn-Feature-Class bestimmt. Dieser Parameter wird nur verwendet, wenn das Ausgabeverzeichnis eine Workgroup- oder Enterprise-Geodatabase ist.

String
spatial_grid_1
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
spatial_grid_2
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
spatial_grid_3
(optional)

Dieser Parameter wird nicht unterstützt. Jeder angegebene Wert wird ignoriert.

Double
has_z
(optional)

Gibt an, ob die Koordinaten in der Turn-Feature-Class über Höhenwerte (Z-Werte) verfügen.

  • ENABLEDDie Koordinaten in der Turn-Feature-Class verfügen über Höhenwerte (Z-Werte). Verwenden Sie diesen Wert, wenn das Eingabe-Netzwerk-Dataset angegeben wird und die Konnektivität auf der Grundlage der Z-Koordinatenwerte der Netzwerkquellen unterstützt wird.
  • DISABLEDDie Koordinaten in der Turn-Feature-Class verfügen nicht über Höhenwerte (Z-Werte).
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_turn_features

Die Ausgabe-Turn-Feature-Class mit Kantenübergang-Features.

Feature Class

Codebeispiel

CreateTurnFeatureClass: Beispiel 1 (Python-Fenster)

Ausführen des Werkzeugs, wenn nur die erforderlichen Parameter verwendet werden.

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns")
CreateTurnFeatureClass: Beispiel 2 (Python-Fenster)

Führen Sie das Werkzeug unter Verwendung aller Parameter aus.

out_loc = "C:/Data/SanFrancisco.gdb/Transportation"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
template = "C:/Data/schema.gdb/TurnTemplate"
arcpy.na.CreateTurnFeatureClass(out_loc, "DelayTurns", 2, network, template, "",
                                "", 0, 0, 0, "DISABLED")
CreateTurnFeatureClass: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion CreateTurnFeatureClass in einem eigenständigen Skript verwendet wird.

# Name: CreateTurnFeatureClass_ex03.py
# Description: Create a new turn feature class associated with a network dataset
# Requirements: Network Analyst Extension

#Import system modules
import arcpy

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

#Set local variables
inFeatureDataset = "Transportation"
outTurnFeatureClassName = "DelayTurns"
maxEdges = 3
inNetworkDataset = inFeatureDataset + "/" + "Streets_ND"

#Create a turn feature class and add it as a turn source by specifying the
#network dataset
arcpy.na.CreateTurnFeatureClass(inFeatureDataset,outTurnFeatureClassName,
                                maxEdges, inNetworkDataset)

print("Script completed successfully.")