Générer des itinéraires (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Recrée des formes et applique des changements de calibrage pour les entités d’itinéraire dans un réseau LRS.

L’outil peut en outre déterminer des changements de calibrage sur les itinéraires pour que les comportements d’événement puissent être traités. Ces changements de calibrage peuvent résulter de l’ajout, de la mise à jour ou de la suppression de points de calibrage hors des outils Location Referencing dans ArcGIS Pro.

Utilisation

  • Saisissez le réseau LRS dont les entités doivent être régénérées ou auxquelles des changements de calibrage doivent être appliqués en fonction de la forme d’itinéraire issue de la classe d’entités d’axe médian et des valeurs de mesure issues de la classe d’entités de point de calibrage.

  • 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.

  • Si des points de calibrage sont supprimés ou si leur date est modifiée hors des outils ArcGIS Location Referencing dans ArcGIS Pro et que Générer des itinéraires est exécuté avec le paramètre Enregistrer les modifications de calibrage pour les mises à jour de localisation d’événement coché, les événements situés dans la zone où le point de calibrage a été supprimé ou dont la date a changé auront le comportement d’événement Déplacer au lieu du comportement Immobile.

  • Si un réseau dérivé est configuré à l’aide d’un réseau linéaire, l’exécution de l’outil Générer des itinéraires sur le réseau linéaire met également à jour le réseau dérivé.

  • Les itinéraires du réseau dérivé sont générés en associant les formes d’itinéraire dans la ligne parente.

  • Lorsque la prévention des conflits est activée pour l’outil, les événements générés par l’outil sont verrouillés.

    • Si vous utilisez la version par défaut, les verrous acquis sont automatiquement libérés une fois l’exécution de l’outil terminée.
    • Si vous utilisez une version enfant, les verrous acquis conservent le statut Sur réinjection une fois l’outil exécuté. Le propriétaire du verrou 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 sont acquis et conservent le statut libérable une fois l’exécution de l’outil terminée.

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

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

Paramètres

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

Réseau LRS pour lequel des formes d’itinéraire seront régénérées et des changements de calibrage appliqués.

Feature Layer
Enregistrer les changements de calibrage pour les mises à jour de localisation d’événement
(Facultatif)

Indique si les comportements d’événement seront appliqués.

  • Activé : les points de calibrage créés, modifiés ou supprimés hors des outils Location Referencing seront appliqués aux itinéraires du réseau et les comportements d’événement seront appliqués lors de la prochaine exécution de l’outil Appliquer les comportements d’événement.
  • Désactivé : les changements de calibrage seront appliqués aux itinéraires du réseau LRS, mais aucun comportement d’événement ne sera appliqué. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Entités d’itinéraire en sortie

Couche d’entités d’itinéraire mise à jour.

Feature Layer
Entités d’itinéraire dérivé en sortie

Réseau LRS mis à jour sur lequel des formes d’itinéraire ont été générées et des changements de calibrage ont été appliqués.

Feature Layer
Fichier de résultats en sortie

Fichier texte qui détaille les itinéraires qui ont été mis à jour dans la classe d’entités de réseau LRS.

Text File

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})
NomExplicationType de données
in_route_features

Réseau LRS pour lequel des formes d’itinéraire seront régénérées et des changements de calibrage appliqués.

Feature Layer
record_calibration_changes
(Facultatif)

Indique si les comportements d’événement seront appliqués.

  • RECORD_CALIBRATION_CHANGESLes points de calibrage créés, modifiés ou supprimés hors des outils Location Referencing seront appliqués aux itinéraires du réseau et les comportements d’événement seront appliqués lors de la prochaine exécution de l’outil Appliquer les comportements d’événement.
  • NO_RECORD_CALIBRATION_CHANGESLes changements de calibrage seront appliqués aux itinéraires du réseau LRS, mais aucun comportement d’événement ne sera appliqué. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_route_features

Couche d’entités d’itinéraire mise à jour.

Feature Layer
out_derived_route_features

Réseau LRS mis à jour sur lequel des formes d’itinéraire ont été générées et des changements de calibrage ont été appliqués.

Feature Layer
out_details_file

Fichier texte qui détaille les itinéraires qui ont été mis à jour dans la classe d’entités de réseau LRS.

Text File

Exemple de code

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

Illustre l’utilisation de la fonction GenerateRoutes en mode immédiat.

# Name: GenerateRoutes_ex1.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "NO_RECORD_CALIBRATION_CHANGES"

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

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)
arcpy.CheckInExtension('LocationReferencing')
Exemple 2 d’utilisation de la fonction GenerateRoutes (script autonome)

Illustre l'utilisation de la fonction GenerateRoutes dans un script Python autonome.

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# 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'
record_calibration_changes = "RECORD_CALIBRATION_CHANGES"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)

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

Illustre l'utilisation de la fonction GenerateRoutes dans un script autonome Python dans un service d’entités.

# Name: GenerateRoutes_Pro_Ex3.py.py
# Description: Generate routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

## Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

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

# Process : Generate Routes.
arcpy.locref.GenerateRoutes(in_route)

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

Environnements

Cas particuliers

Facteur de traitement parallèle

Si vous ne renseignez pas ce champ, la valeur par défaut pour cet environnement est égale à 0 %. Toute valeur absolue pour l’environnement est toujours fixée entre 0 et le nombre de cœurs logiques de cette machine.

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