Transformer des événements d'itinéraires (Référencement linéaire)
Récapitulatif
Cet outil 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 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 s'afficher 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
| 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
import arcpy
from arcpy import env
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" )
La section suivante illustre l'utilisation de la fonction Transformer des événements d'itinéraires 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)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
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)
La section suivante illustre l'utilisation de la fonction Transformer des événements d'itinéraires dans un script Python autonome à l'aide de données de géodatabase personnelle :
# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in a personal geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
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)
La section suivante illustre l'utilisation de la fonction Transformer des événements d'itinéraires dans un script Python autonome à l'aide de données ArcSDE :
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "route1 POINT measure"
in_rt = gp.QualifyTableName("hwy", wkspc)
in_rid = "route1"
target_rt = gp.QualifyTableName("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)