Generar resumen de longitud referenciada lineal (Herramientas de Referenciación de ubicación)

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 geodatabase 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.
You can add multiple length fields from the same feature class by creating selection layers y especificar cada capa de selección como un 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.

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. Columnas de la tabla de valores: Layer—The feature layer that will be used as the summary layer. Field—The field that will be used to summarize the length. Output Field Name—The summary field's display name in the output.	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. Columnas de la tabla de valores: Layer—The feature layer that will be used as the basis for calculating the length. Output Field Name—The length field's display name in the output.	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. Columnas de la tabla de valores: `Layer`—The feature layer that will be used as the summary layer. `Field`—The field that will be used to summarize the length. `Output Field Name`—The summary field's display name in the output.	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. Columnas de la tabla de valores: `Layer`—The feature layer that will be used as the basis for calculating the length. `Output Field Name`—The length field's display name in the output.	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

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

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 muestra cómo utilizar la función GenerateLRLengthSummary con datos de 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

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

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)
Avanzado: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)

Generar resumen de longitud referenciada lineal (Herramientas de Referenciación de ubicación)

Resumen

Uso

Parámetros

Nota:

Entornos

Información de licenciamiento

Temas relacionados