Transformer des événements d’itinéraires (Référencement linéaire)

Résumé

Transforme les mesures d'événements d'une référence d'itinéraire vers une autre et les écrit dans une nouvelle table d'événements.

Utilisation

• Les événements de transformation permettent d'utiliser les événements provenant d'une référence d'itinéraire avec un autre itinéraire possédant différents identifiants et/ou entités itinéraires.

• Tout événement entier ou partiel qui intersecte un itinéraire cible est écrit dans la nouvelle table d'événements.

• Les résultats sont meilleurs lorsque les itinéraires source et les itinéraires cible se superposent exactement.

  Attention :

  L'utilisation d'une tolérance d'agrégat importante destinée à surmonter les écarts entre les itinéraires source et cible peut produire des résultats inattendus.

• Le type d'événement en sortie (Point ou Line [Ligne]) doit correspondre au type d'événement en entrée.

• Utilisez l'outil Générer une vue tabulaire avant cet outil pour réduire efficacement le nombre d'événements qui seront traités.

• La table en sortie peut être affichée dans une carte à l’aide de l’outil Générer une couche d’événements d’itinéraires.

Syntaxe

arcpy.lr.TransformRouteEvents(in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})

Paramètre	Explication	Type de données
in_table	Table d'événements en entrée.	Table View
in_event_properties	Paramètre composé des champs de localisation d'itinéraire et du type d'événements dans la table d'événements en entrée. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Il peut s'agir d'un champ numérique ou textuel. Type d'événement - Type des événements dans la table d'événements en entrée (POINT ou LINE). POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ Mesure de départ doit être spécifié. LINE - Les événements linéaires décrivent une portion d'itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés. Champ M de départ - Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M d'arrivée - Champ contenant des valeurs de mesure. Ce champ, qui doit être numérique, est nécessaire lorsque le type d'événement est LINE.	Route Measure Event Properties
in_routes	Entités itinéraires en entrée.	Feature Layer
route_id_field	Champ contenant les valeurs qui identifient de manière unique chaque itinéraire en entrée.	Field
target_routes	Entités itinéraires vers lesquelles les événements en entrée sont transformés.	Feature Layer
target_route_id_field	Champ contenant les valeurs qui identifient de manière unique chaque itinéraire cible.	Field
out_table	Table à créer.	Table
out_event_properties	Paramètre composé des champs de localisation d'itinéraire et du type d'événements qui seront écrits dans la table d'événements en sortie. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Type d'événement - Type des événements dans la table d'événements en sortie (POINT ou LINE). POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ de mesure unique doit être spécifié. LINE - Les événements linéaires décrivent une portion d'itinéraire. Les champs de mesure de départ et d'arrivée doivent être spécifiés. Champ M de départ - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M d'arrivée - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type LINE.	Route Measure Event Properties
cluster_tolerance	Distance maximale tolérée entre les événements en entrée et les itinéraires cible.	Linear Unit
in_fields (Facultatif)	Précise si la table d'événements en sortie doit contenir les champs de localisation d'itinéraires ainsi que tous les attributs provenant des événements en entrée. FIELDS —La table d'événements en sortie contient les champs de localisation d'itinéraires ainsi que tous les attributs des événements en entrée. Il s’agit de l’option par défaut. NO_FIELDS —La table d'événements en sortie ne doit contenir que les champs de localisation d'itinéraires ainsi que le champ ObjectID des événements en entrée.	Boolean

Exemple de code

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.TransformRouteEvents_lr("pavement.dbf", "route1 LINE begin_mp end_mp", 
                              "hwy.shp", "route1", "hwy_new.shp", "route1", 
                              "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters")

Exemple 2 d'utilisation de la fonction TransformRouteEvents (script autonome)

La section suivante illustre l'utilisation de la fonction TransformRouteEvents dans un script Python autonome à l'aide de données de géodatabase fichier :

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
in_tbl = "accident"
in_props = "route1 POINT measure"
in_rt = "roads/hwy"               # hwy exists in the roads feature dataset 
in_rid = "route1" 
target_rt = "roads/hwy_new"       # hwy_new exists in the roads feature dataset 
target_rid = "route1" 
out_tbl = "trans_out2"
out_props = "route1 POINT mp"
tol = "0.1 meters"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

Exemple 3 d'utilisation de la fonction TransformRouteEvents (script autonome)

La section suivante illustre l'utilisation de la fonction TransformRouteEvents dans un script Python autonome à l'aide de données de géodatabase d’entreprise :

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = arcpy.ValidateTableName("hwy_new", wkspc) 
target_rid = "route1" 
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

Environnements

Espace de travail courant, Mot-clé de configuration en sortie, Espace de travail temporaire

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui