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

Résumé

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 Effective Date (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’axes médians 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 ou une classe d’entités d’intersection 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.
You can add multiple log and location fields from the same feature class by creating selection layers et en spécifiant chaque couche de sélection soit en tant que champ de journal, soit en tant que 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.

Etiqueter	Explication	Type 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. Colonnes de la table de valeurs : Layer—The feature layer that will be used as the log layer. Field—The field that will participate in the route log.	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écoché—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. Colonnes de la table de valeurs : Layer—The feature layer that will be used as the location layer. Field—The field that contains the attributes of the polygon boundaries crossed by the routes.	Value Table
Localisation de référence (Facultatif)	Indique la méthode utilisée pour le calcul du décalage de référence. Aucun—Le décalage de référence n’est pas calculé. Il s’agit de l’option par défaut. Le plus proche en amont—L’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 proches—L’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éricains—Les unités seront les pouces. Pieds d’arpentage américains—Les unités seront les pieds. Yards d’arpentage américains—Les unités seront les yards. Miles d’arpentage américains—Les unités seront les miles. Milles nautiques (Arpentage américain)—L’unité est le mille nautique. Pieds internationaux—L’unité est le pied international. Il s’agit de l’option par défaut. Milles terrestres—L’unité est le mille terrestre. Millimètres—L'unité est le millimètre. Centimètres—L'unité est le centimètre. Mètres—Les unités seront les mètres. Kilomètres—Les unités seront les kilomètres. Décimètres—L'unité est le décimètre.	String
Format de sortie (Facultatif)	Spécifie le format de la sortie. CSV—La sortie est un fichier `.csv`. Il s’agit de l’option par défaut. Tableau—La sortie est une table de géodatabase.	String
Fichier en sortie (Facultatif)	Fichier `.csv` en sortie contenant 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})

Nom	Explication	Type 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. Colonnes de la table de valeurs : `Layer`—The feature layer that will be used as the log layer. `Field`—The field that will participate in the route log.	Value Table
merge_coincident_events (Facultatif)	Indique si les événements linéaires coïncidents sont fusionnés dans la sortie. `MERGE`—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. `DO_NOT_MERGE`—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
location_fields [location_fields,...] (Facultatif)	Champs utilisés pour afficher les attributs des limites de polygone que les itinéraires croisent. Colonnes de la table de valeurs : `Layer`—The feature layer that will be used as the location layer. `Field`—The field that contains the attributes of the polygon boundaries crossed by the routes.	Value Table
referent_location (Facultatif)	Indique la méthode utilisée pour le calcul du décalage de référence. `NONE`—Le décalage de référence n’est pas calculé. Il s’agit de l’option par défaut. `NEAREST_UPSTREAM`—L’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. `NEAREST`—L’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. `INCHES`—Les unités seront les pouces. `FEET`—Les unités seront les pieds. `YARDS`—Les unités seront les yards. `MILES`—Les unités seront les miles. `NAUTICAL_MILES`—L’unité est le mille nautique. `INTFEET`—L’unité est le pied international. Il s’agit de l’option par défaut. `INTMILES`—L’unité est le mille terrestre. `MILLIMETERS`—L'unité est le millimètre. `CENTIMETERS`—L'unité est le centimètre. `METERS`—Les unités seront les mètres. `KILOMETERS`—Les unités seront les kilomètres. `DECIMETERS`—L'unité est le décimètre.	String
output_format (Facultatif)	Spécifie le format de la sortie. `CSV`—La sortie est un fichier `.csv`. Il s’agit de l’option par défaut. `TABLE`—La sortie est une table de géodatabase.	String
out_file (Facultatif)	Fichier `.csv` en sortie contenant 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 suivant illustre l’utilisation de 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-après 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

# 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 ci-dessous 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

# 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)

Environnements

Espace de travail courant

Informations de licence