LRS-Netzwerk ändern (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Ändert ein LRS-Netzwerk in einem linearen Referenzierungssystem in Location Referencing.

Verwendung

  • Die Eingabe-Feature-Class muss ein LRS-Netzwerk in Location Referencing darstellen.

  • Dieses Werkzeug löscht keine LRS-Netzwerke, Feature-Classes, Felder oder Daten.

  • Dieses Werkzeug aktualisiert interne Metadatentabellen, die Informationen über das als Eingabe verwendete LRS-Netzwerk speichern.

  • Dieses Werkzeug ermöglicht die Neuzuordnung von LRS-Netzwerk-Feldern wie Routen-ID, Routenname, Datum und Bis-Messwert-Felder. Wenn die Linienunterstützung aktiviert ist, können auch die Felder "Linien-ID", "Linienname" und "Linienreihenfolge" neu zugeordnet werden.

  • Alle neuen Felder, die für die Feldzuordnung verwendet werden, sollten in der zugrunde liegenden LRS-Network-Feature-Class erstellt werden, bevor Sie dieses Werkzeug verwenden.

  • Mit diesem Werkzeug kann die Option zur Unterstützung von Linien für ein LRS-Netzwerk, z. B. für ein technisches Netzwerk, hinzugefügt und entfernt werden.

  • Wenn ein Netzwerk, das Linien unterstützt, im Geodatabase-Workspace des LRS-Eingabe-Netzwerks vorhanden ist, kann mit diesem Werkzeug ein abgeleitetes LRS-Netzwerk konfiguriert werden. Die Registrierung eines vorhandenen abgeleiteten LRS-Netzwerks von einem LRS-Liniennetzwerk kann aufgehoben werden, und es kann bei einem anderen LRS-Liniennetzwerk registriert werden.

  • Ein Feld des LRS-Eingabe-Netzwerks kann nur einem einzigen LRS-Netzwerk-Feld zugeordnet werden.

  • Das Routen-ID-Feld kann ein einzelnes Feld oder eine Verkettung mehrerer Felder sein. Wenn für das Netzwerk eine verkettete Routen-ID verwendet wird, müssen alle Felder, aus denen sich die Routen-ID zusammensetzt, in der Network-Feature-Class vorhanden sein.

  • Mit diesem Werkzeug kann die Option zur Unterstützung eines vom Benutzer erstellten Routen-ID-Netzwerks für ein LRS-Netzwerk hinzugefügt oder entfernt werden.

Parameter

BeschriftungErläuterungDatentyp
LRS-Network-Feature-Class

Die als Eingabe verwendete LRS-Network-Feature-Class, die geändert werden soll.

Feature Layer
Routen-ID-Feld
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Routen-ID zugeordnet wird. Der Feldtyp muss mit dem RouteId-Feldtyp der Tabelle "Centerline_Sequence" übereinstimmen und einem Zeichenfolgen- oder GUID-Feldtyp entsprechen.

Field
Feld für Routenname
(optional)

Ein Zeichenfolgenfeld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Routenname zugeordnet wird.

Field
Feld für Von-Datum
(optional)

Ein Datumsfeld in der Eingabe-Feature-Class, das als Von-Datum des LRS-Netzwerks zugeordnet wird.

Field
Feld für Bis-Datum
(optional)

Ein Datumsfeld in der Eingabe-Feature-Class, das als Bis-Datum des LRS-Netzwerks zugeordnet wird.

Field
Aus Liniennetzwerk ableiten
(optional)

Bestimmt, ob das aktuelle LRS-Netzwerk als abgeleitetes LRS-Netzwerk konfiguriert wird.

  • UnverändertDie aktuell festgelegte Eigenschaft hinsichtlich der Ableitung des LRS-Netzwerks wird beibehalten. Dies ist die Standardeinstellung.
  • AbleitenDas eingegebene abgeleitete LRS-Netzwerk wird so geändert, dass es zu einem abgeleiteten LRS-Netzwerk wird. Der Parameter line network name muss auch angegeben werden, um zu spezifizieren, von welchem LRS-Netzwerk abgeleitet werden soll.
  • Nicht ableitenDas eingegebene abgeleitete LRS-Netzwerk wird so geändert, dass es kein abgeleitetes LRS-Netzwerk mehr ist.
String
Name des Liniennetzwerks
(optional)

Der Name des LRS-Liniennetzwerks, in dem das eingegebene abgeleitete LRS-Netzwerk registriert wird. Das als Eingabe verwendete LRS-Liniennetzwerk muss sich im gleichen Geodatabase-Workspace und LRS wie die LRS-Network-Feature-Class befinden. Dieser Parameter wird nur verwendet, wenn der Parameter Aus Liniennetzwerk ableiten auf Ableiten festgelegt ist.

String
Felder für Linien einbeziehen
(optional)

Bestimmt, ob das aktuelle LRS-Netzwerk für die Unterstützung von Linien konfiguriert wird.

  • UnverändertDie Eigenschaft der Linienunterstützung durch das aktuelle LRS-Netzwerk wird nicht geändert. Dies ist die Standardeinstellung.
  • EinbeziehenDas eingegebene LRS-Netzwerk wird geändert, um Unterstützung für Linien hinzuzufügen. Die Parameter für "Linien-ID-Feld", "Feld für Linienname" und "Feld für Linienreihenfolge" müssen ebenfalls angegeben werden. In der LRS-Network-Feature-Class müssen gültige Felder für die Zuordnung zu diesen Parametern vorhanden sein.
  • Nicht einbeziehenDas eingegebene LRS-Netzwerk wird geändert, um die Unterstützung für Linien zu entfernen.
String
Linien-ID-Feld
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linien-ID zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter Felder für Linien einbeziehen auf Einbeziehen festgelegt ist. Der Feldtyp muss mit dem RouteId-Feldtyp der Tabelle "Centerline_Sequence" übereinstimmen und entweder einer Zeichenkette mit genau 38 Zeichen oder einem GUID-Feldtyp entsprechen.

Field
Feld für Linienname
(optional)

Ein Zeichenfolgenfeld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linienname zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter Felder für Linien einbeziehen auf Einbeziehen festgelegt ist.

Field
Feld für Linienreihenfolge
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linienreihenfolge zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter Felder für Linien einbeziehen auf Einbeziehen festgelegt ist. Dabei muss es sich um ein Feld vom Typ "Long Integer" handeln.

Field
Routen-ID-Feldkonfiguration
(optional)

Bestimmt die Routen-ID-Konfiguration für ein LRS-Netzwerk.

  • UnverändertDie aktuelle Routen-ID-Konfiguration des LRS-Netzwerks wird nicht geändert. Dies ist die Standardeinstellung.
  • Automatisch generierte Routen-IDDas Routen-ID-Feld ist eine automatisch generierte GUID, und der Routenname kann als LRS-Feld konfiguriert werden.
  • Einzelfeld-Routen-IDWird nur für Nicht-Liniennetzwerke unterstützt.
  • Mehrfeld-Routen-IDWird nur für Nicht-Liniennetzwerke unterstützt. Es wird mehr als ein Feld benötigt, um die verkettete Routen-ID zu bilden.
String
Feld(er)
(optional)

Die einzelnen Felder in der LRS-Network-Feature-Class, aus denen die Routen-ID gebildet wird. Dieser Parameter wird nur verwendet, wenn für den Parameter Routen-ID-Feldkonfiguration die Option Mehrfeld-Routen-ID festgelegt ist. Bei den Feldern muss es sich um Zeichenfolgenfelder oder ganzzahlige Felder handeln.

Field

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Network-Feature-Class

Der aktualisierte Netzwerk-Feature-Layer.

Feature Layer

arcpy.locref.ModifyLRSNetwork(in_feature_class, {route_id_field}, {route_name_field}, {from_date_field}, {to_date_field}, {derive_from_line_network}, {line_network_name}, {include_fields_to_support_lines}, {line_id_field}, {line_name_field}, {line_order_field}, {route_id_configuration}, {individual_route_id_fields})
NameErläuterungDatentyp
in_feature_class

Die als Eingabe verwendete LRS-Network-Feature-Class, die geändert werden soll.

Feature Layer
route_id_field
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Routen-ID zugeordnet wird. Der Feldtyp muss mit dem RouteId-Feldtyp der Tabelle "Centerline_Sequence" übereinstimmen und einem Zeichenfolgen- oder GUID-Feldtyp entsprechen.

Field
route_name_field
(optional)

Ein Zeichenfolgenfeld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Routenname zugeordnet wird.

Field
from_date_field
(optional)

Ein Datumsfeld in der Eingabe-Feature-Class, das als Von-Datum des LRS-Netzwerks zugeordnet wird.

Field
to_date_field
(optional)

Ein Datumsfeld in der Eingabe-Feature-Class, das als Bis-Datum des LRS-Netzwerks zugeordnet wird.

Field
derive_from_line_network
(optional)

Bestimmt, ob das aktuelle LRS-Netzwerk als abgeleitetes LRS-Netzwerk konfiguriert wird.

  • AS_ISDie aktuell festgelegte Eigenschaft hinsichtlich der Ableitung des LRS-Netzwerks wird beibehalten. Dies ist die Standardeinstellung.
  • DERIVEDas eingegebene abgeleitete LRS-Netzwerk wird so geändert, dass es zu einem abgeleiteten LRS-Netzwerk wird. Der Parameter line network name muss auch angegeben werden, um zu spezifizieren, von welchem LRS-Netzwerk abgeleitet werden soll.
  • DO_NOT_DERIVEDas eingegebene abgeleitete LRS-Netzwerk wird so geändert, dass es kein abgeleitetes LRS-Netzwerk mehr ist.
String
line_network_name
(optional)

Der Name des LRS-Liniennetzwerks, in dem das eingegebene abgeleitete LRS-Netzwerk registriert wird. Das als Eingabe verwendete LRS-Liniennetzwerk muss sich im gleichen Geodatabase-Workspace und LRS wie die LRS-Network-Feature-Class befinden. Dieser Parameter wird nur verwendet, wenn der Parameter derive_from_line_network auf DERIVE festgelegt ist.

String
include_fields_to_support_lines
(optional)

Bestimmt, ob das aktuelle LRS-Netzwerk für die Unterstützung von Linien konfiguriert wird.

  • AS_ISDie Eigenschaft der Linienunterstützung durch das aktuelle LRS-Netzwerk wird nicht geändert. Dies ist die Standardeinstellung.
  • INCLUDEDas eingegebene LRS-Netzwerk wird geändert, um Unterstützung für Linien hinzuzufügen. Die Parameter für "Linien-ID-Feld", "Feld für Linienname" und "Feld für Linienreihenfolge" müssen ebenfalls angegeben werden. In der LRS-Network-Feature-Class müssen gültige Felder für die Zuordnung zu diesen Parametern vorhanden sein.
  • DO_NOT_INCLUDEDas eingegebene LRS-Netzwerk wird geändert, um die Unterstützung für Linien zu entfernen.
String
line_id_field
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linien-ID zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter include_fields_to_support_lines auf INCLUDE festgelegt ist. Der Feldtyp muss mit dem RouteId-Feldtyp der Tabelle "Centerline_Sequence" übereinstimmen und entweder einer Zeichenkette mit genau 38 Zeichen oder einem GUID-Feldtyp entsprechen.

Field
line_name_field
(optional)

Ein Zeichenfolgenfeld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linienname zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter include_fields_to_support_lines auf INCLUDE festgelegt ist.

Field
line_order_field
(optional)

Das Feld in der Eingabe-Feature-Class, das als LRS-Netzwerk-Linienreihenfolge zugeordnet wird. Dieser Parameter wird nur verwendet, wenn der Parameter include_fields_to_support_lines auf INCLUDE festgelegt ist. Dabei muss es sich um ein Feld vom Typ "Long Integer" handeln.

Field
route_id_configuration
(optional)

Bestimmt die Routen-ID-Konfiguration für ein LRS-Netzwerk.

  • AS_ISDie aktuelle Routen-ID-Konfiguration des LRS-Netzwerks wird nicht geändert. Dies ist die Standardeinstellung.
  • AUTOGENERATED_ROUTE_IDDas Routen-ID-Feld ist eine automatisch generierte GUID, und der Routenname kann als LRS-Feld konfiguriert werden.
  • SINGLE_FIELD_ROUTE_IDWird nur für Nicht-Liniennetzwerke unterstützt.
  • MULTI_FIELD_ROUTE_IDWird nur für Nicht-Liniennetzwerke unterstützt. Es wird mehr als ein Feld benötigt, um die verkettete Routen-ID zu bilden.
String
individual_route_id_fields
[individual_route_id_fields,...]
(optional)

Die einzelnen Felder in der in_feature_class, aus denen die Routen-ID gebildet wird. Dieser Parameter wird nur verwendet, wenn für den Parameter route_id_configuration die Option MULTI_FIELD_ROUTE_ID festgelegt ist. Bei den Feldern muss es sich um Zeichenfolgenfelder oder ganzzahlige Felder handeln.

Field

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_feature_class

Der aktualisierte Netzwerk-Feature-Layer.

Feature Layer

Codebeispiel

ModifyLRSNetwork – Beispiel 1 (Python-Fenster)

Zeigt, wie das Werkzeug ModifyLRSNetwork im Python-Fenster verwendet wird.

# Name: Modify_LRS_Network_ex1.py
# Description: Modifies an existing linear referencing system (LRS) in the specified workspace.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\DerivedNetwork"
route_id_field = "RouteId"
route_name_field = "RouteName"
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = "DO_NOT_DERIVE"
line_network_name = "EngineeringNetwork"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(in_feature_class, route_id_field, route_name_field, from_date_field, to_date_field,
                              derive_from_line_network, line_network_name)
                              
# Check in license
arcpy.CheckInExtension('LocationReferencing')
ModifyLRSNetwork – Beispiel 2 (eigenständiges Skript)

Zeigt, wie das Werkzeug ModifyLRSNetwork als eigenständiges Python-Skript verwendet wird.

# Name: Modify_LRS_Network_ex2.py
# Description: Modify an LRS Network to change field mapping for date fields. All other parameters will remain as is.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
Route_ID = "RouteId"
Route_Name = "RouteName"
From_Date = "FromDate_New"
To_Date = "ToDate_New"
Derive = "DO_NOT_DERIVE"
Derive_From = None
Line_Support = "INCLUDE"
Line_ID = "LineId"
Line_Name = "LineName"
Line_Order = "LineOrder"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(Input_Network, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From,
                              Line_Support, Line_ID, Line_Name, Line_Order)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
ModifyLRSNetwork – Beispiel 3 (Python-Fenster)

Veranschaulicht, wie Sie mit dem Werkzeug ModifyLRSNetwork im Python-Fenster das Routen-ID-Feld so ändern, dass eine benutzerdefinierte Einzelfeld-Routen-ID unterstützt wird.

# Name: ModifyLRSNetwork example 3 (Python window)
# Description: ModifyLRSNetwork example 3 (Python window)
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\Network1"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines =""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(in_feature_class, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
ModifyLRSNetwork – Beispiel 4 (Python-Fenster)

Veranschaulicht, wie Sie mit dem Werkzeug ModifyLRSNetwork im Python-Fenster das Routen-ID-Feld so ändern, dass eine benutzerdefinierte Mehrfeld-Routen-ID unterstützt wird.

# Name: ModifyLRSNetwork example 4 (Python window)
# Description: ModifyLRSNetwork example 4 (Python window)
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
in_feature_class = r"C:\UPDM_Data\LRS.gdb\LRS\Network1"
route_id_field = "RouteId"
route_name_field = ""
from_date_field = "FromDate"
to_date_field = "ToDate"
derive_from_line_network = ""
line_network_name = ""
include_fields_to_support_lines =""
line_id_field = ""
line_name_field = ""
line_order_field = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Set current workspace
arcpy.env.workspace = "C:\UPDM_Data\LRS.gdb"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(in_feature_class, route_id_field, route_name_field, from_date_field, to_date_field, derive_from_line_network, line_network_name, include_fields_to_support_lines, line_id_field, line_name_field, line_order_field, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
ModifyLRSNetwork – Beispiel 5 (eigenständiges Skript)

Veranschaulicht, wie Sie das Werkzeug ModifyLRSNetwork als eigenständiges Python-Skript verwenden, um das Routen-ID-Feld so zu ändern, dass eine benutzerdefinierte Einzelfeld-Routen-ID unterstützt wird.

# Name: ModifyLRSNetwork example 5 (stand-alone script)
# Description: ModifyLRSNetwork example 5 (stand-alone script)
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
Route_ID = "RouteId"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "SINGLE_FIELD_ROUTE_ID"
individual_route_id_fields = ""

# Execute the tool 
arcpy.locref.ModifyLRSNetwork(Input_Network, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
ModifyLRSNetwork – Beispiel 6 (eigenständiges Skript)

Veranschaulicht, wie Sie das Werkzeug ModifyLRSNetwork als eigenständiges Python-Skript verwenden, um das Routen-ID-Feld so zu ändern, dass eine benutzerdefinierte Mehrfeld-Routen-ID unterstützt wird.

# Name: ModifyLRSNetwork example 6 (stand-alone script)
# Description: ModifyLRSNetwork example 6 (stand-alone script)
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Input_Network = r"C:\UPDM_Data\LRS.gdb\LRS\EngineeringNetwork"
Route_ID = "RouteId"
Route_Name = ""
From_Date = "FromDate"
To_Date = "ToDate"
Derive = ""
Derive_From = ""
Line_Support = ""
Line_ID = ""
Line_Name = ""
Line_Order = ""
route_id_configuration = "MULTI_FIELD_ROUTE_ID"
individual_route_id_fields = "Field1;Field2;Field3"

# Execute the tool
arcpy.locref.ModifyLRSNetwork(Input_Network, Route_ID, Route_Name, From_Date, To_Date, Derive, Derive_From, Line_Support, Line_ID, Line_Name, Line_Order, route_id_configuration, individual_route_id_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Lizenzinformationen

  • Basic: Erfordert ArcGIS Location Referencing
  • Standard: Erfordert ArcGIS Location Referencing
  • Advanced: Erfordert ArcGIS Location Referencing

Verwandte Themen