Routendominanzregeln konfigurieren (Location Referencing)

Zusammenfassung

Konfiguriert einen Regelsatz, mit dem die dominante Route in einem Netzwerk mit parallelen Routen bestimmt wird.

Verwendung

  • Die Option Numerisch des Parameters Art der Sortierung unterstützt nur Zahlen, beispielsweise 1, 2, 11, 22. Die Option Alphanumerisch unterstützt Zahlen und Text, beispielsweise 1, 2, 11, 22 und 1, 11A, 22A, 22B.

  • Wenn mehrere Felder mit dem Parameter Felder konfiguriert sind, werden die Feldwerte in der Reihenfolge verkettet, in der die Felder hinzugefügt wurden. Wenn zum Beispiel das Feld RouteType zuerst hinzugefügt wird und den Wert SR hat und das Feld RouteNumber als zweites Feld hinzugefügt wird und den Wert 18 hat, ergibt sich das verkettete Feld SR18.

    Wenn zum Beispiel SR18 eine Mehrfeld-Routen-ID ist, die aus den Feldern RouteType (SR) und RouteNumber (18) besteht, wählen Sie für den Parameter Felder die Optionen RouteType und RouteNumber aus.

  • Wenn der Parameter Ausnahmen angegeben ist, wird die Routendominanz bestimmt, indem zuerst Ausnahmen in der Reihenfolge ihres Vorhandenseins in der Liste abgeglichen werden und dann die konfigurierten Regeln angewendet werden. Die Werte des Ausnahmenfeldes werden durch Kommas getrennt.

    Wenn zum Beispiel Werte für Ausnahmen für Route3, Route7 und Route9 konfiguriert sind, werden diese Ausnahmen in ihrer Reihenfolge in der Liste als dominante Routen behandelt, bevor konfigurierte Regeln berücksichtigt werden.

Parameter

BeschriftungErläuterungDatentyp
LRS-Network-Feature-Class

Die Eingabe-Feature-Class. Es kann nur eine registrierte LRS-Network-Feature-Class verwendet werden.

Feature Layer
Typ der Konfiguration

Gibt den Typ der Konfiguration an, die auf den Wert des Parameters LRS-Network-Feature-Class angewendet wird.

  • HinzufügenDer Konfiguration wird eine neue Regel hinzugefügt.
  • AktualisierenEine vorhandene Regel wird aktualisiert.
  • LöschenEine vorhandene Regel wird gelöscht.
String
Regelname

Der Name der Regel, die hinzugefügt, aktualisiert oder gelöscht wird. Der Regelname kann aus maximal 30 Zeichen bestehen.

String
Aktualisierter Regelname
(optional)

Der aktualisierte Name der Regel. Dieser Parameter wird nur verwendet, wenn Aktualisieren als Wert des Parameters Typ der Konfiguration angegeben ist.

String
Name der Quelltabelle
(optional)

Die Quellobjekttabelle oder Quell-Event-Feature-Class, die im Wert des Parameters LRS-Network-Feature-Class registriert ist. Alternativ kann die Network-Feature-Class verwendet werden. Es werden nur nicht übergreifende Linienobjekte unterstützt.

String
Felder
(optional)

Die Attributfeld-Aliasnamen in der Quelltabelle. Wenn mehrere Felder verwendet werden, werden sie verkettet.

String
Sortiermethode
(optional)

Gibt an, ob die Anordnung durch kleinere oder größere Werte bestimmt wird.

String
Art der Sortierung
(optional)

Gibt die Art der Sortierung an, die beim Auswerten numerischer oder alphanumerischer Zeichenfolgen verwendet wird.

String
Priorisierte Ausnahmen
(optional)

Eine kommagetrennte Liste der benutzerdefinierten Ausnahmen.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Network-Feature-Class

Die aktualisierte LRS-Network-Feature-Class.

Feature Layer

arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, {updated_rule_name}, {source_table_name}, {fields}, {order_method}, {order_type}, {prioritized_exceptions})
NameErläuterungDatentyp
in_feature_class

Die Eingabe-Feature-Class. Es kann nur eine registrierte LRS-Network-Feature-Class verwendet werden.

Feature Layer
configure_type

