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 longitud para las rutas seleccionadas en una red LRS. Por ejemplo, utilice esta herramienta para resumir las millas de un conjunto de rutas o líneas según un límite de condado.

Uso

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.
La plantilla deber ser un archivo .json.
Utilice una clase de entidad de red para el valor del parámetro Entidades de ruta de entrada.
Esta herramienta no modifica las entradas y creará un archivo .csv 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.
Esta herramienta admite la conversión de unidades al convertir las unidades de medida de la red en 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.
Si la red tiene rutas con problemas de calibración o con longitud cero, compruebe el parámetro Excluir filas de resumen nulas para excluir esas rutas de la salida. En caso contrario, esas rutas se incluirán en la salida con una longitud de cero.

Parámetros

Etiqueta	Explicación	Tipo de datos
Plantilla	Plantilla de datos LRS de entrada que especifica los campos de resumen y longitud.	File
Entidades de ruta de entrada	Red LRS que se utilizará para calcular la longitud.	Feature Layer
Fecha efectiva	Fecha que se utilizará para definir la vista temporal de la red.	Date
Unidades de longitud	Especifica las unidades de medición que se utilizarán para el campo de longitud en la salida. Pulgadas—Las unidades serán pulgadas. Pies—Las unidades serán pies. Yardas—Las unidades serán yardas. Millas—Las unidades serán millas. Millas náuticas—Las unidades serán millas náuticas. Millas internacionales—Las unidades serán millas internacionales. Pies internacionales—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.	Feature Layer
Campo de resumen (Opcional)	Campo de la capa de límites que proporciona los nombres de las filas de resumen.	Field
Excluir filas de resumen nulas (Opcional)	Especifica si las filas de resumen nulas se excluirán de la salida. Activado: las rutas sin calibrar o las rutas con longitud cero se excluirán de la salida. Esta es la opción predeterminada. Desactivado: las rutas sin calibrar o las rutas con longitud cero no se excluirán de la salida; se incluirán en la salida con un kilometraje de 0.	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.	String
Archivo de salida (Opcional)	Archivo .csv de salida en el que se escribirá la longitud calculada.	File
Tabla de Salida (Opcional)	Tabla que se creará con la longitud calculada.	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	Plantilla de datos LRS de entrada que especifica los campos de resumen y longitud.	File
in_route_features	Red LRS que se utilizará para calcular la longitud.	Feature Layer
effective_date	Fecha que se utilizará para definir la vista temporal de la red.	Date
units	Especifica las unidades de medición que se utilizarán para el campo de longitud en la salida. 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 internacionales. 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.	Feature Layer
summary_field (Opcional)	Campo de la capa de límites que proporciona los nombres de las filas de resumen.	Field
exclude_null_summary_rows (Opcional)	Especifica si las filas de resumen nulas se excluirán de la salida. EXCLUDE—Las rutas sin calibrar o las rutas con longitud cero se excluirán de la salida. Esta es la opción predeterminada. DO_NOT_EXCLUDE—Las rutas sin calibrar o las rutas con longitud cero no se excluirán de la salida; se incluirán en la salida con un kilometraje de 0.	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.	String
out_file (Opcional)	Archivo .csv de salida en el que se escribirá la longitud calculada.	File
out_table (Opcional)	Tabla que se creará con la longitud calculada.	Table

Muestra de código

Ejemplo 1 de GenerateLrsDataProduct (script independiente)

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

# Name: GenerateLrsDataProduct_ex1.py
# Description: Transforms LRS data to create a Length 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="06/03/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 Length 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="06/03/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 muestra cómo utilizar la función GenerateLrsDataProduct en un servicio de entidades.

# Name: GenerateLrsDataProduct_Ex3.py
# Description: Transforms LRS data to create a Length 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="06/03/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?