Événements superposés (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

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

Utilisation

  • Toutes les valeurs Couches d’événements en entrée doivent être des événements linéaires.

  • Le paramètre Couches d’événements ne peut inclure que des classes d’entités d’événement linéaire enregistrées dans un réseau ArcGIS Location Referencing.

  • Si les événements en entrée utilisent des méthodes de référencement linéaire (LRM) différentes, ils sont convertis à l'aide de la méthode LRM du réseau cible.

  • Cet outil prend en charge les jeux de sélection.

  • Cet outil prend en charge les filtres de définition.

  • Cet outil prend en charge les valeurs 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 du paramètre Champs de réseau.

  • Cet outil prend en charge la segmentation temporelle (tranches horaires). Il s'agit du comportement par défaut, qui peut être remplacé 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 de plusieurs champs de la classe d’entités de réseau dans la sortie à l'aide du paramètre Champs de réseau.

  • La sortie peut être enregistrée comme table ou classe d’entités.

  • Si la sortie est enregistrée comme table ou classe d’entités, elle comporte les index et champs suivants :

    IndexChamp

    Route_ID

    • Route_ID

    Rid_Dates_Me

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

  • Si le Réseau LRS cible est configuré comme réseau linéaire avec prise en charge d'un ID d'itinéraire à champs multiples, les paramètres suivants ne sont pas requis pour l'ajout d'itinéraires :

    • Champ de nom d’itinéraire
    • Champ de nom de ligne

  • Cet outil prend en charge la couche d'entités de pipeline Gas Utility Network Configuration comme couche d'entités en entrée si cette classe d'entités a été configurée pour être utilisée avec un LRS à l'aide de l'outil Configurer la classe d’entités d’un réseau de distribution.

  • S'il existe plusieurs réseaux LRS dans Gas Utility Network Configuration, les mesures des couches d'entités en entrée correspondent à celles illustrées dans la colonne de droite de la table ci-après.

    Si le LRS avec Gas Utility Network Configuration contientLes mesures de la classe d'entités PipelineLine appartinennent à

    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 dont le numéro est le plus faible dans le domaine de valeurs précodées, dLRSNetworks

    Plusieurs réseaux linéaires avec réseaux dérivés

    Réseau linéaire dont le numéro est le plus faible 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 dont le numéro est le plus faible 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.

  • Un seul événement par couche peut se trouver sur un segment d'itinéraire. Par exemple, pour la couche intitulée Limite de vitesse, un seul enregistrement d'événement de cette couche peut se trouver sur ce segment. Un segment peut contenir plusieurs événements, chacun dans sa propre couche d'événements. Utilisez l'outil ArcGIS Data Reviewer Événements non valides 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 seront converties de manière dynamique.

Feature Layer
Couches d’événements

Couches d’événements qui seront segmentées ensemble de manière dynamique sur un réseau cible.

Feature Layer
Jeu de données en sortie

Table ou classe d’entités contenant les enregistrements d’événement en sortie à créer.

Table
Inclure la géométrie
(Facultatif)

Indique si la valeur Jeu de données en sortie inclura la géométrie d'événement.

  • Décochée : la valeur n'inclura pas la géométrie d'événement. Les enregistrements d’événement seront stockés en tant que table. Il s’agit de l’option par défaut.
  • Cochée : la valeur Jeu de données en sortie inclura la géométrie d'événement. Les enregistrements d’événement seront stockés en tant que classe d’entités.
Boolean
Champs de réseau
(Facultatif)

Champs de la couche de réseau qui seront 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 seront converties de manière dynamique.

Feature Layer
event_layers
[event_layers,...]

Couches d’événements qui seront segmentées ensemble de manière dynamique sur un réseau cible.

Feature Layer
output_dataset

Table ou classe d’entités contenant les enregistrements d’événement en sortie à créer.

Table
include_geometry
(Facultatif)

Indique si la valeur output_dataset inclura la géométrie d'événement.

  • EXCLUDE_GEOMETRYLa valeur output_dataset n'inclura pas la géométrie d'événement. Les enregistrements d’événement seront stockés en tant que table. Il s’agit de l’option par défaut.
  • INCLUDE_GEOMETRYLa valeur output_dataset inclura la géométrie d'événement. Les enregistrements d’événement seront stockés en tant que classe d’entités.
Boolean
network_fields
[network_fields,...]
(Facultatif)

Champs de la couche de réseau qui seront inclus dans la sortie.

Field

Exemple de code

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

Le script de fenêtre Python ci-après 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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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\LRS\Output"
include_geometry = "EXCLUDE_GEOMETRY"
network_fields = ""

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

# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, include_geometry, network_fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 2 d'utilisation de la fonction OverlayEvents (script autonome)

Le script Python suivant 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\LRS\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 la fonction OverlayEvents (script autonome)

Le script autonome suivant 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\LRS\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
  • Standard: Nécessite ArcGIS Location Referencing
  • Advanced: Nécessite ArcGIS Location Referencing

Rubriques connexes