Événements superposés (Outils Location Referencing)

Résumé

Superpose une ou plusieurs couches d’événements linéaires et ponctuels sur un réseau cible et génère une classe d’entités ou une table en sortie qui représente la segmentation dynamique des entrées.

Illustration

Illustration de l’outil Superposer des événements

Utilisation

La table suivante est la sortie de l’illustration de l’outil ci-dessus :

Sortie (Superposer des événements)


Type	Mesure de départ	Mesure d’arrivée	Événement linéaire 1	Événement linéaire 2	Événement ponctuel
Ligne	0	2	A	1	<Null>
Point	2	2	A	1	PE1
Ligne	2	3	A	1	<Null>
Ligne	3	4	B	1	<Null>
Ligne	4	5	B	2	<Null>

Les valeurs du paramètre Event Layers (Couches d’événements) peuvent être soit uniquement des événements linéaires, soit des événements linéaires et ponctuels.
Le paramètre Event Layers (Couches d’événements) peut uniquement inclure des classes d’entités d’événements inscrites auprès d’un réseau LRS.

Remarque :

– Dans une configuration Address Data Management, après configuration de la classe d’entités d’axes médians en vue d’une utilisation avec un LRS, la classe d’entités d’axes médians peut être utilisée comme entrée du paramètre Event Layers (Couches d’événements) pour la segmentation dynamique. Le sens de numérisation de l’axe médian est respecté dans la sortie.

– Dans une configuration ArcGIS Utility Network, après configuration des classes d’entités Pipeline Line (Ligne de pipeline), Pipeline Device (Dispositif de pipeline) et Pipeline Junction (Jonction de pipeline) en vue d’une utilisation avec un LRS, ces classes d’entités peuvent être utilisées comme entrées du paramètre Event Layers (Couches d’événements) pour la segmentation dynamique.
Si la couche en entrée inclut des champs de plage d’adresses issus d’une configuration Address Data Management et est configurée en tant que classe d’entités de plage d’adresses dans un réseau LRS, les valeurs des champs de plage d’adresses sont mises à jour proportionnellement pour chaque segment dans la sortie lorsque la valeur du paramètre Address Block Split Type (Type de fractionnement du bloc d’adresses) est Proportional (Proportionnel). Lorsque la valeur du paramètre est Nearest Address Point (Point d’adresse le plus proche), les plages d’adresses sont mises à jour pour chaque segment de la sortie en fonction des points d’adresse en amont et en aval les plus proches.

En savoir plus sur les fonctionnalités d’analyse dans un jeu de données combinées LRS et Address Data Management
Si les couches d’événements en entrée utilisent différentes méthodes de référencement linéaire (LRM), elles sont converties à l’aide de la méthode LRM du réseau cible.
Cet outil prend en charge les jeux de sélection et les ensembles de définition pour les valeurs des paramètres Input Route Features (Entités itinéraires en entrée) et Event Layers (Couches d’événements).

Remarque :

Pour inclure tous les enregistrements d’événement associés aux itinéraires en entrée, désactivez le bouton bascule Use the selected records (Utiliser les enregistrements sélectionnés) ou Use the filtered records (Utiliser les enregistrements filtrés) pour chaque couche d’événements en entrée.
Cet outil prend en charge les couches d’événements en entrée configurées pour contenir des événements qui couvrent plusieurs itinéraires. La sortie est toujours segmentée de manière dynamique au niveau de l’itinéraire du réseau cible à l’aide de la valeur du paramètre Network Fields (Champs de réseau).
Cet outil prend en charge la segmentation temporelle (tranches horaires). Cette opération est effectuée par défaut et peut être ignorée en créant un ensemble de définition temporel ou en appliquant un jeu de sélection aux entrées.
Cet outil permet d’inclure un ou plusieurs champs de la classe d’entités de réseau dans la sortie à l’aide du paramètre Network Fields (Champs de réseau).
La sortie peut être enregistrée sous forme de table ou de classe d’entités.
Si la sortie est enregistrée sous forme de table ou de classe d’entités, elle présente les index et champs suivants :
Index

Champ
route_id
Route_ID
rid_dates_measures
Route_ID

From_Date

To_Date

From_Measure

To_Measure

Index	Champ
route_id	`Route_ID`
rid_dates_measures	`Route_ID` `From_Date` `To_Date` `From_Measure` `To_Measure`

S’il existe plusieurs réseaux LRS dans une configuration Utility Network, les mesures des couches d’événements en entrée correspondent à celles illustrées dans la deuxième colonne de la table suivante :


Si le LRS avec la configuration Utility Network contient	Les mesures de la classe d’entités linéaires de pipeline appartiennent à
Réseau linéaire, réseau non linéaire	Réseau linéaire
Réseau linéaire	Réseau linéaire
Plusieurs réseaux linéaires	Réseau linéaire comportant le réseau dérivé
Plusieurs réseaux linéaires sans réseau dérivé	Réseau linéaire portant le plus petit numéro dans le domaine de valeurs précodées `dLRSNetworks`
Plusieurs réseaux linéaires avec des réseaux dérivés	Réseau linéaire portant le plus petit numéro dans le domaine de valeurs précodées `dLRSNetworks`
Un réseau non linéaire	Réseau non linéaire
Plusieurs réseaux non linéaires	Réseau portant le plus petit numéro dans le domaine de valeurs précodées `dLRSNetworks`

