Generar producto de datos LRS (Location Referencing)—ArcGIS Pro

Disponible con licencia de Location Referencing.

Resumen

Transforma los datos LRS para crear un producto de datos de longitud, registro de ruta o recuento de entidades para las rutas seleccionadas en una red LRS.

Uso

La plantilla deber ser un archivo .json.
Utilice una clase de entidad de red para el parámetro Entidades de ruta de entrada.
Esta herramienta no modifica las entradas y creará un archivo .csv o una tabla de base de datos geográficos como salida.
Esta herramienta admite consultas de selección y definición.
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.
Al crear un producto de datos de longitud, tenga en cuenta lo siguiente:
- Utilice una plantilla de datos LRS que especifique los campos de resumen y longitud. Puede utilizar una plantilla de referencia de ubicación para tuberías o carreteras y autopistas.
- Los campos de resumen y longitud deben existir en la misma geodatabase que la capa de red LRS.
- Se admite la conversión de unidades al convertir de las unidades de medida de la red a otra unidad.
- Los parámetros Entidades de límite y Campo de resumen son válidos únicamente si no se proporciona el campo de resumen en el archivo .json.
Al crear un producto de datos de registro de ruta, tenga en cuenta lo siguiente:
- Utilice una plantilla de datos LRS que especifique los campos de registro, ubicación y referente. Puede utilizar una plantilla de referencia de ubicación para tuberías o carreteras y autopistas.
- La capa de registro y los campos deben existir en la misma geodatabase que la capa de red LRS.
- La capa de ubicación y los campos deben ser una capa poligonal y existir en la misma geodatabase que la capa de red LRS.
- La capa y los campos referentes deben ser una clase de entidad de evento de punto LRS y existir en la misma geodatabase que la capa de red LRS.
Al crear un producto de datos de recuento de entidades, tenga en cuenta lo siguiente:
- Utilice una plantilla de datos LRS que especifique los campos de recuento, resumen e identificador de ruta. Puede utilizar una plantilla de referencia de ubicación para tuberías o carreteras y autopistas.
- Los campos de recuento, resumen e identificador de ruta deben existir en la misma geodatabase que la capa de red LRS.
- Los parámetros Entidades de límite y Campo de resumen son válidos únicamente si no se proporciona el campo de resumen en el archivo .json.

Parámetros

Etiqueta	Explicación	Tipo de datos
Plantilla	La plantilla de datos LRS de entrada que especifica los campos de resumen y longitud (producto de datos de longitud), los campos de identificador de ruta, registro, ubicación y referente (producto de datos de registro de ruta), o los campos de recuento, resumen e identificador de ruta (producto de datos de recuento de entidades).	File
Entidades de ruta de entrada	La red LRS que se utilizará para calcular la longitud, el registro de ruta o el recuento de entidades.	Feature Layer
Fecha efectiva	Fecha que se utilizará para definir la vista temporal de la red.	Date
Unidades de longitud (Opcional)	Especifica las unidades de medición que se utilizarán para el campo de longitud en la salida. Este parámetro solo está disponible al crear un producto de datos de longitud. 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. Millas terrestres—Las unidades serán millas terrestres. Pies (internacional)—Las unidades serán pies internacionales. 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
Entidades de límite (Opcional)	Capa de límites que se utilizará para resumir los datos. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Feature Layer
Campo de resumen (Opcional)	Campo de la capa de límites que proporciona los nombres de las filas de resumen. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Field
Excluir filas de resumen nulas (Opcional)	Especifica si las filas de resumen nulas se excluirán de la salida. Activado: las filas con una longitud cero o un recuento de entidades se excluirán del resultado. Esta es la opción predeterminada. Desactivado: las filas con una longitud o un recuento de entidades de cero no se excluirán del resultado. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Boolean
Formato de salida (Opcional)	Especifica el formato del archivo de salida. CSV—El archivo de salida será un archivo .csv. Esta es la opción predeterminada. Tabla—El archivo de salida será una tabla de geodatabase.	String
Archivo de salida (Opcional)	El archivo .csv de salida donde se escribirá la longitud calculada, el registro de ruta o el recuento de entidades.	File
Tabla de Salida (Opcional)	La tabla de geodatabase que se creará con la longitud calculada, el registro de ruta o el recuento de entidades.	Table

arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, {units}, {boundary_features}, {summary_field}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})

Nombre	Explicación	Tipo de datos
in_template	La plantilla de datos LRS de entrada que especifica los campos de resumen y longitud (producto de datos de longitud), los campos de identificador de ruta, registro, ubicación y referente (producto de datos de registro de ruta), o los campos de recuento, resumen e identificador de ruta (producto de datos de recuento de entidades).	File
in_route_features	La red LRS que se utilizará para calcular la longitud, el registro de ruta o el recuento de entidades.	Feature Layer
effective_date	Fecha que se utilizará para definir la vista temporal de la red.	Date
units (Opcional)	Especifica las unidades de medición que se utilizarán para el campo de longitud en la salida. Este parámetro solo está disponible al crear un producto de datos de longitud. 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. INTMILES—Las unidades serán millas terrestres. INTFEET—Las unidades serán pies internacionales. 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
boundary_features (Opcional)	Capa de límites que se utilizará para resumir los datos. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Feature Layer
summary_field (Opcional)	Campo de la capa de límites que proporciona los nombres de las filas de resumen. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Field
exclude_null_summary_rows (Opcional)	Especifica si las filas de resumen nulas se excluirán de la salida. EXCLUDE—Las filas con una longitud cero o un recuento de entidades se excluirán del resultado. Esta es la opción predeterminada. DO_NOT_EXCLUDE—Las filas con una longitud o un recuento de entidades de cero no se excluirán del resultado. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades.	Boolean
output_format (Opcional)	Especifica el formato del archivo de salida. CSV—El archivo de salida será un archivo .csv. Esta es la opción predeterminada. TABLE—El archivo de salida será una tabla de geodatabase.	String
out_file (Opcional)	El archivo .csv de salida donde se escribirá la longitud calculada, el registro de ruta o el recuento de entidades.	File
out_table (Opcional)	La tabla de geodatabase que se creará con la longitud calculada, el registro de ruta o el recuento de entidades.	Table

Muestra de código

Ejemplo 1 de GenerateLrsDataProduct (script independiente)

El siguiente script independiente muestra cómo utilizar la función GenerateLrsDataProduct en un script independiente.

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a data product for the selected routes in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2024"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP1.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in licenses
arcpy.CheckInExtension("LocationReferencing")

Ejemplo 2 de GenerateLrsDataProduct (ventana de Python)

El siguiente script muestra cómo utilizar la función GenerateLrsDataProduct en la ventana de Python.

# Name: GenerateLrsDataProduct_ex2.py
# Description: Transforms LRS data to create a data product for the selected routes in an LRS Network in the inline Python window in ArcGIS Pro.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2024"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "DO_NOT_EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP2.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

Ejemplo 3 de GenerateLrsDataProduct (script independiente)

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

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a data product for the selected routes using a feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

# Input event and target LRS network are in feature service.  Signing in 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, 1 corresponds to the target LRS Network's layer ID.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Set tool variables
in_template = r"C:\Data\Template.json"
effective_date = "12/31/2024"
units = "FEET"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV"
out_file = r"C:\Data\LP3.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLrsDataProduct(in_template, in_route_features, effective_date, units, boundary_features, summary_field, exclude_null_summary_rows, output_format, out_file, out_table)

# Check in 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?