Superposer des événements d’itinéraires (Référencement linéaire)—ArcGIS Pro

Synthèse

Superpose deux tables d'événements pour créer une table d'événements en sortie qui représente l'agrégation ou l'intersection des données en entrée.

Utilisation

Il est possible d'effectuer des superpositions d'événements ligne sur ligne, ligne sur point, point sur ligne, voire point sur point.
Les événements en entrée et superposés doivent être basés sur la même référence d'itinéraire.
Les tables en entrée peuvent être tout type de table pris en charge par ArcGIS. La table en sortie peut être un fichier dBASE ou une table de géodatabase.
La table en sortie peut s’afficher dans une carte à l’aide de l’outil Générer une couche d’événements d’itinéraires.
Si les propriétés d'événement en entrée et superposé sont toutes deux de type Point, les propriétés d'événement en sortie doivent être définies également en tant que type Point.
Si les propriétés d'événement en entrée et superposé sont toutes deux de type Line (Ligne), les propriétés d'événement en sortie doivent être définies également en tant que type Line (Ligne).
Si la propriété d'événement en entrée ou la propriété d'événement superposé est de type Point, les propriétés d'événement en sortie doivent être définies en tant que type Point lorsqu’une superposition Intersect (Intersecter) est effectuée. Les propriétés d'événement en sortie doivent être définies en tant que type Line (Ligne) lorsqu’une superposition Union est effectuée.
Si les propriétés d'événement en entrée et superposé sont toutes deux de type Point, seul les points ayant exactement la même valeur de mesure sont pris en compte pour l'intersection. Il n'y a aucune tolérance de recherche.
Un index attributaire sur le champ d'identifiant d'itinéraire accélère le processus de segmentation dynamique. Si vous prévoyez d'utiliser la Table d'événements en sortie pour la segmentation dynamique, il est recommandé de créer un index attributaire.
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.
Si les événements en entrée ou les événements superposés n’ont pas de champ ObjectID, utilisez l’outil Générer une table de requête avant cet outil pour ajouter un champ ObjectID virtuel.

Paramètres

Étiquette	Explication	Type de données
Table d’événements	Table d'événements en entrée.	Table View
Propriétés des événements en entrée	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. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Il peut s'agir d'un champ numérique ou textuel. Type d'événement - Type des événements 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é. 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. 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. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M 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
Table des événements superposés	Table d'événements superposés.	Table View
Propriétés des événements superposés	Paramètre constitué des champs de localisation d'itinéraire et du type d'événement dans la table des événements superposés. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant les itinéraires le long de chaque événement. Il peut s'agir d'un champ numérique ou textuel. Type d'événement - Le type d'événement dans la table des événements superposés (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é. 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. 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 le type d'événement est POINT, l'appellation de ce paramètre devient "Champ de mesure". To-Measure Field (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
Type de superposition	Type de superposition à réaliser. Intersecter—Inscrit dans la table d'événements en sortie uniquement les événements superposés. Il s’agit de l’option par défaut. Agréger—Inscrit tous les événements dans la table en sortie. Les événements linéaires sont divisés à leurs intersections.	String
Table d’événements en sortie	Table à créer.	Table
Propriétés des événements en sortie	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. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Type d'événement - Type des événements dans la table d'événements en sortie (POINT ou LINE). POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ de mesure unique 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. Champ M de départ - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M d'arrivée - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type LINE.	Route Measure Event Properties
Conserver les événements linéaires de longueur nulle (Facultatif)	Spécifie s'il convient ou non de conserver les événements linéaires de longueur nulle dans la table en sortie. Ce paramètre est valide uniquement si le type d'événement en sortie est LINE. Activée : conserve les événements linéaires de longueur nulle. Il s’agit de l’option par défaut. Non activée — Ne conserve pas les événements linéaires de longueur nulle.	Boolean
Inclure tous les champs de la sortie (Facultatif)	Spécifie si tous les champs issus des tables d'événements en entrée et superposés doivent être inscrits dans la table d'événements en sortie. Activée : inclut tous les champs des tables en entrée dans la table en sortie. Il s’agit de l’option par défaut. Non activée : n'inclut pas tous les champs des tables en entrée dans la table en sortie. Seuls le champ ObjectID et les champs de localisation d'itinéraire sont conservés.	Boolean
Créer un index (Facultatif)	Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire inscrit dans la table d'événements en sortie. Activée : crée un index attributaire. Il s’agit de l’option par défaut. Non activée - Ne crée pas d'index attributaire.	Boolean

arcpy.lr.OverlayRouteEvents(in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})

Nom	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. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Il peut s'agir d'un champ numérique ou textuel. Type d'événement - Type des événements 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é. 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. 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. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M 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
overlay_table	Table d'événements superposés.	Table View
overlay_event_properties	Paramètre constitué des champs de localisation d'itinéraire et du type d'événement dans la table des événements superposés. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant les itinéraires le long de chaque événement. Il peut s'agir d'un champ numérique ou textuel. Type d'événement - Le type d'événement dans la table des événements superposés (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é. 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. 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 le type d'événement est POINT, l'appellation de ce paramètre devient "Champ de mesure". To-Measure Field (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
overlay_type	Type de superposition à réaliser. INTERSECT—Inscrit dans la table d'événements en sortie uniquement les événements superposés. Il s’agit de l’option par défaut. UNION—Inscrit tous les événements dans la table en sortie. Les événements linéaires sont divisés à leurs intersections.	String
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. Champ d'identifiant d'itinéraire : champ contenant des valeurs indiquant l'itinéraire sur lequel chaque événement réside. Type d'événement - Type des événements dans la table d'événements en sortie (POINT ou LINE). POINT - Les événements ponctuels se produisent à un emplacement précis le long d'un itinéraire. Seul un champ de mesure unique 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. Champ M de départ - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type POINT ou LINE. Lorsque le type d'événement est POINT, l'appellation de ce paramètre devient Champ de mesure. Champ M d'arrivée - Champ qui contiendra des valeurs de mesure. Ce champ est requis pour un événement de type LINE.	Route Measure Event Properties
zero_length_events (Facultatif)	Spécifie s'il convient ou non de conserver les événements linéaires de longueur nulle dans la table en sortie. Ce paramètre est valide uniquement si le type d'événement en sortie est LINE. ZERO—Conserve les événements linéaires de longueur nulle. Il s’agit de l’option par défaut. NO_ZERO—Ne conserve pas les événements linéaires de longueur nulle.	Boolean
in_fields (Facultatif)	Spécifie si tous les champs issus des tables d'événements en entrée et superposés doivent être inscrits dans la table d'événements en sortie. FIELDS—Inclut tous les champs des tables en entrée dans la table en sortie. Il s’agit de l’option par défaut. NO_FIELDS—N'inclut pas tous les champs des tables en entrée dans la table en sortie. Seuls le champ ObjectID et les champs de localisation d'itinéraire sont conservés.	Boolean
build_index (Facultatif)	Spécifie si un index attributaire est créé pour le champ d'identifiant d'itinéraire inscrit dans la table d'événements en sortie. INDEX—Crée un index attributaire. Il s’agit de l’option par défaut. NO_INDEX—Ne crée pas d'index attributaire.	Boolean

Exemple de code

Exemple 1 d'utilisation de la fonction OverlayRouteEvents (fenêtre Python)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr("accident.dbf", "rkey POINT mile", "pavecond.dbf", 
                            "rkey LINE fmp tmp", "INTERSECT", "accpav", 
                            "rkey POINT mile" )

Exemple 2 d'utilisation de la fonction OverlayRouteEvents (script autonome)

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

# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile"  # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, in_props)

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

Le script Python suivant illustre l'utilisation de la fonction OverlayRouteEvents dans un script Python autonome à l'aide de données de géodatabase fichier.

# Description: Line-on-line UNION overlay (both tables are in a file 
#              geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype" 
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, in_props, "UNION", 
                            out_tbl, in_props, "NO_ZERO")

Exemple 4 d'utilisation de la fonction OverlayRouteEvents (script autonome)

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

# Description: Point-on-line INTERSECT overlay (both tables are in 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 = "rkey POINT mile"  
ov_tbl = arcpy.ValidateTableName("pavecond", wkspc) 
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost"  # names are changed for out table
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, out_props)

Environnements

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

Synthèse

Utilisation

Paramètres

Exemple de code

Environnements

Cas particuliers

Informations de licence

Rubriques connexes

Dans cette rubrique