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.
-
Le type d'événement en sortie (POINT ou LINE) 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 ArcMap à l'aide de l'outil Générer une couche d'événements d'itinéraires ou de la commande Afficher les événements d'itinéraires dans ArcMap.
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.
| 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.
| 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.
| 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)
Exemple 4 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éodatabases personnelles :
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in a personal geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.mdb"
# 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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui