Generar registro de ruta referenciada lineal (Location Referencing)—ArcGIS Pro

Disponible con licencia de Location Referencing.

Resumen

Crea un producto de datos de registro de rutas para rutas en una red LRS sin una plantilla de datos LRS.

Uso

Esta herramienta admite datos de una geodatabase de archivos, una geodatabase corporativa (conexión con control de versiones en rama) o un servicio de entidades (publicado a partir de datos versionados en rama).
Esta herramienta no modifica las entradas y creará un archivo .csv o una tabla de base de datos geográficos como salida.
El parámetro Fecha efectiva sirve para definir una vista temporal de la red. Para calcular la salida solo se utilizarán las rutas activas en esta fecha.
Las capas de registro, las capas de ubicación y las capas de referencia deben estar almacenadas en la misma geodatabase o servicio de entidades y tener el mismo sistema de coordenadas que la red LRS especificada.
La capa de registro puede ser una clase de entidad de evento puntual LRS, una clase de entidad de evento lineal LRS o una clase de entidad de intersección LRS registrada en la red LRS especificada. Una clase de entidad de línea de centro también se puede utilizar como capa de registro cuando se configura con la solución Address Data Management o con una red de servicios.
La capa de ubicación debe ser una clase de entidad poligonal.
La salida se creará en función de la intersección de las entidades seleccionadas de la red LRS, las capas de registro y las capas de referencia.
La capa de referencia debe ser una clase de entidad de eventos puntuales LRS registrada en la red LRS especificada.
Se incluirá un valor sin clasificar en los campos de ubicación de salida para las rutas que no se superponen con las capas de ubicación.
Puede agregar varios campos de registro y ubicación de la misma clase de entidad creando capas de selección y especificando cada capa de selección como campo de registro o campo de ubicación. Por ejemplo, si cuenta con una clase de entidad de evento de línea LRS, puede crear dos capas de selección (clase A y clase B) y especificar cada capa de selección como campo de registro.

Parámetros

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de entrada	Las entidades de la ruta que se utilizarán para generar el registro de la ruta.	Feature Layer
Fecha efectiva	Fecha que se utilizará para definir la vista temporal de la red. El valor predeterminado es la fecha de hoy.	Date
Campos de registro (Opcional)	Los campos que se utilizarán para mostrar la información sobre eventos e intersecciones en la salida. Capa: la capa de entidades que se utilizará como capa de registro. Campo: el campo que participará en el registro de ruta.	Value Table
Fusionar eventos coincidentes (Opcional)	Especifica si los eventos de línea coincidentes se fusionarán en la salida. Activado: los eventos de línea coincidentes con el mismo valor en el campo de registro se fusionarán y se devolverán como un único evento. Desactivado: los eventos de línea coincidentes con el mismo valor en el campo de registro no se fusionarán ni se devolverán como un único evento. Esta es la opción predeterminada.	Boolean
Campos de ubicación (Opcional)	Los campos utilizados para mostrar los atributos de los límites poligonales atravesados por las rutas. Capa: la capa de entidades que se utilizará como capa de ubicación. Campo: el campo que contiene los atributos de los límites poligonales atravesados por las rutas.	Value Table
Ubicación de referente (Opcional)	Especifica el método que se utilizará para calcular la compensación de referencia. Ninguno—No se calculará el desplazamiento de referente. Esta es la opción predeterminada. Más cercano ascendente—Para calcular el desplazamiento del referente se utilizará el referente ascendente más cercano de la entrada del registro de rutas. Si no existe ninguna entidad referente ascendente, los valores de referencia estarán vacíos. Más cercano—Para calcular el desplazamiento del referente se utilizará la entidad referente más cercana, ascendente o descendente de la entrada del registro de rutas.	String
Entidades de referente (Opcional)	La capa de entidades que se utilizará para calcular el desplazamiento desde la entrada del registro de ruta.	Feature Layer
Campo de referente (Opcional)	El campo referente que contendrá los atributos de las entidades referentes en la salida.	Field
Unidades de desplazamiento (Opcional)	Especifica las unidades de desplazamiento que se utilizarán para calcular la distancia entre la entidad de referencia y la entrada del registro de ruta. Pulgadas (agrimensura de EE. UU.)—Las unidades serán pulgadas. Pies (agrimensura de EE. UU.)—Las unidades serán pies. Yardas (agrimensura de EE. UU.)—Las unidades serán yardas. Millas (agrimensura de EE. UU.)—Las unidades serán millas. Millas náuticas (agrimensura de EE. UU.)—Las unidades serán millas náuticas. Pies (internacional)—Las unidades serán pies internacionales. Esta es la opción predeterminada. Millas terrestres—Las unidades serán millas terrestres. Milímetros—Las unidades serán milímetros. Centímetros—Las unidades serán centímetros. Metros—Las unidades serán metros. Kilómetros—Las unidades serán kilómetros. Decímetros—Las unidades serán decímetros.	String
Formato de salida (Opcional)	Especifica el formato de la salida. CSV—La salida será un archivo .csv. Esta es la opción predeterminada. Tabla—La salida será una tabla de geodatabase.	String
Archivo de salida (Opcional)	El archivo de salida .csv que contendrá el registro de la ruta.	File
Tabla de Salida (Opcional)	La tabla de la geodatabase de salida que contendrá el registro de la ruta.	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})

