Generar producto de datos LRS (Herramientas de Referenciación de ubicación)

Resumen

Transforma los datos LRS para crear un producto de datos de longitud, registro de ruta o recuento de entidades para las rutas 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 geodatabase 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 la fecha especificada.
Para los productos de datos de longitud y de recuento de entidades, puede especificar más de un valor del parámetro Fecha efectiva. Cuando se especifican varias fechas de vigencia, se calculará la variación o el cambio en la longitud o en el recuento de entidades entre cada par de fechas de vigencia.
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 referenciación de ubicación para canalizaciones o carreteras y autopistas.
- Los campos de resumen y longitud deben existir en la misma geodatabase que la 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 ningún campo de resumen en el archivo .json.
- 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.
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 referenciación de ubicación para canalizaciones o carreteras y autopistas.
- La capa de registro y los campos deben existir en la misma geodatabase que la red LRS.
- La capa de ubicación y los campos deben ser una capa poligonal y existir en la misma geodatabase que la red LRS.
- La capa y los campos referentes deben ser una clase de entidad de evento de puntos LRS o una clase de entidad de intersección LRS, y se deben encontrar en la misma geodatabase que la red LRS.
- 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.
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 referenciación de ubicación para canalizaciones o carreteras y autopistas.
- Los campos de recuento, resumen e identificador de ruta deben existir en la misma geodatabase que la red LRS.
- Los parámetros Entidades de límite y Campo de resumen son válidos únicamente si no se proporciona ningún campo de resumen en el archivo .json.
- 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 recuento de entidades.

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 o fechas que se utilizarán 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. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades. 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.	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 rutas o el recuento de entidades.	File
Tabla de Salida (Opcional)	La tabla de geodatabase que se creará con la longitud calculada, el registro de rutas 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 [effective_date,...]	Fecha o fechas que se utilizarán 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. Este parámetro solo está disponible al crear un producto de datos de recuento de longitudes o entidades. `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.	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 rutas o el recuento de entidades.	File
out_table (Opcional)	La tabla de geodatabase que se creará con la longitud calculada, el registro de rutas 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.

# 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

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

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

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

Ejemplo 4 de GenerateLrsDataProduct (script independiente)

El siguiente script independiente muestra cómo utilizar la función GenerateLrsDataProduct con varias fechas efectivas.

# Name: GenerateLrsDataProduct_ex4.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

# Local tool variables
in_template = r"C:\Data\Template.json"
in_route_features = r"C:\Data\SampleData.gdb\LRS\Network"
effective_date = "12/31/2000; 12/31/2010; 12/31/2020"
units = "METERS"
boundary_features = None
summary_field = None
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\LP4"

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

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 producto de datos LRS (Herramientas de Referenciación de ubicación)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados