Configurer les règles de dominance d’itinéraire (Location Referencing)

Synthèse

Configure un ensemble de règles pour déterminer l’itinéraire dominant dans un réseau qui comporte des itinéraires simultanés.

Utilisation

  • L’option Numérique du paramètre Type de classement prend uniquement en charge les nombres, par exemple 1, 2, 11, 22. L’option Alphanumérique prend en charge à la fois les nombres et le texte, par exemple 1, 2, 11, 22 et 1, 11A, 22A, 22B.

  • Lorsque plusieurs champs sont configurés avec le paramètre Champs, les valeurs de champ sont concaténées dans l’ordre d’ajout des champs. Par exemple, si le champ RouteType est ajouté en premier avec la valeur SR, puis que le champ RouteNumber est ajouté en deuxième avec la valeur 18, le champ concaténé obtenu est SR18.

    Si, par exemple, SR18 est un ID d’itinéraire à champs multiples constitué des champs RouteType (SR) et RouteNumber (18), sélectionnez RouteType et RouteNumber pour le paramètre Champs.

  • Lorsque le paramètre Exceptions est spécifié, la dominance d’itinéraire est déterminée d’abord en appariant les exceptions selon leur ordre d’apparition dans la liste, puis par les règles configurées. Les valeurs des champs d’exception sont séparées par des virgules.

    Par exemple, si des valeurs Exceptions sont configurées pour Itinéraire3, Itinéraire7 et Itinéraire9, ces exceptions sont considérées comme des itinéraires dominants dans leur ordre d’apparition avant la prise en compte des règles configurées.

Paramètres

ÉtiquetteExplicationType de données
Classe d’entités de réseau LRS

Classe d’entités en entrée. Seule une classe d’entités de réseau LRS inscrite peut être utilisée.

Feature Layer
Configurer le type

Indique le type de configuration à appliquer à la valeur du paramètre Classe d’entités de réseau LRS.

  • AjouterUne nouvelle règle sera ajoutée à la configuration.
  • Mettre à jourUne règle existante sera mise à jour.
  • SupprimerUne règle existante sera supprimée.
String
Nom de la règle

Le nom de la règle sera ajouté, mis à jour ou supprimé. Le nom de la règle peut contenir 30 caractères au maximum.

String
Nom de la règle mis à jour
(Facultatif)

Nom mis à jour de la règle. Ce paramètre est utilisé uniquement lorsque Mettre à jour est spécifié comme valeur du paramètre Configurer le type.

String
Nom de la table source
(Facultatif)

Classe d’entités ou table d’événements source inscrite auprès de la valeur du paramètre Classe d’entités de réseau LRS. La classe d’entités de réseau peut également être utilisée. Seuls les événements linéaires non étendus sont pris en charge.

String
Champs
(Facultatif)

Alias de champ attributaire dans la table source. Si plusieurs champs sont utilisés, ils seront concaténés.

String
Autre méthode
(Facultatif)

Indique si le classement de la dominance d’itinéraire sera déterminé par des valeurs inférieures ou supérieures.

String
Type de commande
(Facultatif)

Indique le type de classement qui sera utilisé lors de l’évaluation des chaînes numériques ou alphanumériques.

String
Exceptions prioritaires
(Facultatif)

Liste d’exceptions prioritaires spécifiées par l’utilisateur, séparées par une virgule.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités de réseau en sortie

Classe d’entités de réseau LRS mise à jour.

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})
NomExplicationType de données
in_feature_class

Classe d’entités en entrée. Seule une classe d’entités de réseau LRS inscrite peut être utilisée.

Feature Layer
configure_type

Indique le type de configuration à appliquer à la valeur du paramètre in_feature_class.

  • ADDUne nouvelle règle sera ajoutée à la configuration.
  • UPDATEUne règle existante sera mise à jour.
  • DELETEUne règle existante sera supprimée.
String
rule_name

Le nom de la règle sera ajouté, mis à jour ou supprimé. Le nom de la règle peut contenir 30 caractères au maximum.

String
updated_rule_name
(Facultatif)

Nom mis à jour de la règle. Ce paramètre est utilisé uniquement lorsque UPDATE est spécifié comme valeur du paramètre configure_type.

String
source_table_name
(Facultatif)

Classe d’entités ou table d’événements source inscrite auprès de la valeur du paramètre in_feature_class. La classe d’entités de réseau peut également être utilisée. Seuls les événements linéaires non étendus sont pris en charge.

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

Alias de champ attributaire dans la table source. Si plusieurs champs sont utilisés, ils seront concaténés.

String
order_method
(Facultatif)

Indique si le classement de la dominance d’itinéraire sera déterminé par des valeurs inférieures ou supérieures.

String
order_type
(Facultatif)

Indique le type de classement qui sera utilisé lors de l’évaluation des chaînes numériques ou alphanumériques.

String
prioritized_exceptions
(Facultatif)

Liste d’exceptions prioritaires spécifiées par l’utilisateur, séparées par une virgule.

String

Sortie obtenue

NomExplicationType de données
out_feature_class

Classe d’entités de réseau LRS mise à jour.

Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction ConfigureRouteDominanceRules (fenêtre Python)

Illustre l’ajout d’une règle de dominance d’itinéraire avec la fonction ConfigureRouteDominanceRules dans la fenêtre Python.

# 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)
Exemple 2 d’utilisation de la fonction ConfigureRouteDominanceRules (fenêtre Python)

Illustre la mise à jour d’une règle de dominance d’itinéraire avec la fonction ConfigureRouteDominanceRules dans la fenêtre Python.

# 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)
Exemple 3 d’utilisation de la fonction ConfigureRouteDominanceRules (script autonome)

Illustre la suppression d’une règle de dominance d’itinéraire avec la fonction ConfigureRouteDominanceRules dans un script autonome.

# 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')
Exemple 4 d’utilisation de la fonction ConfigureRouteDominanceRules (script autonome)

Illustre l’ajout d’une règle de dominance d’itinéraire avec des exceptions à l’aide de la fonction ConfigureRouteDominanceRules dans un script autonome.

# 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')

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Nécessite ArcGIS Location Referencing
  • Standard: Nécessite ArcGIS Location Referencing
  • Advanced: Nécessite ArcGIS Location Referencing

Rubriques connexes