Nombre	Explicación	Tipo de datos
in_route_features	Las entidades de la ruta que se utilizarán para generar el registro de la ruta.	Feature Layer
effective_date	Fecha que se utilizará para definir la vista temporal de la red. El valor predeterminado es la fecha de hoy.	Date
log_fields [log_fields,...] (Opcional)	Los campos que se utilizarán para mostrar la información sobre eventos e intersecciones en la salida. Capa: la capa de entidades que se utilizará como capa de registro. Campo: el campo que participará en el registro de ruta.	Value Table
merge_coincident_events (Opcional)	Especifica si los eventos de línea coincidentes se fusionarán en la salida. MERGE—Los eventos de línea coincidentes con el mismo valor en el campo de registro se fusionarán y se devolverán como un único evento. DO_NOT_MERGE—Los eventos de línea coincidentes con el mismo valor en el campo de registro no se fusionarán ni se devolverán como un único evento. Esta es la opción predeterminada.	Boolean
location_fields [location_fields,...] (Opcional)	Los campos utilizados para mostrar los atributos de los límites poligonales atravesados por las rutas. Capa: la capa de entidades que se utilizará como capa de ubicación. Campo: el campo que contiene los atributos de los límites poligonales atravesados por las rutas.	Value Table
referent_location (Opcional)	Especifica el método que se utilizará para calcular la compensación de referencia. NONE—No se calculará el desplazamiento de referente. Esta es la opción predeterminada. NEAREST_UPSTREAM—Para calcular el desplazamiento del referente se utilizará el referente ascendente más cercano de la entrada del registro de rutas. Si no existe ninguna entidad referente ascendente, los valores de referencia estarán vacíos. NEAREST—Para calcular el desplazamiento del referente se utilizará la entidad referente más cercana, ascendente o descendente de la entrada del registro de rutas.	String
referent_features (Opcional)	La capa de entidades que se utilizará para calcular el desplazamiento desde la entrada del registro de ruta.	Feature Layer
referent_field (Opcional)	El campo referente que contendrá los atributos de las entidades referentes en la salida.	Field
offset_units (Opcional)	Especifica las unidades de desplazamiento que se utilizarán para calcular la distancia entre la entidad de referencia y la entrada del registro de ruta. INCHES—Las unidades serán pulgadas. FEET—Las unidades serán pies. YARDS—Las unidades serán yardas. MILES—Las unidades serán millas. NAUTICAL_MILES—Las unidades serán millas náuticas. INTFEET—Las unidades serán pies internacionales. Esta es la opción predeterminada. INTMILES—Las unidades serán millas terrestres. MILLIMETERS—Las unidades serán milímetros. CENTIMETERS—Las unidades serán centímetros. METERS—Las unidades serán metros. KILOMETERS—Las unidades serán kilómetros. DECIMETERS—Las unidades serán decímetros.	String
output_format (Opcional)	Especifica el formato de la salida. CSV—La salida será un archivo .csv. Esta es la opción predeterminada. TABLE—La salida será una tabla de geodatabase.	String
out_file (Opcional)	El archivo de salida .csv que contendrá el registro de la ruta.	File
out_table (Opcional)	La tabla de la geodatabase de salida que contendrá el registro de la ruta.	Table

Muestra de código

Ejemplo 1 de GenerateLRRouteLog (ventana de Python)

El siguiente script muestra cómo utilizar la función GenerateLRRouteLog en la ventana de 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)

Ejemplo 2 de GenerateLRRouteLog (secuencia de comandos independiente)

El siguiente script independiente muestra cómo utilizar la función 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)

Ejemplo 3 de GenerateLRRouteLog (secuencia de comandos independiente)

El siguiente script independiente demuestra cómo utilizar la función de GenerateLRRouteLog con datos desde un servicio de entidades.

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)

Temas relacionados

¿Algún comentario sobre este tema?