Gibt den Typ der Konfiguration an, die auf den Wert des Parameters in_feature_class angewendet wird.

  • ADDDer Konfiguration wird eine neue Regel hinzugefügt.
  • UPDATEEine vorhandene Regel wird aktualisiert.
  • DELETEEine vorhandene Regel wird gelöscht.
String
rule_name

Der Name der Regel, die hinzugefügt, aktualisiert oder gelöscht wird. Der Regelname kann aus maximal 30 Zeichen bestehen.

String
updated_rule_name
(optional)

Der aktualisierte Name der Regel. Dieser Parameter wird nur verwendet, wenn UPDATE als Wert des Parameters configure_type angegeben ist.

String
source_table_name
(optional)

Die Quellobjekttabelle oder Quell-Event-Feature-Class, die im Wert des Parameters in_feature_class registriert ist. Alternativ kann die Network-Feature-Class verwendet werden. Es werden nur nicht übergreifende Linienobjekte unterstützt.

String
fields
[fields,...]
(optional)

Die Attributfeld-Aliasnamen in der Quelltabelle. Wenn mehrere Felder verwendet werden, werden sie verkettet.

String
order_method
(optional)

Gibt an, ob die Anordnung durch kleinere oder größere Werte bestimmt wird.

String
order_type
(optional)

Gibt die Art der Sortierung an, die beim Auswerten numerischer oder alphanumerischer Zeichenfolgen verwendet wird.

String
prioritized_exceptions
(optional)

Eine kommagetrennte Liste der benutzerdefinierten Ausnahmen.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_feature_class

Die aktualisierte LRS-Network-Feature-Class.

Feature Layer

Codebeispiel

ConfigureRouteDominanceRules – Beispiel 1 (Python-Fenster)

Veranschaulicht das Hinzufügen einer Routendominanzregel mithilfe der Funktion ConfigureRouteDominanceRules im Python-Fenster.

# Name: ConfigureRouteDominanceRules_Pro_ex1.py
# Description: Adds a rule to determine the dominant route in a network 
# where there are concurrent routes.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "ADD"
rule_name = "Rule6"
updated_rule_name = ""
source_table_name = "FunctionalClass"
fields = "FunctionalClass"
order_method = "LESSER"
order_type = "NUMERIC"
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)
ConfigureRouteDominanceRules – Beispiel 2 (Python-Fenster)

Veranschaulicht das Aktualisieren einer Routendominanzregel mithilfe der Funktion ConfigureRouteDominanceRules im Python-Fenster.

# Name: ConfigureRouteDominanceRules_Pro_ex2.py
# Description: Updates a rule to determine the dominant route in a network 
# where there are concurrent routes.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "UPDATE"
rule_name = "Rule6"
updated_rule_name = "Rule7"
source_table_name = "FunctionalClass"
fields = "FunctionalClass"
order_method = "GREATER"
order_type = "NUMERIC"
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)
ConfigureRouteDominanceRules – Beispiel 3 (eigenständiges Skript)

Veranschaulicht das Löschen einer Routendominanzregel mithilfe der Funktion ConfigureRouteDominanceRules in einem eigenständigen Skript.

# Name: ConfigureRouteDominanceRules_Pro_ex3.py
# Description: Deletes a route dominance rule from the configured rules as a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "DELETE"
rule_name = "Rule3"
updated_rule_name = ""
source_table_name = ""
fields = None
order_method = ""
order_type = ""
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
ConfigureRouteDominanceRules – Beispiel 4 (eigenständiges Skript)

Veranschaulicht das Hinzufügen einer Routendominanzregel mit Ausnahmen mithilfe der Funktion ConfigureRouteDominanceRules in einem eigenständigen Skript.

# Name: ConfigureRouteDominanceRules_Pro_ex4.py
# Description: Add a rule as a stand-alone script with prioritized exceptions 
# to determine the dominant route in a network with concurrent routes.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "ADD"
rule_name = "Rule8"
updated_rule_name = ""
source_table_name = "RouteNetwork"
fields = "RouteName"
order_method = "LESSER"
order_type = "ALPHANUMERIC"
prioritized_exceptions = "US62"

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

  • Basic: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
  • Standard: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
  • Advanced: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)

Verwandte Themen