Générer une couche d’événements d’itinéraires (Référencement linéaire)

Synthèse

Crée une couche d'entités temporaire à l'aide d'itinéraires et d'événements d'itinéraires.

Lorsque vous utilisez cette couche temporaire (affichée sur une carte ou utilisée par un autre outil de géotraitement), une segmentation dynamique est effectuée.

Utilisation

  • La table d'événements en entrée peut être tout type de table pris en charge par ArcGIS.

  • Utilisez l’outil Générer une couche sur les itinéraires et/ou l’outil Générer une vue tabulaire sur les événements avant cet outil pour réduire le nombre d’itinéraires et d’événements qui seront traités.

  • Les types de tables n’ont pas tous un champ ObjectID. Lorsque ces tables sont utilisées par cet outil, la couche résultante ne peut être ni sélectionnée ni utilisée efficacement par certaines opérations de géotraitement. Envisagez d’utiliser l’outil Générer une table de requête avant cet outil pour ajouter un champ ObjectID virtuel.

Paramètres

ÉtiquetteExplicationType de données
Entités itinéraires en entrée

Entités itinéraires sur lesquels les événements sont localisés.

Feature Layer
Champ d'identifiant d'itinéraire

Champ contenant des valeurs identifiant de manière unique chaque itinéraire.

Field
Table d’événements

Table dont les lignes sont localisées le long d'itinéraires.

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
Nom de la couche ou vue tabulaire

Couche à créer. Cette couche étant stockée en mémoire, aucun chemin n'est requis.

Feature Layer
Nom du champ de décalage
(Facultatif)

Champ contenant les valeurs utilisées pour décaler les événements par rapport à leur itinéraire sous-jacent. Ce champ doit être numérique.

Field
Générer un champ pour les erreurs de localisation
(Facultatif)

Spécifie si un champ nommé LOC_ERROR doit être ajouté à la couche temporaire créée.

  • Décoché - Ne pas ajouter de champ pour stocker les erreurs de localisation. Il s’agit de l’option par défaut.
  • Coché - Ajouter un champ pour stocker les erreurs de localisation.
Boolean
Générer un champ d’angle
(Facultatif)

Spécifie si un champ nommé LOC_ANGLE doit être ajouté à la couche temporaire créée. Ce paramètre est valide uniquement si le type d'événements est POINT.

  • Décoché - Ne pas ajouter de champ pour stocker les angles de localisation. Il s’agit de l’option par défaut.
  • Coché - Ajouter un champ pour stocker les angles de localisation.
Boolean
Type d’angle calculé
(Facultatif)

Spécifie le type d’angle de localisation à calculer. Ce paramètre est valide uniquement si l’option Generate an angle field (Générer un champ d’angle) est sélectionnée.

  • NormaleL’angle normal (perpendiculaire) est alors calculé. Il s’agit de l’option par défaut.
  • TangenteL'angle de la tangente est alors calculé.
String
Ecrire le complément de l’angle sur le champ d’angle
(Facultatif)

Spécifie si le complément de l’angle de localisation doit être calculé. Ce paramètre est valide uniquement si l’option Generate an angle field (Générer un champ d’angle) est sélectionnée.

  • Décoché - Ne pas écrire le complément de l’angle. Écrit uniquement l’angle calculé. Il s’agit de l’option par défaut.
  • Coché - Ecrire le complémentaire de l'angle.
Boolean
Les événements dotés d'un décalage positif seront placés à droite des itinéraires.
(Facultatif)

Spécifie de quel côté les événements d’itinéraire avec un décalage positif sont affichés. Ce paramètre est valide seulement si un champ de décalage a été spécifié.

  • Décoché - Les événements avec un décalage positif s’affichent à gauche de l’itinéraire. Le côté de l’itinéraire est déterminé par les mesures et non pas nécessairement par le sens de numérisation. Il s’agit de l’option par défaut.
  • Coché - Les événements avec un décalage positif s’affichent à droite de l’itinéraire. Le côté de l'itinéraire est déterminé par le sens de numérisation.
