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 Priorisierte Ausnahmen ausgefüllt 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 in einer durch Kommas getrennten Liste angegeben.

    Wenn zum Beispiel Werte für Priorisierte Ausnahmen für Route3, Route7 und Route9 konfiguriert sind, werden die 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 in der Konfiguration aktualisiert.
  • LöschenEine vorhandene Regel wird in der Konfiguration 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 Reihenfolge der Routendominanz durch kleinere oder größere Werte bestimmt wird.

  • KleinerDie Reihenfolge der Routendominanz wird durch kleinere Werte bestimmt. Dies ist die Standardeinstellung.
  • GrößerDie Reihenfolge der Routendominanz wird durch größere Werte bestimmt.
String
Art der Sortierung
(optional)

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

  • AlphanumerischDie alphanumerische Art der Sortierung wird verwendet. Dies ist die Standardeinstellung.
  • NumerischDie numerische Art der Sortierung wird verwendet.
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 in der Konfiguration aktualisiert.
  • DELETEEine vorhandene Regel wird in der Konfiguration 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 Reihenfolge der Routendominanz durch kleinere oder größere Werte bestimmt wird.

  • LESSERDie Reihenfolge der Routendominanz wird durch kleinere Werte bestimmt. Dies ist die Standardeinstellung.
  • GREATERDie Reihenfolge der Routendominanz wird durch größere Werte bestimmt.
String
order_type
(optional)

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

  • ALPHANUMERICDie alphanumerische Art der Sortierung wird verwendet. Dies ist die Standardeinstellung.
  • NUMERICDie numerische Art der Sortierung wird verwendet.
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