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

Synthèse

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 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.

Paramètres

ÉtiquetteExplicationType 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

Paramètre constitué des champs de localisation d’itinéraire et du type d’événement 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 se situe. Il peut s'agir d'un champ numérique ou textuel.
  • Type d’événement : le type d’événement 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é.
    • 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.
  • 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 LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure 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
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.

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.

Field
Output Event Table (Table d’événements en sortie)

Table à créer.

Table
Propriétés des événements en sortie

Paramètre constitué des champs de localisation d’itinéraire et du type d’événements qui est écrit dans la table d’événement en sortie.

  • Champ d’identifiant d’itinéraire : champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement.
  • Type d’événement : type d’événements que la table d’événements en sortie contient (POINT ou LINE).
    • POINT : les événements ponctuels se produisent à un emplacement précis le long d’un itinéraire. Un seul champ de mesure doit être spécifié.
    • 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.
  • Champ M de départ : champ contenant des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est POINT ou LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure d’arrivée : champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est 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)

Précise 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ésactivé : 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})
NomExplicationType de données
in_table

Table d'événements en entrée.

Table View
in_event_properties

Paramètre constitué des champs de localisation d’itinéraire et du type d’événement 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 se situe. Il peut s'agir d'un champ numérique ou textuel.
  • Type d’événement : le type d’événement 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é.
    • 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.
  • 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 LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure 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 constitué des champs de localisation d’itinéraire et du type d’événements qui est écrit dans la table d’événement en sortie.

  • Champ d’identifiant d’itinéraire : champ qui contient des valeurs indiquant l’itinéraire sur lequel se trouve chaque événement.
  • Type d’événement : type d’événements que la table d’événements en sortie contient (POINT ou LINE).
    • POINT : les événements ponctuels se produisent à un emplacement précis le long d’un itinéraire. Un seul champ de mesure doit être spécifié.
    • 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.
  • Champ M de départ : champ contenant des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est POINT ou LIGNE. Lorsque la valeur du paramètre Type d’événement est POINT, l’étiquette de ce paramètre devient Champ de mesure.
  • Champ Mesure d’arrivée : champ qui contient des valeurs de mesure. Ce champ est nécessaire lorsque le type d’événement est LIGNE.
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 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.

  • FIELDSLa 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_FIELDSLa 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-dessous pour 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)

Informations de licence

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

Rubriques connexes