Mettre à jour les mesures à partir du LRS (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Renseigne ou met à jour les mesures et ID d'itinéraire sur les entités Utility Network (UN), telles que les tuyaux, les appareils et les jonctions, ou sur les entités des classes d'entités autres que des classes d'entités UN ou LRS.

Cet outil recherche les itinéraires appropriés à partir du paramètre Réseau LRS, récupère les mesures de cet itinéraire et renseigne ou met à jour les attributs de mesure et d'itinéraire pour les entités de la classe d'entités non LRS.

Remarque :

L'extension ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways est requise pour utiliser cet outil si les jeux de données d'un service d'entités sont utilisés.

Utilisation

  • Depuis ArcGIS Pro 3.1, cet outil prend en charge la connexion directe (connexion client et serveur) à l'aide du versionnement de branche, ainsi que la connexion précédemment prise en charge via un service d'entités à l'aide du versionnement de branche.

  • Les propriétés de champ des paramètres Entités en entrée et Réseau LRS doivent correspondre.

  • La référence spatiale, la résolution x,y et la tolérance x,y des paramètres Entités en entrée et Réseau LRS doivent correspondre.

  • Un journal de texte indiquant que l'outil a été exécuté et contient ce qui suit est écrit en local :

    • Informations sur les entités en entrée dont la validation a échoué
    • Valeurs d'ID d'itinéraire et de mesure des entités en entrée mises à jour avant et après la mise à jour

  • La valeur Entités en entrée doit coïncider exactement avec les entités Réseau LRS.

    Les diagrammes et tableaux suivants illustrent le mode de mise à jour des entités linéaires et ponctuelles à partir des valeurs Entités en entrée qui ne correspondent pas à des classes d'entités LRS mais coïncident à Route1 dans les entités Réseau LRS :

    Exemple de mise à jour des mesures d'ID d'itinéraire à l'aide d'une entité linéaire

    Couche en entréeType d'entitésID d'itinéraireMesure de départMesure d’arrivéeCommentaires

    Couche en entrée non LRS

    Ligne

    Route1

    11

    18

    La géométrie de l'entité linéaire correspond à celle du réseau LRS.

    Exemple de mise à jour des mesures d'ID d'itinéraire à l'aide d'une entité ponctuelle

    Couche en entréeType d'entitésID d'itinéraireMesure de départMesure d’arrivéeCommentaires

    Couche en entrée non LRS

    Point

    Route1

    21

    L'entité ponctuelle coïncide avec l'itinéraire sur la valeur Réseau LRS.

    Exemple de mesures d'ID d'itinéraire ne pouvant pas être mises à jour car l'entité linéaire ne coïncide pas exactement avec le réseau LRS

    Couche en entréeType d'entitésID d'itinéraireMesure de départMesure d’arrivéeCommentaires

    Couche en entrée non LRS

    Ligne

    La géométrie de l'entité linéaire ne coïncide pas avec celle du réseau en entrée. Aucune information n'est renvoyée.

Paramètres

ÉtiquetteExplicationType de données
Réseau LRS

Couche d'entités qui contient les itinéraires, ID d'itinéraire et mesures.

Feature Layer
Date LRS

Date permettant de définir la vue temporelle du réseau pour collecter les valeurs d'itinéraires et de mesures.

Date
Entités en entrée

Couche qui inclut les champs d'ID d'itinéraire et de mesure qui seront mis à jour en fonction de la géométrie d'entité par rapport aux itinéraires dans le paramètre Réseau LRS.

Feature Layer
Champ d’ID d’itinéraire

Champ de la couche Entités en entrée qui contient la valeur d'ID d'itinéraire.

Field
Champ de mesure

Champ de la couche Entités en entrée qui contient la valeur de mesure de départ des entités polylignes.

Field
Champ Mesure de fin
(Facultatif)

Champ de la couche Entités en entrée qui contient la valeur de mesure des entités ponctuelles ou la valeur de mesure d’arrivée des entités polylignes.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Fichier de détails en sortie

Fichier journal en sortie qui répertorie les entités mises à jour à partir du paramètre Entités en entrée. Ce fichier journal inclut les valeurs avant et après des champs d'ID d'itinéraire, de mesure de départ et de mesure d'arrivée de chaque entité mise à jour.

Text File
Entités en sortie

Couche d’entités mise à jour.

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.

Feature Layer

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field})
NomExplicationType de données
lrs_network

Couche d'entités qui contient les itinéraires, ID d'itinéraire et mesures.

Feature Layer
lrs_date

Date permettant de définir la vue temporelle du réseau pour collecter les valeurs d'itinéraires et de mesures.

Date
in_features

Couche qui inclut les champs d'ID d'itinéraire et de mesure qui seront mis à jour en fonction de la géométrie d'entité par rapport aux itinéraires dans le paramètre lrs_network.

Feature Layer
route_id_field

Champ de la couche in_features qui contient la valeur d'ID d'itinéraire.

Field
from_measure_field

Champ de la couche in_features qui contient la valeur de mesure de départ des entités polylignes.

Field
to_measure_field
(Facultatif)

Champ de la couche in_features qui contient la valeur de mesure des entités ponctuelles ou la valeur de mesure d’arrivée des entités polylignes.

Field

Sortie obtenue

NomExplicationType de données
out_details_file

Fichier journal en sortie qui répertorie les entités mises à jour à partir du paramètre in_features. Ce fichier journal inclut les valeurs avant et après des champs d'ID d'itinéraire, de mesure de départ et de mesure d'arrivée de chaque entité mise à jour.

Text File
out_features

Couche d’entités mise à jour.

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.

Feature Layer

Exemple de code

Exemple 1 d'utilisation de la fonction UpdateMeasuresFromLRS (fenêtre Python)

Cet exemple de code montre comment utiliser la fonction UpdateMeasuresFromLRS dans la fenêtre Python.

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

## Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)
Exemple 2 d'utilisation de la fonction UpdateMeasuresFromLRS (script autonome)

Cet exemple de code montre comment utiliser la fonction UpdateMeasuresFromLRS comme script Python autonome dans un service d’entités.

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)

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

Environnements

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

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