Générer un produit de données Journal d’itinéraire avec référencement linéaire (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Crée un produit de données de journal d’itinéraire pour les itinéraires d’un réseau LRS sans modèle de données LRS.

Utilisation

  • Cet outil prend en charge les données d’une géodatabase fichier, d’une géodatabase d’entreprise (connexion de versionnement de branche) ou d’un service d’entités (publié à partir de données en branche versionnées).

  • Cet outil ne modifie pas les entrées et crée un fichier .csv ou une table de géodatabase en sortie.

  • Le paramètre Date d’effet permet de définir la vue temporelle du réseau. Seuls les itinéraires actifs à cette date servent à calculer la sortie.

  • Les couches de journal, de localisation et de référence doivent être stockées dans la même géodatabase ou le même service d’entités et avoir le même système de coordonnées que le réseau LRS spécifié.

  • La couche de journal peut être une classe d’entités d’événement ponctuel LRS, une classe d’entités d’événement linéaire LRS ou une classe d’entités d’intersection LRS inscrite auprès du réseau LRS spécifié. Une classe d’entités d’axe médian peut également être utilisée comme couche de journal lorsqu’elle est configurée avec la solution Address Data Management ou un réseau de distribution.

  • La couche de localisation doit être une classe d’entités surfaciques.

  • La sortie sera créée en se basant sur l’intersection des entités sélectionnées à partir du réseau LRS, des couches de journal, des couches de localisation et de la couche de référence.

  • La couche de référence doit être une classe d’entités d’événement ponctuel LRS inscrite auprès du réseau LRS spécifié.

  • Une valeur non classée est incluse dans les champs de localisation en sortie des itinéraires qui ne sont pas superposés avec les couches de localisation.

  • Vous pouvez ajouter plusieurs champs de journal et de localisation de la même classe d’entités en créant des couches de sélection et en définissant chaque couche de sélection comme champ de journal ou champ de localisation. Par exemple, si vous avez une classe d’entités d’événement linéaire LRS, vous pouvez créer deux couches de sélection (Classe A et Classe B) et définir chaque couche de sélection comme champ de journal.

Paramètres

ÉtiquetteExplicationType de données
Entités itinéraires en entrée

Entités itinéraires utilisées pour générer le journal d’itinéraire.

Feature Layer
Date d’effet

Date d’effet à utiliser pour définir la vue temporelle du réseau.

La valeur par défaut est la date d’aujourd’hui.

Date
Champs de journal
(Facultatif)

Champs utilisés pour afficher les informations sur l’événement et l’intersection dans la sortie.

  • Couche : couche d’entités utilisée comme couche de journal.
  • Champ : champ figurant dans le journal d’itinéraire.

Value Table
Fusionner les événements coïncidents
(Facultatif)

Indique si les événements linéaires coïncidents sont fusionnés dans la sortie.

  • Activé : les événements linéaires coïncidents dont la valeur du champ de journal est identique sont fusionnés et renvoyés en tant qu’un seul événement.
  • Désactivé : les événements linéaires coïncidents dont la valeur du champ de journal est identique ne sont pas fusionnés ni renvoyés en tant qu’un seul événement. Il s’agit de l’option par défaut.
Boolean
Champs de localisation
(Facultatif)

Champs utilisés pour afficher les attributs des limites de polygone que les itinéraires croisent.

  • Couche : couche d’entités utilisée comme couche de localisation.
  • Champ : champ contenant les attributs des limites de polygone que les itinéraires croisent.
Value Table
Localisation de référence
(Facultatif)

Indique la méthode utilisée pour le calcul du décalage de référence.

  • AucunLe décalage de référence n’est pas calculé. Il s’agit de l’option par défaut.
  • Le plus proche en amontL’entité de référence la plus proche située en amont de l’entrée de journal d’itinéraire est utilisée pour calculer le décalage de référence. En l’absence d’entité de référence en amont, les valeurs de référence sont vides.
  • Les plus prochesL’entité de référence la plus proche, située en amont ou en aval de l’entrée de journal d’itinéraire, est utilisée pour calculer le décalage de référence.
String
Entités de référence
(Facultatif)

Couche d’entités utilisée pour calculer le décalage à partir de l’entrée de journal d’itinéraire.

Feature Layer
Champ de référence
(Facultatif)

Champ de référence qui contient les attributs des entités de référence dans la sortie.

Field
Unités du décalage
(Facultatif)

Spécifie les unités de décalage utilisées pour calculer la distance entre l’entité de référence et l’entrée de journal d’itinéaire.

  • Pouces d’arpentage américainsLes unités seront les pouces.
  • Pieds d’arpentage américainsL’unité est le pied.
  • Yards d’arpentage américainsL’unité est le yard.
  • Miles d’arpentage américainsL’unité est le mile.
  • Milles nautiques (Arpentage américain)L’unité est le mille nautique.
  • Pieds internationauxL’unité est le pied international. Il s’agit de l’option par défaut.
  • Milles terrestresL’unité est le mille terrestre.
  • MillimètresL'unité est le millimètre.
  • CentimètresL'unité est le centimètre.
  • MètresL’unité est le mètre.
  • KilomètresL’unité est le kilomètre
  • DécimètresL'unité est le décimètre.
String
Format en sortie
(Facultatif)

Spécifie le format de la sortie.

  • CSVLa sortie est un fichier .csv. Il s’agit de l’option par défaut.
  • TableLa sortie est une table de géodatabase.
String
Fichier en sortie
(Facultatif)

Fichier .csv en sortie devant contenir le journal d’itinéraire.

File
Table en sortie
(Facultatif)

Table de géodatabase en sortie devant contenir le journal d’itinéraire.

Table

arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, {log_fields}, {merge_coincident_events}, {location_fields}, {referent_location}, {referent_features}, {referent_field}, {offset_units}, {output_format}, {out_file}, {out_table})
NomExplicationType de données
in_route_features

