Generar recuento de entidades referenciado lineal (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Crea un producto de datos de recuento de entidades para 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.

  • 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 recuento de entidades.

  • La capa de recuento de entidades debe ser una clase de entidad de evento de punto LRS, una clase de entidad de evento de línea LRS o una clase de entidad de intersección LRS registrada en la red LRS especificada.

  • Se incluirá un valor sin clasificar en los campos de recuento de entidades de salida para las rutas que no se superponen con las capas de recuento de entidades.

  • Las capas de resumen y recuento de entidades deben almacenarse en la misma base de datos geográficos o servicio de entidades y tener el mismo sistema de coordenadas que la red LRS especificada.

  • Puede agregar varias capas de recuento de entidades de la misma clase de entidad creando capas de selección y especificando cada capa de selección como una capa de recuento de entidades. Por ejemplo, si tiene una clase de entidad de eventos de puntos LRS, puede crear dos capas de selección (Clase A y Clase B) y especificar cada capa de selección como una capa de recuento de entidades.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de ruta de entrada

Las entidades de la ruta que se utilizarán para crear el producto de datos del recuento de entidades.

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
Campos de resumen
(Opcional)

Los campos 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 resumir el recuento de entidades.
  • Nombre del campo de salida: el nombre del campo de resumen que se visualiza en la salida.

Value Table
Capas de recuento de entidades
(Opcional)

Las capas que se utilizarán para localizar el número de elementos a lo largo de una ruta.

  • Capa: la capa de entidades que se utilizará como capa de recuento de entidades.
  • Nombre del campo de salida: el nombre de visualización de la capa de recuento de entidades 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 que solo tienen recuentos de entidades cero (filas de resumen nulas) se excluirán de la salida. Esta es la opción predeterminada.
  • Desactivado: las filas que solo tienen recuentos de entidades cero (filas de resumen nulas) no se excluirán de la salida.
Boolean
Formato de salida
(Opcional)

Especifica el formato de la salida.

  • CSVLa salida será un archivo .csv. Esta es la opción predeterminada.
  • TablaLa salida será una tabla de geodatabase.
String
Archivo de salida
(Opcional)

El archivo de salida .csv que contendrá el producto de datos del recuento de entidades.

File
Tabla de Salida
(Opcional)

La tabla de la geodatabase de salida que contendrá el producto de datos del recuento de entidades.

Table

arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, {summary_fields}, {feature_count_layers}, {exclude_null_summary_rows}, {output_format}, {out_file}, {out_table})
NombreExplicaciónTipo de datos
in_route_features

Las entidades de la ruta que se utilizarán para crear el producto de datos del recuento de entidades.

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
summary_fields
[summary_fields,...]
(Opcional)

Los campos 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 resumir el recuento de entidades.
  • Nombre del campo de salida: el nombre del campo de resumen que se visualiza en la salida.

Value Table
feature_count_layers
[feature_count_layers,...]
(Opcional)

Las capas que se utilizarán para localizar el número de elementos a lo largo de una ruta.

  • Capa: la capa de entidades que se utilizará como capa de recuento de entidades.
  • Nombre del campo de salida: el nombre de visualización de la capa de recuento de entidades en la salida.

Value Table
exclude_null_summary_rows
(Opcional)

Especifica si las filas de resumen nulas se excluirán de la salida.

  • EXCLUDELas filas que solo tienen recuentos de entidades cero (filas de resumen nulas) se excluirán de la salida. Esta es la opción predeterminada.
  • DO_NOT_EXCLUDELas filas que solo tienen recuentos de entidades cero (filas de resumen nulas) no se excluirán de la salida.
Boolean
output_format
(Opcional)

Especifica el formato de la salida.

  • CSVLa salida será un archivo .csv. Esta es la opción predeterminada.
  • TABLELa salida será una tabla de geodatabase.
String
out_file
(Opcional)

El archivo de salida .csv que contendrá el producto de datos del recuento de entidades.

File
out_table
(Opcional)

La tabla de la geodatabase de salida que contendrá el producto de datos del recuento de entidades.

Table

Muestra de código

Ejemplo 1 de GenerateLRFeatureCount (script independiente)

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

# Name: GenerateLRFeatureCount_ex1.py 
# Description: Create a feature count data product that provides the number of active anomalies, pipeline crossings, and DOT Class line events per route
# 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" 

# Using the Anomaly point event feature class, create a feature layer that contains active anomalies, to be used as a feature count layer
arcpy.management.MakeFeatureLayer("Anomaly", "Anomaly_Active", "anomalystatus = 'Active'")

# Using the DOT Class line event feature class, create 3 feature layers, each representing a class type, to be used as feature count layers
arcpy.management.MakeFeatureLayer("DOTClass", "Class_A", "classtype = 1") 
arcpy.management.MakeFeatureLayer("DOTClass", "Class_B", "classtype = 2")   
arcpy.management.MakeFeatureLayer("DOTClass", "Class_C", "classtype = 3")

# Set tool variables 
in_route_features = "EngineeringNetwork" 
effective_date = "12/31/2024" 
summary_fields = "Counties NAME Counties"
feature_count_layers = "Anomaly_Active 'Anomaly'; PipeCrossing 'Pipe Crossings'; Class_A 'Class A'; Class_B 'Class B'; Class_C 'Class C'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE" 
out_file = None
out_table = r"C:\Data\SampleData.gdb\FC1" 

# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers, exclude_null_summary_rows, output_format, out_file, out_table) 

# Check in licenses 
arcpy.CheckInExtension("LocationReferencing")
Ejemplio 2 de GenerateLRFeatureCount (ventana de Python)

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

# Name: GenerateLRFeatureCount_ex2.py 
# Description: Create a feature count data product that provides the number of bridges and intersections per route
# Requirements: ArcGIS Location Referencing  

# Set tool variables 
in_route_features = "CountyLog" 
effective_date = "12/31/2024" 
summary_fields = "Counties NAME Counties"
feature_count_layers = "Bridge_Point 'Bridges'; Intersections 'Intersections'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "TABLE" 
out_file = None 
out_table = r"C:\Data\SampleData.gdb\FC2"
 
# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers,
                                    exclude_null_summary_rows, output_format, out_file, out_table)
Ejemplo 3 de GenerateLRFeatureCount (script independiente)

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

# Name: GenerateLRFeatureCount_ex3.py 
# Description: Create a feature count data product that provides the number of active anomalies, pipeline casing material types, and crossing utility intersections per route
# Requirements: 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, 49 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/49"

# Create a feature layer from the Cities layer of the feature service to be used as the summary layer. Here, 21 corresponds to the Cities layer's layer ID
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/21", "Cities")

# Create the feature layers from the feature service. The feature layers will be used as feature count layers
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18", "Anomaly_Active", "anomalystatus = 'Active'")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_CastIron", "MATERIAL = 2")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_Copper", "MATERIAL = 4")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/54", "Casing_Composite", "MATERIAL = 10")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/61", "Crossing_Utility_Intersection")

# Set tool variables 
effective_date = "12/31/2024" 
summary_fields = "Cities NAME Cities"
feature_count_layers = "Anomaly_Active 'Anomalies'; Casing_CastIron 'Cast Iron Casing'; Casing_Copper 'Copper Casing'; Casing_Composite 'Composite Casing'; Crossing_Utility_Intersection 'Crossing Utility Intersections'"
exclude_null_summary_rows = "EXCLUDE"
output_format = "CSV" 
out_file = r"C:\Data\FC3.csv"
out_table = None

# Run the tool 
arcpy.locref.GenerateLRFeatureCount(in_route_features, effective_date, summary_fields, feature_count_layers,
                                    exclude_null_summary_rows, output_format, out_file, out_table)
 
# Check in the license 
arcpy.CheckInExtension("LocationReferencing")

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