Modifier le réseau LRS (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Modifie un réseau LRS dans un système de référencement linéaire (LRS) Location Referencing.

Utilisation

  • La classe d’entités en entrée doit représenter un réseau LRS Location Referencing.

  • Cet outil ne supprime pas les réseaux LRS, classes d’entités, champs ou données.

  • Cet outil met à jour les tables de métadonnées internes qui stockent des informations sur le réseau LRS en entrée.

  • Cet outil permet de réapparier les champs du réseau LRS tels que les champs d’ID d’itinéraire, de nom d’itinéraire, de date et de mesure. Si la prise en charge des lignes est activée, les champs d’ID de ligne, de nom de ligne et d’ordre de ligne peuvent également être réappariés.

  • Tout nouveau champ qui sera utilisé pour l’appariement de champ doit être créé dans la classe d’entités de réseau LRS sous-jacente avant l’utilisation de cet outil.

  • La capacité d’un réseau LRS à prendre en charge les lignes, comme pour un réseau d’ingénierie, peut être ajoutée ou supprimée avec cet outil.

  • Si un réseau prenant en charge les lignes est présent dans l’espace de travail de géodatabase du réseau LRS en entrée, un réseau dérivé LRS peut être configuré avec cet outil. Un réseau dérivé LRS existant peut également être désinscrit d’un réseau linéaire LRS et inscrit auprès d’un autre réseau linéaire LRS.

  • Un champ du réseau LRS en entrée peut uniquement être apparié à un seul champ du réseau LRS.

  • Le champ ID d’itinéraire peut être un champ unique ou une concaténation de plusieurs champs. Si le réseau utilise un ID d’itinéraire concaténé, tous les champs qui composent l’ID d’itinéraire doivent être présents dans la classe d’entités de réseau.

  • La capacité d’un réseau LRS à prendre en charge un ID d’itinéraire généré par l’utilisateur, peut être ajoutée ou supprimée avec cet outil.

Paramètres

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

Classe d’entités de réseau LRS en entrée à modifier.

Feature Layer
Champ d’ID d’itinéraire
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ID d’itinéraire du réseau LRS. Le champ doit être de type chaîne ou GUID et doit correspondre au type de champ RouteId de la table Centerline_Sequence.

Field
Champ de nom d’itinéraire
(Facultatif)

Champ de chaîne dans la classe d’entités en entrée qui sera apparié comme nom d’itinéraire du réseau LRS.

Field
Champ de date de début
(Facultatif)

Champ de date dans la classe d’entités en entrée qui sera apparié comme date de début du réseau LRS.

Field
Champ de date de fin
(Facultatif)

Champ de date dans la classe d’entités en entrée qui sera apparié comme date de fin du réseau LRS.

Field
Dériver depuis le réseau linéaire
(Facultatif)

Détermine si le réseau LRS actuel sera configuré comme réseau dérivé LRS.

  • Tel quelLa propriété dérivée du réseau LRS actuel ne sera pas modifiée. Il s’agit de l’option par défaut.
  • DériverLe réseau dérivé LRS en entrée sera modifié pour devenir un réseau dérivé LRS. Le paramètre line network name doit également être fourni pour désigner le réseau LRS Network à l’origine du réseau dérivé.
  • Ne pas dériverLe réseau dérivé LRS en entrée sera modifié pour ne plus être un réseau dérivé LRS.
String
Nom du réseau linéaire
(Facultatif)

Nom du réseau linéaire LRS auprès duquel le réseau dérivé LRS en entrée sera inscrit. Le réseau linéaire LRS en entrée doit se trouver dans le même espace de travail de géodatabase et le même LRS que la classe d’entités de réseau LRS. Ce paramètre est utilisé uniquement si le paramètre Dériver depuis le réseau linéaire est défini sur Dériver.

String
Inclure des champs pour prendre en charge les lignes
(Facultatif)

Détermine si le réseau LRS actuel sera configuré pour prendre en charge les lignes.

  • Tel quelLa propriété de prise en charge des lignes du réseau LRS actuel ne sera pas modifiée. Il s’agit de l’option par défaut.
  • AjouterLe réseau LRS en entrée sera modifié pour ajouter la prise en charge des lignes. Les paramètres de champ d’ID de ligne, de champ de nom de ligne et de champ d’ordre de ligne doivent également être indiqués, et des champs valides à apparier avec ces paramètres doivent exister dans la classe d’entités de réseau LRS.
  • Ne pas inclureLe réseau LRS en entrée sera modifié pour supprimer la prise en charge des lignes.
String
Champ d’ID de ligne
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ID de ligne du réseau LRS. Ce paramètre est uniquement utilisé si le paramètre Inclure des champs pour prendre en charge les lignes est défini sur Inclure. Le champ doit être de type chaîne avec exactement 38 caractères ou de type GUID et doit correspondre au type de champ RouteId de la table Centerline_Sequence.

Field
Champ de nom de ligne
(Facultatif)

Champ de chaîne dans la classe d’entités en entrée qui sera apparié comme nom de ligne du réseau LRS. Ce paramètre est uniquement utilisé si le paramètre Inclure des champs pour prendre en charge les lignes est défini sur Inclure.

Field
Champ d’ordre de ligne
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ordre de ligne du réseau LRS. Ce paramètre est uniquement utilisé si le paramètre Inclure des champs pour prendre en charge les lignes est défini sur Inclure. Le champ doit être de type entier long.

Field
Configuration du champ d’ID d’itinéraire
(Facultatif)

Détermine la configuration d’ID d’itinéraire d’un réseau LRS.

  • Tel quelLa configuration actuelle d’ID d’itinéraire d’un réseau LRS ne changera pas. Il s’agit de l’option par défaut.
  • ID d’itinéraire généré automatiquementLe champ d’ID d’itinéraire sera un GUID généré automatiquement et le nom d’itinéraire peut être configuré comme champ LRS.
  • ID d’itinéraire à champ uniquePrise en charge uniquement pour les réseaux non linéaires.
  • ID d’itinéraire à champs multiplesPrise en charge uniquement pour les réseaux non linéaires. Plusieurs champs sont nécessaires pour constituer l’ID d’itinéraire concaténé.
String
Champ(s)
(Facultatif)

Champs individuels dans Classe d’entités de réseau LRS qui seront utilisés pour constituer l’ID d’itinéraire. Ce paramètre est utilisé uniquement si l’option ID d’itinéraire à champs multiples du paramètre Configuration du champ d’ID d’itinéraire est configurée. Les champs doivent être de type chaîne ou nombre entier.

Field

Sortie obtenue

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

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

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

Classe d’entités de réseau LRS en entrée à modifier.

Feature Layer
route_id_field
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ID d’itinéraire du réseau LRS. Le champ doit être de type chaîne ou GUID et doit correspondre au type de champ RouteId de la table Centerline_Sequence.

Field
route_name_field
(Facultatif)

Champ de chaîne dans la classe d’entités en entrée qui sera apparié comme nom d’itinéraire du réseau LRS.

Field
from_date_field
(Facultatif)

Champ de date dans la classe d’entités en entrée qui sera apparié comme date de début du réseau LRS.

Field
to_date_field
(Facultatif)

Champ de date dans la classe d’entités en entrée qui sera apparié comme date de fin du réseau LRS.

Field
derive_from_line_network
(Facultatif)

Détermine si le réseau LRS actuel sera configuré comme réseau dérivé LRS.

  • AS_ISLa propriété dérivée du réseau LRS actuel ne sera pas modifiée. Il s’agit de l’option par défaut.
  • DERIVELe réseau dérivé LRS en entrée sera modifié pour devenir un réseau dérivé LRS. Le paramètre line network name doit également être fourni pour désigner le réseau LRS Network à l’origine du réseau dérivé.
  • DO_NOT_DERIVELe réseau dérivé LRS en entrée sera modifié pour ne plus être un réseau dérivé LRS.
String
line_network_name
(Facultatif)

Nom du réseau linéaire LRS auprès duquel le réseau dérivé LRS en entrée sera inscrit. Le réseau linéaire LRS en entrée doit se trouver dans le même espace de travail de géodatabase et le même LRS que la classe d’entités de réseau LRS. Ce paramètre est utilisé uniquement si le paramètre derive_from_line_network est défini sur DERIVE.

String
include_fields_to_support_lines
(Facultatif)

Détermine si le réseau LRS actuel sera configuré pour prendre en charge les lignes.

  • AS_ISLa propriété de prise en charge des lignes du réseau LRS actuel ne sera pas modifiée. Il s’agit de l’option par défaut.
  • INCLUDELe réseau LRS en entrée sera modifié pour ajouter la prise en charge des lignes. Les paramètres de champ d’ID de ligne, de champ de nom de ligne et de champ d’ordre de ligne doivent également être indiqués, et des champs valides à apparier avec ces paramètres doivent exister dans la classe d’entités de réseau LRS.
  • DO_NOT_INCLUDELe réseau LRS en entrée sera modifié pour supprimer la prise en charge des lignes.
String
line_id_field
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ID de ligne du réseau LRS. Ce paramètre est utilisé uniquement si le paramètre include_fields_to_support_lines est défini sur INCLUDE. Le champ doit être de type chaîne avec exactement 38 caractères ou de type GUID et doit correspondre au type de champ RouteId de la table Centerline_Sequence.

Field
line_name_field
(Facultatif)

Champ de chaîne dans la classe d’entités en entrée qui sera apparié comme nom de ligne du réseau LRS. Ce paramètre est utilisé uniquement si le paramètre include_fields_to_support_lines est défini sur INCLUDE.

Field
line_order_field
(Facultatif)

Champ dans la classe d’entités en entrée qui sera apparié comme ordre de ligne du réseau LRS. Ce paramètre est utilisé uniquement si le paramètre include_fields_to_support_lines est défini sur INCLUDE. Le champ doit être de type entier long.

Field
route_id_configuration
(Facultatif)

Détermine la configuration d’ID d’itinéraire d’un réseau LRS.

  • AS_ISLa configuration actuelle d’ID d’itinéraire d’un réseau LRS ne changera pas. Il s’agit de l’option par défaut.
  • AUTOGENERATED_ROUTE_IDLe champ d’ID d’itinéraire sera un GUID généré automatiquement et le nom d’itinéraire peut être configuré comme champ LRS.
  • SINGLE_FIELD_ROUTE_IDPrise en charge uniquement pour les réseaux non linéaires.
  • MULTI_FIELD_ROUTE_IDPrise en charge uniquement pour les réseaux non linéaires. Plusieurs champs sont nécessaires pour constituer l’ID d’itinéraire concaténé.
String
individual_route_id_fields
[individual_route_id_fields,...]
(Facultatif)

Champs individuels dans in_feature_class qui seront utilisés pour constituer l’ID d’itinéraire. Ce paramètre est utilisé uniquement si l'option MULTI_FIELD_ROUTE_ID du paramètre route_id_configuration est configurée. Les champs doivent être de type chaîne ou nombre entier.

Field

Sortie obtenue

NomExplicationType de données
out_feature_class

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

Feature Layer

Exemple de code

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

Illustre l’utilisation de l’outil ModifyLRSNetwork dans la fenêtre Python.

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

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

Illustre l’utilisation de l’outil de géotraitement ModifyLRSNetwork en tant que script Python autonome.

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

Illustre l’utilisation de l’outil ModifyLRSNetwork dans la fenêtre Python pour modifier le champ d’ID d’itinéraire et prendre en charge un ID d’itinéraire à champ unique défini par l’utilisateur.

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

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

Illustre l’utilisation de l’outil ModifyLRSNetwork dans la fenêtre Python pour modifier le champ d’ID d’itinéraire et prendre en charge un ID d’itinéraire à champs multiples défini par l’utilisateur.

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

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

Illustre l’utilisation de l’outil ModifyLRSNetwork en tant que script Python autonome pour modifier le champ d’ID d’itinéraire et prendre en charge un ID d’itinéraire à champ unique défini par l’utilisateur.

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

Illustre l’utilisation de l’outil ModifyLRSNetwork en tant que script Python autonome pour modifier le champ d’ID d’itinéraire et prendre en charge un ID d’itinéraire à champs multiples défini par l’utilisateur.

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

Informations de licence

  • Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)

Rubriques connexes