Translate Event Measures (Convertir des mesures d’événements) (Outils Location Referencing)

Résumé

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.
The output feature class type—(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 Concurrent Route Matching (Appariement d’itinéraires coïncidents).
Si Route with matching Route ID (Itinéraire avec un ID d’itinéraire correspondant) est utilisé avec Concurrent Route Matching (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 Append Events (Ajouter des événements).

Etiqueter	Explication	Type 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)	Spécifie la méthode utilisée pour déterminer l’itinéraire par rapport auquel convertir l’événement 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ïncident—La 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 correspondant—L’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ïncidents—L’é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})

Nom	Explication	Type 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)	Spécifie la méthode utilisée pour déterminer l’itinéraire par rapport auquel convertir l’événement 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). `ANY`—La 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_ID`—L’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. `ALL`—L’é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 la fonction TranslateEventMeasures (fenêtre Python)

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

# Name: TranslateEventMeasures_ex1.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

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

# Tool variables
in_source_event = "TestPressureRange"
in_target_route_features = "StationSeriesNetwork"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

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

Exemple 2 d’utilisation de la fonction TranslateEventMeasures (script autonome)

Le script autonome suivant illustre l’utilisation de 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

# Local variables:
in_source_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
in_target_route_features = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
out_target_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
in_concurrent_route_matching = "ANY"

# Run Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

Exemple 3 d’utilisation de la fonction 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

# 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.
in_source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
in_target_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

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

# Run Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

Environnements

Espace de travail courant

Informations de licence