Cet outil prend en charge les événements et les itinéraires physiquement discontinus en tant qu’événements en entrée et itinéraires en entrée, respectivement.
Chaque segment d’itinéraire peut comporter un seul événement par couche. Par exemple, pour une couche appelée Speed Limit (Limite de vitesse), un seul enregistrement d’événement peut se trouver sur ce segment. Un segment peut comporter plusieurs événements, de couches d’événements différentes. Utilisez la vérification Invalid Event Measures (Mesures d’événements non valides) d’ArcGIS Data Reviewer pour identifier et résoudre les problèmes liés aux données d’événements.
Lorsque vous exécutez cet outil avec des données issues d’un service d’entités, si vous rencontrez des échecs ou des performances ralenties, augmentez la taille du segment au niveau du service.
Le paramètre d’environnement Parallel Processing Factor (Facteur de traitement parallèle) de cet outil ne s’applique qu’aux événements étendus sur plusieurs itinéraires et aux événements non étendus qui ne sont pas inscrits auprès du réseau cible.

Etiqueter	Explication	Type de données
Entités itinéraires en entrée	Réseau cible sur lequel les couches d’événements sont segmentées de manière dynamique.	Feature Layer
Couches d’événements	Couches d’événements qui sont segmentées ensemble de manière dynamique sur un réseau cible. La couche d’axes médians peut être utilisée comme entrée pour segmenter les événements de manière dynamique.	Feature Layer
Jeu de données en sortie	Table ou classe d’entités contenant les enregistrements d’événements en sortie qui sont créés.	Table
Inclure la géométrie (Facultatif)	Indique si la valeur du paramètre Output Dataset (Jeu de données en sortie) inclut la géométrie de l’événement. Activé—La valeur du paramètre Output Dataset (Jeu de données en sortie) inclut la géométrie de l’événement. Les enregistrements d’événements sont stockés sous forme de classe d’entités. Décoché—La valeur du paramètre Output Dataset (Jeu de données en sortie) n’inclut pas la géométrie de l’événement. Les enregistrements d’événements sont stockés sous forme de table. Il s’agit de l’option par défaut.	Boolean
Champs de réseau (Facultatif)	Champs de la couche de réseau à inclure dans la sortie.	Field
Type de fractionnement du bloc d’adresses (Facultatif)	Indique le mode de mise à jour des plages d’adresses pour chaque segment de la sortie. Ce paramètre est disponible uniquement lorsqu’une couche de plage d’adresses configurée est utilisée comme couche d’événements en entrée. Point d’adresse le plus proche—Les plages d’adresses sont mises à jour pour chaque segment de la sortie en fonction des valeurs d’adresse en amont et en aval les plus proches. Proportionnel—Les plages d’adresses sont mises à jour pour chaque segment de la sortie proportionnellement à la localisation de fractionnement. Il s’agit de l’option par défaut.	String

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})

Nom	Explication	Type de données
in_route_features	Réseau cible sur lequel les couches d’événements sont segmentées de manière dynamique.	Feature Layer
event_layers [event_layers,...]	Couches d’événements qui sont segmentées ensemble de manière dynamique sur un réseau cible. La couche d’axes médians peut être utilisée comme entrée pour segmenter les événements de manière dynamique.	Feature Layer
output_dataset	Table ou classe d’entités contenant les enregistrements d’événements en sortie qui sont créés.	Table
include_geometry (Facultatif)	Indique si la valeur du paramètre `output_dataset` inclut la géométrie de l’événement. `INCLUDE_GEOMETRY`—La valeur du paramètre `output_dataset` inclut la géométrie de l’événement. Les enregistrements d’événements sont stockés sous forme de classe d’entités. `EXCLUDE_GEOMETRY`—La valeur du paramètre `output_dataset` n’inclut pas la géométrie de l’événement. Les enregistrements d’événements sont stockés sous forme de table. Il s’agit de l’option par défaut.	Boolean
network_fields [network_fields,...] (Facultatif)	Champs de la couche de réseau à inclure dans la sortie.	Field
address_block_split_type (Facultatif)	Indique le mode de mise à jour des plages d’adresses pour chaque segment de la sortie. Ce paramètre est disponible uniquement lorsqu’une couche de plage d’adresses configurée est utilisée comme couche d’événements en entrée. `NEAREST_ADDRESS_POINT`—Les plages d’adresses sont mises à jour pour chaque segment de la sortie en fonction des valeurs d’adresse en amont et en aval les plus proches. `PROPORTIONAL`—Les plages d’adresses sont mises à jour pour chaque segment de la sortie proportionnellement à la localisation de fractionnement. Il s’agit de l’option par défaut.	String

Exemple de code

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

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

# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing

# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
address_block_split_type = ""

# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"

# Run the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)

Exemple 2 d’utilisation de la fonction OverlayEvents (script autonome)

Le script autonome ci-après illustre l’utilisation de la fonction OverlayEvents.

# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

Exemple 3 d’utilisation de la fonction OverlayEvents (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction OverlayEvents avec les données d’un service d’entités.

# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

#Input LRS network and events are in feature service. Portal sign in is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network, while 2 and 3 corresponds to the input events.
in_network  = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]

# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""

# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

Environnements

Espace de travail courant, Facteur de traitement parallèle

Cas particuliers

Facteur de traitement parallèle: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores on your machine.

Informations de licence

Basic: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Standard: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
Advanced: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)