Événements superposés (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

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 Overlay Events (Superposer des événements)

Utilisation

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

    Sortie (Superposer des événements)

    TypeMesure de départMesure d’arrivéeÉvénement linéaire 1Événement linéaire 2Événement ponctuel

    Ligne

    0

    2

    A

    1

    <Nul>

    Point

    2

    2

    A

    1

    PE1

    Ligne

    2

    3

    A

    1

    <Nul>

    Ligne

    3

    4

    B

    1

    <Nul>

    Ligne

    4

    5

    B

    2

    <Nul>

  • 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 :
  • 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 plages d’adresses dans un réseau LRS, les valeurs des champs de plage d’adresses sont mis à jour pour chaque segment dans la sortie.

  • Si les couches d’événements en entrée utilisent différentes méthodes de référencement linéaire (LRM), elles sont traduites à l’aide de la méthode LRM du réseau cible.

  • Cet outil prend en charge les ensembles 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 segmentation par la sortie se fait toujours de manière dynamique au niveau de l’itinéraire sur le 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 ensemble de sélection aux entrées.

  • Cet outil prend en charge l’inclusion d’un ou plusieurs champs à partir 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, la sortie présente les index et champs suivants :

    IndexChamp

    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 la configuration Utility Network, les mesures pour les couches d’événements en entrée correspondent aux mesures présentées dans la deuxième colonne de la table suivante :

    Si le réseau LRS avec la configuration Utility Network contientLes 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, 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) de ArcGIS Data Reviewer pour identifier et résoudre les problèmes liés aux données d’événements.

Paramètres

ÉtiquetteExplicationType 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’axe médian 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.

  • Non 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.
  • Coché : 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.
Boolean
Champs de réseau
(Facultatif)

Champs de la couche de réseau qui vont être inclus dans la sortie.

Field

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})
NomExplicationType 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’axe médian 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.

  • EXCLUDE_GEOMETRYLa 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.
  • INCLUDE_GEOMETRYLa 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.
Boolean
network_fields
[network_fields,...]
(Facultatif)

Champs de la couche de réseau qui vont être inclus dans la sortie.

Field

Exemple de code

Exemple 1 d’utilisation de l’outil OverlayEvents (fenêtre Python)

Le script de fenêtre Python suivant illustre l’utilisation de la fonction OverlayEvents dans la fenêtre Python.

# 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 = ""

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

# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields)
Exemple 2 d’utilisation de l’outil OverlayEvents (script autonome)

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

# 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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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 = ""

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 3 d’utilisation de l’outil OverlayEvents (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction OverlayEvents dans 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
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

#Input LRS network and events are in feature service. Portal signi 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 and 2 and 3 corresponds to 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 = ""

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Informations de licence

  • Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
  • Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)

Rubriques connexes