Dériver des mesures d’événements (Location Referencing)

Synthèse

Renseigne et met à jour le champ DerivedRouteID et les valeurs de mesure dans les événements ponctuels et linéaires avec les champs configurés et activés.

Utilisation

  • Un jeu de données LRS est requis pour exécuter cet outil.

    En savoir plus sur la création d’un jeu de données LRS dans ArcGIS Pipeline Referencing ou la création d’un jeu de données LRS dans ArcGIS Roads and Highways.

  • Cet outil est conçu pour s’exécuter dans le cadre d’un processus de plus grande envergure. Exécutez les outils Appliquer les comportements d’événement et Générer des itinéraires avant d’exécuter Dériver les mesures d’événements. L’exécution de cet outil sans exécuter les outils précédents dans le processus risque de fausser les données.

  • Il est recommandé d’exécuter cet outil dans la géodatabase fichier lors de la migration initiale des données. Il s’exécutera ainsi plus rapidement car l’opération doit modifier chaque enregistrement d’événement dans la base de données. Une fois en production, l’outil peut être exécuté sur une sélection du jeu des itinéraires qui ont été modifiés afin de réduire considérablement les performances.

  • Les champs de mesure et DerivedRouteID de la couche d’entités d’événement en entrée doivent être configurés.

  • Cet outil peut s’exécuter sur un événement, sur plusieurs ou sur tous dans un réseau linéaire.

  • Cet outil prend en charge la prévention des conflits et tente d’acquérir des verrous et de les transférer.

  • Lorsque la prévention des conflits est activée, les conditions suivantes sont prises en charge :

    • Les événements dont les mesures d’événement dérivé doivent être mises à jour acquièrent automatiquement des verrous d’événement, le cas échéant. Si les verrous ne peuvent pas être acquis, l’outil échoue et fournit le fichier texte de ces verrous.

      En savoir plus sur la prévention des conflits dans Pipeline Referencing ou sur la prévention des conflits dans Roads and Highways.

    • Si vous utilisez la version par défaut, les verrous acquis sont automatiquement libérés une fois l’outil exécuté.
    • Si vous utilisez une version enfant, les verrous acquis conservent le statut de réinjection une fois l’outil exécuté. L’utilisateur doit réinjecter ou supprimer la version pour libérer les verrous.
    • Si vous utilisez une version enfant et que l’exécution de l’outil est annulée par interruption, les verrous acquis conservent le statut libérable.

Paramètres

ÉtiquetteExplicationType de données
Entités itinéraires en entrée

Réseau LRS contenant les événements avec les champs DerivedRouteID configurés.

Feature Layer
Mettre à jour toutes les classes d’entités d’événement inscrites dans le réseau sélectionné
(Facultatif)

Indique si toutes les classes d’entités d’événement du réseau seront mises à jour.

  • Activé : toutes les classes d’entités d’événement du réseau sélectionnées dans la valeur du paramètre Entités itinéraires en entrée seront mises à jour. Il s’agit de l’option par défaut.
  • Désactivé : les classes d’entités d’événement du réseau sélectionnées dans la valeur du paramètre Entités itinéraires en entrée ne seront pas mises à jour. Chaque couche d’événements peut être sélectionnée à l’aide du paramètre Couches d’événements.
Boolean
Couches d’événements
(Facultatif)

Couches d’événements dont les champs de mesure et DerivedRouteID seront mis à jour.

Feature Layer

Sortie obtenue

ÉtiquetteExplicationType de données
Événements en sortie

Couche d’entités d’événements mise à jour.

Feature Layer
Fichier de détails en sortie

Fichier texte qui détaille les modifications apportées à la couche d’entités d’événements.

Remarque :

Les résultats de validation de cet outil sont écrits dans le répertoire ArcGIS Server. Par défaut, ce fichier est nettoyé automatiquement au bout de 10 minutes, ce qui risque de ne pas laisser suffisamment de temps pour le traitement de toutes les validations et leur écriture sur le poste de travail exécutant ArcGIS Pro. Pour des charges de données plus importantes, il est recommandé de régler l’âge maximal du fichier sur une heure, au minimum.

Text File

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})
NomExplicationType de données
in_route_features

Réseau LRS contenant les événements avec les champs DerivedRouteID configurés.

Feature Layer
update_all_events
(Facultatif)

Indique si toutes les classes d’entités d’événement du réseau seront mises à jour.

  • UPDATE_ALLToutes les classes d’entités d’événement du réseau sélectionnées dans la valeur du paramètre in_route_features seront mises à jour. Il s’agit de l’option par défaut.
  • UPDATE_SOMELes classes d’entités d’événement du réseau sélectionnées dans la valeur du paramètre in_route_features ne seront pas mises à jour. Chaque couche d’événements peut être sélectionnée à l’aide du paramètre event_layers.
Boolean
event_layers
[event_layers,...]
(Facultatif)

Couches d’événements dont les champs de mesure et DerivedRouteID seront mis à jour.

Feature Layer

Sortie obtenue

NomExplicationType de données
out_events

Couche d’entités d’événements mise à jour.

Feature Layer
out_details_file

Fichier texte qui détaille les modifications apportées à la couche d’entités d’événements.

Remarque :

Les résultats de validation de cet outil sont écrits dans le répertoire ArcGIS Server. Par défaut, ce fichier est nettoyé automatiquement au bout de 10 minutes, ce qui risque de ne pas laisser suffisamment de temps pour le traitement de toutes les validations et leur écriture sur le poste de travail exécutant ArcGIS Pro. Pour des charges de données plus importantes, il est recommandé de régler l’âge maximal du fichier sur une heure, au minimum.

Text File

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l’utilisation de l’outil DeriveEventMeasures en mode immédiat.

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

# Set current workspace
arcpy.env.workspace = "C:\Data\PipelineReferencing.gdb"

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)
Exemple 2 d’utilisation de la fonction DeriveEventMeasures (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction DeriveEventMeasures.

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 3 d’utilisation de la fonction DeriveEventMeasures (script autonome)

Le script Python autonome ci-dessous illustre l'utilisation de la fonction DeriveEventMeasures dans un service d’entités.

# Name: DeriveEventMeasures_Pro_Ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

## Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_lrs_network, update_all_events, event_layers)

# 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