Générer une couche d’événements d’itinéraire (Outils de référencement linéaire)

Résumé

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 Make Feature Layer (Générer une couche d’entités) sur les itinéraires et/ou l’outil Make Table View (Générer une vue tabulaire) sur les événements pour réduire le nombre d’itinéraires et d’événements qui seront traités avant d’exécuter cet outil.
Les types de tables n'ont pas tous un champ ID d’objet. Lorsque des tables sans champ ID d’objet sont utilisées par cet outil, la couche obtenue ne peut pas être sélectionnée ni utilisée efficacement par certaines opérations de géotraitement. Vous pouvez utiliser l’outil Make Query Table (Générer une table de requête) pour ajouter un champ ID d’objet virtuel avant d’exécuter cet outil.

Etiqueter	Explication	Type de données
Entités itinéraires en entrée	Entités itinéraires sur lesquelles 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. Le champ peut être de type numérique, texte ou GUID.	Field
Input Event Table (Table d’événements en entrée)	Table dont les lignes sont localisées le long d'itinéraires.	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
Nom de la couche ou vue tabulaire	Couche qui est créée. 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 `LOC_ERROR` est ajouté à la couche temporaire créée. Activé—Un champ destiné à stocker les erreurs de localisation est ajouté. Décoché—Aucun champ destiné à stocker les erreurs de localisation n’est ajouté. Il s’agit de l’option par défaut.	Boolean
Générer un champ d’angle (Facultatif)	Spécifie si un champ `LOC_ANGLE` est ajouté à la couche temporaire créée. Ce paramètre est valide uniquement si le type d’événements est Point. Activé—Un champ destiné à stocker les angles de localisation est ajouté. Décoché—Aucun champ destiné à stocker les angles de localisation n’est ajouté. Il s’agit de l’option par défaut.	Boolean
Type d’angle calculé (Facultatif)	Spécifie le type d'angle de localisation qui doit être calculé. Ce paramètre est valide uniquement lorsque le paramètre Generate an angle field (Générer un champ d’angle) est activé. Normal—L'angle normal (perpendiculaire) est alors calculé. Il s’agit de l’option par défaut. Tangent—L'angle de la tangente est alors calculé.	String
Écrire le complémentaire de l’angle dans le champ d’angle (Facultatif)	Spécifie si le complémentaire de l’angle de localisation est écrit. Ce paramètre est valide uniquement lorsque le paramètre Generate an angle field (Générer un champ d’angle) est activé. Activé—Le complémentaire de l’angle est écrit. Décoché—Le complémentaire de l’angle n’est pas écrit. Seul l’angle calculé est écrit. Il s’agit de l’option par défaut.	Boolean
Les événements avec un décalage positif sont positionné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é. Activé—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. 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.	Boolean
Les événements ponctuels sont générés comme des 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. Activé—Les événements ponctuels sont traités comme des multi-points. Décoché—Les événements ponctuels sont traités comme des points. Il s’agit de l’option par défaut.	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})

Nom	Explication	Type de données
in_routes	Entités itinéraires sur lesquelles les événements sont localisés.	Feature Layer
route_id_field	Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le champ peut être de type numérique, texte ou GUID.	Field
in_table	Table dont les lignes sont localisées le long d'itinéraires.	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
out_layer	Couche qui est créée. 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 `LOC_ERROR` est ajouté à la couche temporaire créée. `ERROR_FIELD`—Un champ destiné à stocker les erreurs de localisation est ajouté. `NO_ERROR_FIELD`—Aucun champ destiné à stocker les erreurs de localisation n’est ajouté. Il s’agit de l’option par défaut.	Boolean
add_angle_field (Facultatif)	Spécifie si un champ `LOC_ANGLE` est ajouté à la couche temporaire créée. Ce paramètre est valide uniquement si le type d’événements est Point. `ANGLE_FIELD`—Un champ destiné à stocker les angles de localisation est ajouté. `NO_ANGLE_FIELD`—Aucun champ destiné à stocker les angles de localisation n’est ajouté. Il s’agit de l’option par défaut.	Boolean
angle_type (Facultatif)	Spécifie le type d'angle de localisation qui doit être calculé. Ce paramètre est valide uniquement lorsque le paramètre `add_angle_field` est défini sur `ANGLE_FIELD`. `NORMAL`—L'angle normal (perpendiculaire) est alors calculé. Il s’agit de l’option par défaut. `TANGENT`—L'angle de la tangente est alors calculé.	String
complement_angle (Facultatif)	Spécifie si le complémentaire de l’angle de localisation est écrit. Ce paramètre est valide uniquement lorsque le paramètre `add_angle_field` est défini sur `ANGLE_FIELD`. `COMPLEMENT`—Le complémentaire de l’angle est écrit. `ANGLE`—Le complémentaire de l’angle n’est pas écrit. Seul l’angle calculé est écrit. Il s’agit de l’option par défaut.	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é. `RIGHT`—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. `LEFT`—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.	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. `MULTIPOINT`—Les événements ponctuels sont traités comme des multi-points. `POINT`—Les événements ponctuels sont traités comme des points. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction MakeRouteEventLayer (fenêtre Python)

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

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD",
                             "ANGLE_FIELD")

Exemple 3 d'utilisation de la fonction MakeRouteEventLayer (script autonome)

Le script Python ci-dessous indique comment utiliser 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"

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(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 avec des 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"

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr)

Environnements

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

Informations de licence