Entités itinéraires utilisées pour générer le journal d’itinéraire.

Feature Layer
effective_date

Date d’effet à utiliser pour définir la vue temporelle du réseau.

La valeur par défaut est la date d’aujourd’hui.

Date
log_fields
[log_fields,...]
(Facultatif)

Champs utilisés pour afficher les informations sur l’événement et l’intersection dans la sortie.

  • Couche : couche d’entités utilisée comme couche de journal.
  • Champ : champ figurant dans le journal d’itinéraire.

Value Table
merge_coincident_events
(Facultatif)

Indique si les événements linéaires coïncidents sont fusionnés dans la sortie.

  • MERGELes événements linéaires coïncidents dont la valeur du champ de journal est identique sont fusionnés et renvoyés en tant qu’un seul événement.
  • DO_NOT_MERGELes événements linéaires coïncidents dont la valeur du champ de journal est identique ne sont pas fusionnés ni renvoyés en tant qu’un seul événement. Il s’agit de l’option par défaut.
Boolean
location_fields
[location_fields,...]
(Facultatif)

Champs utilisés pour afficher les attributs des limites de polygone que les itinéraires croisent.

  • Couche : couche d’entités utilisée comme couche de localisation.
  • Champ : champ contenant les attributs des limites de polygone que les itinéraires croisent.
Value Table
referent_location
(Facultatif)

Indique la méthode utilisée pour le calcul du décalage de référence.

  • NONELe décalage de référence n’est pas calculé. Il s’agit de l’option par défaut.
  • NEAREST_UPSTREAML’entité de référence la plus proche située en amont de l’entrée de journal d’itinéraire est utilisée pour calculer le décalage de référence. En l’absence d’entité de référence en amont, les valeurs de référence sont vides.
  • NEARESTL’entité de référence la plus proche, située en amont ou en aval de l’entrée de journal d’itinéraire, est utilisée pour calculer le décalage de référence.
String
referent_features
(Facultatif)

Couche d’entités utilisée pour calculer le décalage à partir de l’entrée de journal d’itinéraire.

Feature Layer
referent_field
(Facultatif)

Champ de référence qui contient les attributs des entités de référence dans la sortie.

Field
offset_units
(Facultatif)

Spécifie les unités de décalage utilisées pour calculer la distance entre l’entité de référence et l’entrée de journal d’itinéaire.

  • INCHESLes unités seront les pouces.
  • FEETL’unité est le pied.
  • YARDSL’unité est le yard.
  • MILESL’unité est le mile.
  • NAUTICAL_MILESL’unité est le mille nautique.
  • INTFEETL’unité est le pied international. Il s’agit de l’option par défaut.
  • INTMILESL’unité est le mille terrestre.
  • MILLIMETERSL'unité est le millimètre.
  • CENTIMETERSL'unité est le centimètre.
  • METERSL’unité est le mètre.
  • KILOMETERSL’unité est le kilomètre
  • DECIMETERSL'unité est le décimètre.
String
output_format
(Facultatif)

Spécifie le format de la sortie.

  • CSVLa sortie est un fichier .csv. Il s’agit de l’option par défaut.
  • TABLELa sortie est une table de géodatabase.
String
out_file
(Facultatif)

Fichier .csv en sortie devant contenir le journal d’itinéraire.

File
out_table
(Facultatif)

Table de géodatabase en sortie devant contenir le journal d’itinéraire.

Table

Exemple de code

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

Le script ci-dessous montre comment utiliser la fonction GenerateLRRouteLog dans la fenêtre Python.

# Name: GenerateLRRouteLog_ex1.py 
# Description: Create a route log data product that returns the location and information of signal events,
# functional class events, reference posts, intersections, and county boundaries for routes in an LRS Network
# Requirements: ArcGIS Location Referencing

# Set tool variables 
in_route_features = "CountyLog"
effective_date = "12/31/2024"
log_fields = "Signal SIGNAL_MODE; Functional_Class FUNCTIONAL_CLASS; Intersections IntersectionName"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME"
referent_location = "NEAREST_UPSTREAM"
referent_features = "Reference_Post"
referent_field = "POST_NAME"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL1"

# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)
Exemple 2 d’utilisation de la fonction GenerateLRRouteLog (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction GenerateLRRouteLog.

# Name: GenerateLRRouteLog_ex2.py 
# Description: For routes in an LRS Network, create a route log data product that returns the location and information of anomalies, pipes, crossing utility intersections, operating pressure,
# ILI surveys, as well as county and city boundaries
# Requirements: ArcGIS Location Referencing

# Import arcpy module 
import arcpy 
 
# Check out the license 
arcpy.CheckOutExtension("LocationReferencing")

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

# Using the Anomaly point event feature class, create a feature layer that contains active anomalies, to be used as a log layer
arcpy.management.MakeFeatureLayer("Anomaly", "Anomaly_Active", "anomalystatus = 'Active'")

# Using the Pipes line event feature class, create three feature layers, each representing a different pipe material, to be used as log layers
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_CastIron", "MATERIAL = 2") 
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Copper", "MATERIAL = 4") 
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Composite", "MATERIAL = 10") 

# Set tool variables 
in_route_features = "Engineering Network"
effective_date = "12/31/2024"
log_fields = "Anomaly_Active anomalytype; Crossing Utility Intersection intersectionname; Pipes_CastIron status; Pipes_Copper status; Pipes_Composite status; Operating Pressure pressurevalue"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME; Cities CITY_NM"
referent_location = "NEAREST_UPSTREAM"
referent_features = "ILI Survey Readings"
referent_field = "surveytype"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL2"
 
# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)
Exemple 3 d’utilisation de la fonction GenerateLRRouteLog (script autonome)

Le script autonome suivant illustre l’utilisation de la fonction GenerateLRRouteLog avec les données d’un service d’entités.

# Name: GenerateLRRouteLog_ex3.py 
# Description: Create a route log data product that returns the location and information of crashes, speed limits, pavement conditions,
# centerlines, intersections, and city boundaries for routes in a combined LRS and Address Data Management dataset that is published as a feature service
# Requires: ArcGIS Location Referencing 
 
# Import arcpy module 
import arcpy 
 
# Check out the license 
arcpy.CheckOutExtension("LocationReferencing") 
 
# Data is in a feature service. Signing in to the Enterprise portal is required to access the feature service
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password') 
 
# Map the LRS Network from the feature service. Here, 11 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/11"

# Create the feature layers from the feature service. The feature layers will be used as log layers
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/25", "crash")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/24", "intersections")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/17", "speed_limit")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/14", "pavement_condition")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/19", "centerline")

# Create a feature layer from the Cities layer of the feature service to be used as the location layer
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/21", "cities")

# Map the Reference Post layer from the feature service to be used as the input to the referent_features parameter
referent_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/26"

# Set tool variables 
effective_date = "12/31/2024"
log_fields = "crash CrashType; intersections IntersectionName; speed_limit SpeedLimit; pavement_condition Condition; centerline fullname"
merge_coincident_events = "MERGE"
location_fields = "cities name"
referent_location = "NEAREST"
referent_field = "PostName"
offset_units = "INTFEET"
output_format = "CSV"
out_file = r"C:\Data\RL3.csv"
out_table = None
 
# Run the tool 
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)
 
# Check in the 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