Superposer des événements d’itinéraire (Outils de référencement linéaire)

Résumé

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.
La table en entrée peut être tout type de table pris en charge par ArcGIS. La table en sortie peut être un fichier .dbf ou une table de géodatabase.
La valeur du paramètre Output Event Table (Table d’événements en sortie) peut s’afficher dans une carte via l’outil [Make Route Event Layer (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 lorsque la valeur du paramètre Type of Overlay (Type de superposition) est Intersect (Intersecter). Les propriétés d’événement en sortie doivent être définies en tant que type Line (Ligne) lorsque la valeur du paramètre Type of Overlay (Type de superposition) est Union.
Si les propriétés d'événement en entrée et superposé sont toutes deux de type Point, seuls 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 de l’itinéraire accélère la segmentation dynamique. Si vous comptez utiliser la valeur du paramètre Output Event Table (Table d’événements en sortie) pour la segmentation dynamique, il est recommandé de créer un index attributaire.
Utilisez l’outil Make Table View (Générer une vue tabulaire) avant d’exécuter cet outil pour réduire le nombre d’événements à traiter.
Si les événements en entrée ou les événements superposés n’ont pas de champ ObjectID, utilisez l’outil Make Query Table [(Générer une table de requête)(../data-management/make-query-table.yml)] avant d’exécuter cet outil pour ajouter un champ ObjectID virtuel.

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 en entrée	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
Table des événements superposés	Table d'événements superposés.	Table View
Propriétés des événements superposés	Champs de localisation d’itinéraire et du type d’événement dans la table des événements superposés. Route Identifier Field (Champ Identifiant d’itinéraire) : champ contenant des valeurs indiquant l’itinéraire le long de chaque événement. Ce champ peut être de type numérique, texte ou GUID. Type d’événement : type d’événements dans la table d’événements superposés (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 de départ. Ce champ, qui doit être numérique, est nécessaire lorsque le type d’événement est Point ou Line (Ligne). Lorsque Event Type (Type d’événement) a pour valeur 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
Type de superposition	Spécifie le type de superposition à réaliser. Intersecter—Seuls les événements superposés sont inscrits dans la table d’événements en sortie. Il s’agit de l’option par défaut. Agréger—Tous les événements sont inscrits dans la table en sortie. Les événements linéaires sont divisés à leurs intersections.	String
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
Conserver les événements linéaires de longueur nulle (Facultatif)	Indique si les événements linéaires de longueur nulle sont ajoutés à la valeur du paramètre Output Event Table (Table d’événements en sortie). Ce paramètre est valide uniquement si le type d’événement en sortie est Line (Ligne). Activé—Les événements linéaires de longueur nulle sont ajoutés. Il s’agit de l’option par défaut. Décoché—Les événements linéaires de longueur nulle ne sont pas ajoutés.	Boolean
Include all fields from input (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 inclus dans la valeur du paramètre Output Event Table (Table d’événements en sortie). Activé—Tous les champs des tables en entrée sont inclus dans la table en sortie. Il s’agit de l’option par défaut. Décoché—Tous les champs des tables en entrée ne sont pas inclus dans la table en sortie. Seuls le champ `ObjectID` et les champs de localisation d’itinéraire sont inclus.	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 valeur du paramètre Output Event Table (Table d’événements en sortie). Activé—Un index attributaire est créé. Il s’agit de l’option par défaut. Décoché—Aucun index attributaire n’est créé.	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	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
overlay_table	Table d'événements superposés.	Table View
overlay_event_properties	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. Ce champ peut être de type numérique, texte ou GUID. Type d’événement : type d’événement dans la table d’événements superposés (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. Champ de 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`. Champ de 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	Spécifie le type de superposition à réaliser. `INTERSECT`—Seuls les événements superposés sont inscrits dans la table d’événements en sortie. Il s’agit de l’option par défaut. `UNION`—Tous les événements sont inscrits dans la table en sortie. Les événements linéaires sont divisés à leurs intersections.	String
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
zero_length_events (Facultatif)	Indique si les événements linéaires de longueur nulle sont ajoutés à la valeur du paramètre `out_table`. Ce paramètre est valide uniquement si l’événement en sortie est de type `LINE`. `ZERO`—Les événements linéaires de longueur nulle sont ajoutés. Il s’agit de l’option par défaut. `NO_ZERO`—Les événements linéaires de longueur nulle ne sont pas ajoutés.	Boolean
in_fields (Facultatif)	Spécifie si tous les champs issus des tables d’événements en entrée et superposés doivent être inclus dans la valeur du paramètre `out_table`. `FIELDS`—Tous les champs des tables en entrée sont inclus dans la table en sortie. Il s’agit de l’option par défaut. `NO_FIELDS`—Tous les champs des tables en entrée ne sont pas inclus dans la table en sortie. Seuls le champ `ObjectID` et les champs de localisation d’itinéraire sont inclus.	Boolean
build_index (Facultatif)	Spécifie si un index attributaire est créé pour le champ d’identifiant d’itinéraire écrit dans la valeur du paramètre `out_table`. `INDEX`—Un index attributaire est créé. Il s’agit de l’option par défaut. `NO_INDEX`—Aucun index attributaire n’est créé.	Boolean

Exemple de code

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

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

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

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

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(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 avec des données de géodatabase d’entreprise.

# Description: Point-on-line INTERSECT overlay (both tables are 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 = "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

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

Informations de licence