Convertir les mesures d’événements (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Convertit les mesures (valeurs m) d’une couche d’événements ponctuels ou linéaires d’une méthode de référencement linéaire à une autre.

Un cas d’utilisation de cet outil serait de convertir les données d’événement d’un réseau mesuré en miles vers un réseau kilométrique.

Outre les mesures, les associations d’itinéraire des entités d’événement peuvent également être différentes dans deux LRM. La sortie de cet outil est une classe d’entités avec des mesures et des associations d’itinéraire correctes dans le réseau LRS cible.

Utilisation

  • La couche d’événements en entrée doit être une classe d’entités ponctuelles ou linéaires.

  • Cet outil ne modifie aucune des entrées et crée une classe d’entités en sortie.

  • Cet outil prend en charge une seule représentation temporelle à la fois. Créez un ensemble de définition temporel ou appliquez une sélection temporelle définie sur la couche d’événements en entrée ainsi que sur le réseau LRS cible avant d’exécuter cet outil. Le curseur temporel dans ArcGIS Pro peut également être utilisé si le temps est configuré pour les deux couches en entrée.

  • Cet outil prend en charge la conversion d’événements sur des itinéraires comportant des interruptions.

  • Si le réseau cible est un réseau linéaire LRS, également connu sous le nom de réseau d’ingénierie, la couche d’événements en entrée peut être convertie même si le réseau d’origine de la couche d’événements en entrée ne prend pas en charge le concept de lignes.

  • Le type de classe d’entités en sortie (ligne ou point) doit correspondre au type de couche d’événements en entrée.

  • Les paramètres de tolérance et de résolution de la couche d’événements en entrée doivent correspondre à ceux du réseau LRS cible.

  • Pour identifier les conditions correspondantes intervenant durant la conversion, un champ appelé Loc_Error est créé dans la classe d’entités en sortie et contient des valeurs telles que Multi-Match, Partial Match, No Match ou No Error.

  • Les champs attributaires de la couche d’événements en entrée sont inclus dans la classe d’entités en sortie.

  • Si le réseau LRS cible contient des itinéraires coïncidents, utilisez l’option Appariement d’itinéraires coïncidents.

  • Si Itinéraire avec un ID d’itinéraire correspondant est utilisé avec Appariement d’itinéraires coïncidents, la couche d’événements en entrée doit être inscrite en tant que couche d’événements LRS dans ArcGIS Location Referencing.

  • Cet outil effectue une superposition spatiale de la couche d’événements en entrée sur le réseau LRS cible pour générer des entités pour l’événement en entrée à travers le réseau cible. Ces entités contiendront l’ID d’itinéraire et les informations de mesure concernant cette localisation sur l’itinéraire.

  • La couche d’événements en entrée et le réseau cible ne doivent représenter qu’un seul point dans le temps pour obtenir une sortie précise. Si la couche d’événements en entrée représente plusieurs points dans le temps, définissez un filtre à l’aide du curseur temporel ou utilisez un ensemble de définition sur les colonnes de date.

  • Les données en sortie peuvent être ajoutées à un nouvel événement LRS, ou un événement LRS existant, à l’aide de l’outil Ajouter des événements. Si la couche d’événements en entrée contenait plusieurs représentations temporelles et a entraîné l’exécution de cet outil à plusieurs reprises avec des filtres de date différents, il est possible d’ajouter chaque sortie à une seule classe d’entités d’événement LRS via Ajouter des événements.

Paramètres

ÉtiquetteExplicationType de données
Couche d’événements source

Couche d’événements en entrée à convertir.

Feature Layer
Entités itinéraires cible en entrée

Le réseau LRS cible par rapport auquel les événements en entrée seront convertis.

Feature Layer
Couche d’événements en sortie

Classe d’entités en sortie devant contenir les entités d’événement converties.

Feature Class
Appariement d’itinéraires coïncidents
(Facultatif)

Indique la méthode utilisée pour déterminer l’itinéraire par rapport auquel l’événement sera converti lorsque des itinéraires coïncidents existent dans le réseau LRS cible. Ce paramètre n’est appliqué que si la localisation de la conversion d’événement dans le réseau LRS cible comporte des itinéraires coïncidents (itinéraires partageant une localisation).

  • Tout itinéraire coïncidentLa couche d’événements en entrée est convertie par rapport au premier des itinéraires coïncidents trouvés dans le réseau LRS cible.
  • Itinéraire avec ID d’itinéraire correspondantL’ID d’itinéraire de l’événement source est comparé aux ID d’itinéraire des itinéraires coïncidents dans le réseau LRS cible. L’événement source est converti selon les correspondances d’ID d’itinéraire dans l’événement source et le réseau cible. Les ID d’itinéraire de l’événement en entrée et du réseau LRS cible doivent correspondre exactement pour que cette méthode convertisse correctement l’événement. Pour pouvoir utiliser cette méthode, la couche d’événements en entrée doit également être un événement LRS inscrit.
  • Tous les itinéraires coïncidentsL’événement en entrée est converti par rapport à tous les itinéraires coïncidents à cette localisation dans le réseau LRS cible.
String

arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
NomExplicationType de données
in_source_event

Couche d’événements en entrée à convertir.

Feature Layer
in_target_route_features

Le réseau LRS cible par rapport auquel les événements en entrée seront convertis.

Feature Layer
out_target_event

Classe d’entités en sortie devant contenir les entités d’événement converties.

Feature Class
in_concurrent_route_matching
(Facultatif)

Indique la méthode utilisée pour déterminer l’itinéraire par rapport auquel l’événement sera converti lorsque des itinéraires coïncidents existent dans le réseau LRS cible. Ce paramètre n’est appliqué que si la localisation de la conversion d’événement dans le réseau LRS cible comporte des itinéraires coïncidents (itinéraires partageant une localisation).

  • ANYLa couche d’événements en entrée est convertie par rapport au premier des itinéraires coïncidents trouvés dans le réseau LRS cible.
  • ROUTE_IDL’ID d’itinéraire de l’événement source est comparé aux ID d’itinéraire des itinéraires coïncidents dans le réseau LRS cible. L’événement source est converti selon les correspondances d’ID d’itinéraire dans l’événement source et le réseau cible. Les ID d’itinéraire de l’événement en entrée et du réseau LRS cible doivent correspondre exactement pour que cette méthode convertisse correctement l’événement. Pour pouvoir utiliser cette méthode, la couche d’événements en entrée doit également être un événement LRS inscrit.
  • ALLL’événement en entrée est converti par rapport à tous les itinéraires coïncidents à cette localisation dans le réseau LRS cible.
String

Exemple de code

Exemple 1 d’utilisation de l’outil TranslateEventMeasures (fenêtre Python)

Le script de la fenêtre Python suivant montre comment utiliser l’outil TranslateEventMeasures en mode immédiat dans ArcGIS Pro :

# Name: TranslateEventMeasures_ex2.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_source_event = "Test Pressure Range"
in_target_route_features = "Station Series Network"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

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

# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 2 d’utilisation de l’outil TranslateEventMeasures (script autonome)

Le script autonome suivant montre comment utiliser l’outil TranslateEventMeasures dans ArcGIS Pro :

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
Concurrency = "ANY"

# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(Event, Network, Output, Concurrency)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 3 d’utilisation de l’outil TranslateEventMeasures (script autonome)

Le script autonome suivant montre comment utiliser l’outil TranslateEventMeasures dans un service d’entités :

# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

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

# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
target_route_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

# Set tool variables
output_event = r"C:\Data\LocationReferencing.gdb\outputevent"
concurrency = "ANY"

# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(source_event, target_route_network, output_event, concurrency)

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

Informations de licence

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

Rubriques connexes