Boolean
Les événements ponctuels seront générés sous forme d’entités multi-points.
(Facultatif)

Spécifie si les événements ponctuels doivent être traités comme des entités ponctuelles ou des entités multi-points.

  • Décoché - Les événements ponctuels sont traités comme des points. Il s’agit de l’option par défaut.
  • Coché - Les événements ponctuels sont traités comme des multi-points.
Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})
NomExplicationType de données
in_routes

Entités itinéraires sur lesquels les événements sont localisés.

Feature Layer
route_id_field

Champ contenant des valeurs identifiant de manière unique chaque itinéraire.

Field
in_table

Table dont les lignes sont localisées le long d'itinéraires.

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
out_layer

Couche à créer. Cette couche étant stockée en mémoire, aucun chemin n'est requis.

Feature Layer
offset_field
(Facultatif)

Champ contenant les valeurs utilisées pour décaler les événements par rapport à leur itinéraire sous-jacent. Ce champ doit être numérique.

Field
add_error_field
(Facultatif)

Spécifie si un champ nommé LOC_ERROR doit être ajouté à la couche temporaire créée.

  • NO_ERROR_FIELDNe pas ajouter de champ pour stocker les erreurs de localisation. Il s’agit de l’option par défaut.
  • ERROR_FIELDAjouter un champ pour stocker les erreurs de localisation.
Boolean
add_angle_field
(Facultatif)

Spécifie si un champ nommé LOC_ANGLE doit être ajouté à la couche temporaire créée. Ce paramètre est valide uniquement si le type d'événements est POINT.

  • NO_ANGLE_FIELDNe pas ajouter de champ pour stocker les angles de localisation. Il s’agit de l’option par défaut.
  • ANGLE_FIELDAjouter un champ pour stocker les angles de localisation.
Boolean
angle_type
(Facultatif)

Spécifie le type d’angle de localisation à calculer. Ce paramètre est valide uniquement si add_angle_field = "ANGLE_FIELD".

  • NORMALL’angle normal (perpendiculaire) est alors calculé. Il s’agit de l’option par défaut.
  • TANGENTL'angle de la tangente est alors calculé.
String
complement_angle
(Facultatif)

Spécifie si le complément de l’angle de localisation doit être calculé. Ce paramètre est valide uniquement si add_angle_field = "ANGLE_FIELD".

  • ANGLENe pas écrire le complément de l’angle. Écrit uniquement l’angle calculé. Il s’agit de l’option par défaut.
  • COMPLEMENTEcrire le complémentaire de l'angle.
Boolean
offset_direction
(Facultatif)

Spécifie de quel côté les événements d’itinéraire avec un décalage positif sont affichés. Ce paramètre est valide seulement si un champ de décalage a été spécifié.

  • LEFTLes événements avec un décalage positif s’affichent à gauche de l’itinéraire. Le côté de l’itinéraire est déterminé par les mesures et non pas nécessairement par le sens de numérisation. Il s’agit de l’option par défaut.
  • RIGHTLes événements avec un décalage positif s’affichent à droite de l’itinéraire. Le côté de l'itinéraire est déterminé par le sens de numérisation.
Boolean
point_event_type
(Facultatif)

Spécifie si les événements ponctuels doivent être traités comme des entités ponctuelles ou des entités multi-points.

  • POINTLes événements ponctuels sont traités comme des points. Il s’agit de l’option par défaut.
  • MULTIPOINTLes événements ponctuels sont traités comme des multi-points.
Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction MakeRouteEventLayer (fenêtre Python)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
Exemple 2 d’utilisation de la fonction MakeRouteEventLayer (script autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction MakeRouteEventLayer dans un script autonome Python.

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
Exemple 3 d’utilisation de la fonction MakeRouteEventLayer (script autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction MakeRouteEventLayer dans un script autonome Python.

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
Exemple 4 d’utilisation de la fonction MakeRouteEventLayer (script autonome)

Le script Python suivant illustre l’utilisation de la fonction MakeRouteEventLayer dans un script Python autonome à l’aide de données de géodatabase d’entreprise.

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

Informations de licence

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

Rubriques connexes