Transformer des événements d’itinéraire (Outils de 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 d’itinéraire, mesures, ou les deux.
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 valeur de paramètre Cluster Tolerance (Tolérance d’agrégat) importante destinée à surmonter les écarts entre les itinéraires source et cible peut produire des résultats inattendus.
La valeur de Event Type (Type d’événement) (Point ou Line (Ligne)) doit correspondre au type d’événement en entrée.
Utilisez l'outil Make Table View (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 Make Route Event Layer (Générer une couche d’événements d’itinéraires).

Etiqueter	Explication	Type de données
Input Event Table (Table d’événements en entrée)	Table d'événements en entrée.	Table View
Propriétés des événements	Champs de localisation d’itinéraire et du type d’événement dans la table d’événements en entrée. Champ Route Identifier (Identifiant d’itinéraire) : champ contenant des valeurs indiquant l’itinéraire sur lequel chaque événement se situe. Ce champ peut être de type numérique, texte ou GUID. Event Type (Type d’événement) : le type d’événement dans la table d’événements en entrée (Point ou Line (Ligne)). Point : les événements ponctuels se produisent à une localisation précise le long d’un itinéraire. Seul un champ Mesure de départ doit être spécifié. Line (Ligne) : 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. From-Measure Field (Champ Mesure 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 (Ligne). Lorsque la valeur Event Type (Type d’événement) est Point, l’étiquette de ce paramètre devient Measure Field (Champ de mesure). To-Measure Field (Champ Mesure d’arrivée) : champ contenant des valeurs de mesure d’arrivée. Ce champ, qui doit être numérique, est nécessaire lorsque le type d’événement est Line (Ligne).	Route Measure Event Properties
Source Route Features (Classe d’entités itinéraires source)	Entités itinéraires en entrée.	Feature Layer
Source Route Identifier Field (Champ d’identifiant d’itinéraire source)	Champ contenant les valeurs qui identifient de manière unique chaque itinéraire en entrée. Le champ peut être de type numérique, texte ou GUID.	Field
Target Route Features (Classe d’entités itinéraires cible)	Entités itinéraires vers lesquelles les événements en entrée sont transformés.	Feature Layer
Target Route Identifier Field (Champ d’identifiant d’itinéraire cible)	Champ contenant les valeurs qui identifient de manière unique chaque itinéraire cible. Le champ peut être de type numérique, texte ou GUID.	Field
Table d’événements en sortie	Table qui sera créée.	Table
Propriétés des événements en sortie	Champs de localisation d’itinéraire et type d’événements qui sont écrits dans la table d’événement en sortie. Route Identifier Field (Champ Identifiant d’itinéraire) : champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement. Le champ peut être de type numérique, texte ou GUID. Event Type (Type d’événement) : type d’événements que la table d’événements en sortie contient (Point ou Line (Ligne)). Point : les événements ponctuels se produisent à une localisation précise le long d’un itinéraire. Un seul champ de mesure doit être spécifié. Line (Ligne) : 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. From-Measure Field (Champ Mesure de départ) : champ contenant des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est Point ou Line (Ligne). Lorsque la valeur Event Type (Type d’événement) est Point, l’étiquette de ce paramètre devient Measure Field (Champ de mesure). To-Measure Field (Champ Mesure d’arrivée) : champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est Line (Ligne).	Route Measure Event Properties
Tolérance de grappe	Distance maximale tolérée entre les événements en entrée et les itinéraires cible.	Linear Unit
Include all fields from input (Inclure tous les champs de la sortie) (Facultatif)	Indique si la valeur du paramètre Output Event Table (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. Activé—La valeur du paramètre Output Event Table (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. Il s’agit de l’option par défaut. Décoché—La valeur du paramètre Output Event Table (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

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})

Nom	Explication	Type de données
in_table	Table d'événements en entrée.	Table View
in_event_properties	Champs de localisation d’itinéraire et du type d’événement dans la table d’événements en entrée. Route identifier field—Champ contenant des valeurs indiquant l’itinéraire sur lequel chaque événement se situe. Ce champ peut être de type numérique, texte ou GUID. Event type—Type d’événement dans la table d’événements en entrée (POINT ou `LINE`). `POINT`—Les événements ponctuels se produisent à une localisation précise 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. From-measure field—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`. To-measure field—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. Le champ peut être de type numérique, texte ou GUID.	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. Le champ peut être de type numérique, texte ou GUID.	Field
out_table	Table qui sera créée.	Table
out_event_properties	Champs de localisation d’itinéraire et type d’événements qui sont écrits dans la table d’événement en sortie. Route identifier field—Champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement. Le champ peut être de type numérique, texte ou GUID. Event type—Type d’événements que la table d’événements en sortie contient (POINT ou `LINE`). `POINT`—Les événements ponctuels se produisent à une localisation précise le long d’un itinéraire. Un seul champ de mesure 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. From-measure field—Champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est `POINT` ou `LINE`. To-measure field—Champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est `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)	Indique si la valeur du paramètre `out_table` doit contenir les champs de localisation d’itinéraires ainsi que tous les attributs provenant des événements en entrée. `FIELDS`—La valeur du paramètre `out_table` 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 valeur du paramètre `out_table` contient 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)

Le script ci-après de la fenêtre Python illustre l’utilisation de la fonction TransformRouteEvents :

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.TransformRouteEvents("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"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(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"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt,
                              target_rid, out_tbl, out_props, tol)

Environnements

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

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui