Generar resumen de longitud referenciada lineal (Location Referencing)—ArcGIS Pro

Disponible con licencia de Location Referencing.

Resumen

Crea un producto de datos de longitud para las 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.
La capa de resumen debe ser una clase de entidad poligonal, una clase de entidad de evento de línea LRS registrada en la red LRS especificada o una red LRS.
La capa de longitud debe ser una red LRS o una clase de entidad de evento de línea LRS registrada en la red LRS especificada.
Las capas de resumen y longitud deben estar almacenadas en la misma geodatabase o servicio de entidades y tener el mismo sistema de coordenadas que la red LRS especificada.
Se incluirá un valor sin clasificar en el campo de resumen de salida para las rutas que no se superponen con las capas de resumen.
Puede agregar varios campos de resumen.
La salida se creará en función de la intersección de las entidades seleccionadas de la red LRS, las capas de resumen y las capas de longitud.
Puede añadir varios campos de longitud desde la misma clase de entidad creando capas de selección y especificando cada capa de selección como campo de longitud. 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 longitud.

Parámetros

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de entrada	Las entidades de ruta que se utilizarán para calcular el producto de datos de longitud LRS.	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
Unidades de longitud	Especifica la unidad de medida que se utilizará para los campos de longitud en la salida. 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. 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
Campos de resumen (Opcional)	Campos de las capas que se utilizarán para mostrar los nombres de las filas de resumen en la salida. Capa: la capa de entidades que se utilizará como capa de resumen. Campo: el campo que se utilizará para totalizar la longitud. Nombre del campo de salida: el nombre del campo de resumen que se visualiza en la salida.	Value Table
Campos de longitud (Opcional)	Los campos de las capas que se usarán para mostrar la longitud de las rutas en la salida. Capa: la capa de entidades que se utilizará como base para calcular la longitud. Nombre del campo de salida: el nombre del campo de longitud que se visualiza en la salida.	Value Table
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 (filas con resumen nulo) se excluirán de la salida. Esta es la opción predeterminada. Desactivado: las filas con una longitud cero (filas con resumen nulo) no se excluirán de la salida.	Boolean
Calcular la longitud de las rutas dominantes (Opcional)	Nota: La compatibilidad con este parámetro se agregará en una versión futura.	Boolean
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 .csv de salida que contendrá el producto de datos de longitud.	File
Tabla de Salida (Opcional)	La tabla de la geodatabase de salida que contendrá el producto de datos de longitud.	Table

arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, {summary_fields}, {length_fields}, {exclude_null_summary_rows}, {calculate_length_for_dominant_routes}, {output_format}, {out_file}, {out_table})

Nombre	Explicación	Tipo de datos
in_route_features	Las entidades de ruta que se utilizarán para calcular el producto de datos de longitud LRS.	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
units	Especifica la unidad de medida que se utilizará para los campos 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. INTFEET—Las unidades serán pies internacionales. 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
summary_fields [summary_fields,...] (Opcional)	Campos de las capas que se utilizarán para mostrar los nombres de las filas de resumen en la salida. Capa: la capa de entidades que se utilizará como capa de resumen. Campo: el campo que se utilizará para totalizar la longitud. Nombre del campo de salida: el nombre del campo de resumen que se visualiza en la salida.	Value Table
length_fields [length_fields,...] (Opcional)	Los campos de las capas que se usarán para mostrar la longitud de las rutas en la salida. Capa: la capa de entidades que se utilizará como base para calcular la longitud. Nombre del campo de salida: el nombre del campo de longitud que se visualiza en la salida.	Value Table
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 (filas con resumen nulo) se excluirán de la salida. Esta es la opción predeterminada. DO_NOT_EXCLUDE—Las filas con una longitud cero (filas con resumen nulo) no se excluirán de la salida.	Boolean
calculate_length_for_dominant_routes (Opcional)	Nota: La compatibilidad con este parámetro se agregará en una versión futura.	Boolean
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 .csv de salida que contendrá el producto de datos de longitud.	File
out_table (Opcional)	La tabla de la geodatabase de salida que contendrá el producto de datos de longitud.	Table

Muestra de código

Ejemplo 1 de GenerateLRLengthSummary (script independiente)

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

# Name: GenerateLRLengthSummary_ex1.py 
# Description: Create a length data product that provides the length of routes for three class types, summarized by counties with a population of more than 50,000
# Requirements: ArcGIS Location Referencing 
 
# Import arcpy module 
import arcpy 
 
# Check out any necessary licenses 
arcpy.CheckOutExtension("LocationReferencing")

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

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field
arcpy.management.MakeFeatureLayer("counties", "counties_50K", "POPULATION > 50000")

# Create 3 feature layers, each representing a class type, to be used as length fields
arcpy.management.MakeFeatureLayer("Class", "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer("Class", "Class_B", "classtype = 2")   
arcpy.management.MakeFeatureLayer("Class", "Class_C", "classtype = 3") 

# Set tool variables 
in_route_features = "Network" 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "counties_50K NAME Counties"
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV" 
out_file = r"C:\Data\LP1.csv" 
out_table = None 

# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table) 

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

Ejemplo 2 de GenerateLRLengthSummary (ventana de Python)

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

# Name: GenerateLRLengthSummary_ex2.py 
# Description: Create a length data product that provides the length of routes for all class types, summarized by counties
# Requirements: ArcGIS Location Referencing 
 
# Set tool variables 
in_route_features = "Network" 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "Counties NAME Counties" 
length_fields = "'Class' 'Class'"  
exclude_null_summary_rows = "DO_NOT_EXCLUDE" 
calculate_length_for_dominant_routes = None 
output_format = "CSV" 
out_file = r"C:\Data\LP2.csv" 
out_table = None 
 
# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     output_format, out_file, out_table)

Ejemplo 3 de GenerateLRLengthSummary (script independiente)

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

# Name: GenerateLRLengthSummary_ex3.py 
# Description: Using LRS data in a feature service, create a length data product that provides the length of routes
# for three class types, summarized by counties with a population of more than 50,000
# 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, 1 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Map the Counties layer from the feature service. Here, 39 corresponds to the Counties layer's layer ID
counties = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/39"

# Create a feature layer of counties that have more than 50,000 population, to be used as summary field 
arcpy.management.MakeFeatureLayer(counties, "counties_50K", "POPULATION > 50000")

# Map the Class layer from the feature service. Here, 22 corresponds to the Class layer's layer ID
classlayer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/22"

# Create 3 feature layers, each representing a class type, to be used as length fields 
arcpy.management.MakeFeatureLayer(classlayer, "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer(classlayer, "Class_B", "classtype = 4")   
arcpy.management.MakeFeatureLayer(classlayer, "Class_C", "classtype = 7")

# Set tool variables 
effective_date = "12/31/2024" 
units = "METERS" 
summary_fields = "counties_50K NAME Counties" 
length_fields = "Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
calculate_length_for_dominant_routes = None
output_format = "CSV" 
out_file = r"C:\Data\LP3.csv" 
out_table = None 
 
# Run the tool 
arcpy.locref.GenerateLRLengthSummary(in_route_features, effective_date, units, summary_fields, length_fields,
                                     exclude_null_summary_rows, calculate_length_for_dominant_routes,
                                     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?