Crear evento LRS (Location Referencing)

Resumen

Crea eventos de línea o punto para una red LRS existente.

Uso

• La salida de la herramienta es una clase de entidad.

• Las redes derivadas no se pueden utilizar como redes principales.

• Los campos de clase de entidad de evento tienen las propiedades descritas en el modelo de datos de eventos ArcGIS Pipeline Referencing y en el modelo de datos de eventos ArcGIS Roads and Highways .

• Las siguientes reglas de comportamiento de evento se establecen de forma predeterminada:

  Actividad	Reglas
  Calibrar ruta	Permanencia
  Retirar ruta	Permanencia
  Extender ruta	Permanencia
  Reasignar ruta	Permanencia
  Realinear ruta	Permanencia
  Realinear cartográficamente ruta	Respetar medición de ruta

• Al utilizar una geodatabase corporativa como entrada de esta herramienta, el usuario actual de la base de datos no puede ser SDE ni DBO.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red LRS principal	Red en la que se registra el evento.	Feature Layer
Nombre de evento	Evento que se va a registrar.	String
Tipo de geometría (Opcional)	Tipo de geometría del evento de salida. Punto—El tipo de geometría del evento es Punto. Esta es la opción predeterminada. Línea—El tipo de geometría del evento es Polilínea.	String
Campo de Id. de evento	Campo de Id. de evento disponible en la clase de entidad de evento.	String
Campo Id. de ruta	Nombre del campo Id. de ruta si es un evento de punto que no abarca rutas o del campo Id. de ruta inicial si el evento abarca rutas. El campo está disponible en la clase de entidad de evento.	String
Campo de fecha inicial	Campo de fecha inicial disponible en la clase de entidad de evento.	String
Campo de fecha final	Campo de fecha final disponible en la clase de entidad de evento.	String
Campo de error de ubicación	Campo de error de ubicación disponible en la clase de entidad de evento.	String
Campo de medición	Nombre del campo de medición si es un evento de punto o del campo de medición inicial si es un evento de línea.	String
Campo de medición final (Opcional)	Nombre del campo de medición final. Solo es necesario para los eventos de línea.	String
El evento abarca varias rutas (Opcional)	Especifica si los registros de eventos abarcan rutas. Activado: los registros de evento abarcan rutas. Desactivado: los registros de eventos no abarcan rutas. Esta es la opción predeterminada.	Boolean
Campo de Id. de ruta final (Opcional)	Nombre del campo Id. de ruta final. Solo es necesario si el tipo de geometría es una línea y la casilla de verificación Rutas de intervalos de eventos está activada.	String
Almacenar nombre de ruta (Opcional)	Especifica si el nombre de ruta se debe almacenar con los registros de eventos. Activado: el nombre de ruta se almacena con los registros de eventos. Desactivado: el nombre de ruta no se almacena con los registros de eventos. Esta es la opción predeterminada.	Boolean
Campo de nombre de ruta (Opcional)	Campo Nombre de ruta si es un evento de punto que no abarca rutas o campo Nombre de ruta inicial si se trata de un evento de línea que abarca rutas. Es obligatorio si Almacenar nombre de ruta está activado.	String
Campo de nombre de ruta final (Opcional)	Campo nombre de ruta final para los eventos de línea que abarcan rutas. Es obligatorio si Almacenar nombre de ruta está activado.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de evento de salida	Capa de entidades de evento actualizada.	Feature Layer

Python

arcpy.locref.CreateLRSEvent(parent_network, event_name, {geometry_type}, event_id_field, route_id_field, from_date_field, to_date_field, loc_error_field, measure_field, {to_measure_field}, {event_spans_routes}, {to_route_id_field}, {store_route_name}, {route_name_field}, {to_route_name_field})

Nombre	Explicación	Tipo de datos
parent_network	Red en la que se registra el evento.	Feature Layer
event_name	Evento que se va a registrar.	String
geometry_type (Opcional)	Tipo de geometría del evento de salida. POINT—El tipo de geometría del evento es Punto. Esta es la opción predeterminada. LINE—El tipo de geometría del evento es Polilínea.	String
event_id_field	Campo de Id. de evento disponible en la clase de entidad de evento.	String
route_id_field	Nombre del campo Id. de ruta si es un evento de punto que no abarca rutas o del campo Id. de ruta inicial si el parámetro event_spans_routes está establecido en SPANS_ROUTES.	String
from_date_field	Campo de fecha inicial disponible en la clase de entidad de evento.	String
to_date_field	Campo de fecha final disponible en la clase de entidad de evento.	String
loc_error_field	Campo de error de ubicación disponible en la clase de entidad de evento.	String
measure_field	Nombre del campo de medición si es un evento de punto o del campo de medición inicial si es un evento de línea.	String
to_measure_field (Opcional)	Nombre del campo de medición final. Solo es necesario para los eventos de línea.	String
event_spans_routes (Opcional)	Especifica si los registros de eventos abarcan rutas. SPANS_ROUTES—Los registros de eventos abarcan rutas. NO_SPANS_ROUTES—Los registros de eventos no abarcan rutas. Esta es la opción predeterminada.	Boolean
to_route_id_field (Opcional)	Nombre del campo Id. de ruta final. Solo es necesario si el parámetro geometry_type está establecido en LINE y el parámetro event_span_routes se ha definido como .SPANS_ROUTES	String
store_route_name (Opcional)	Especifica si el nombre de ruta se debe almacenar con los registros de eventos. STORE_ROUTE_NAME—Almacena el nombre de la ruta con los registros de eventos. NO_STORE_ROUTE_NAME—No almacena el nombre de ruta con los registros de eventos. Esta es la opción predeterminada.	Boolean
route_name_field (Opcional)	Campo Nombre de ruta si es un evento de punto que no abarca rutas o campo Nombre de ruta inicial si se trata de un evento de línea que abarca rutas. Es obligatorio si se ha configurado STORE_ROUTE_NAME.	String
to_route_name_field (Opcional)	Campo nombre de ruta final para los eventos de línea que abarcan rutas. Es obligatorio si se ha configurado STORE_ROUTE_NAME.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Capa de entidades de evento actualizada.	Feature Layer

Muestra de código

Ejemplo 1 de CreateLRSEvent (ventana de Python)

En el siguiente script se muestra cómo usar la herramienta CreateLRSEvent en la ventana de Python.

# Name: Create_LRS_Event_ex1.py
# Description: Create a new LRS Event registered to an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
parent_network = r"C:/data.gdb/LRS/Network"
event_name = "Event1"
geometry_type = "LINE"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"

# set current workspace
arcpy.env.workspace = "C:/data.gdb"

# execute the tool
arcpy.locref.CreateLRSEvent(parent_network, event_name, geometry_type, event_id_field, route_id_field, from_date_field,
                            to_date_field, loc_error_field, measure_field, to_measure_field, event_spans_routes,
                            to_route_id_field, store_route_name, route_name_field, to_route_name_field)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Ejemplo 2 de CreateLRSEvent (script independiente)

En el siguiente script se muestra cómo usar la herramienta CreateLRSEvent en un script independiente de Python.

# Name: Create_LRS_Event_ex2.py
# Description: Create a new LRS Event registered to an LRS Network in this stand-alone script.
# Requires: ArcGIS Location Referencing 

# Import arcpy module
import arcpy 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables 
parent_network = r"C:/data.gdb/LRS/Network"
event_name = "Event1"
geometry_type = "LINE"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"

# Process:  Create LRS Event From Existing Dataset
arcpy.locref.CreateLRSEvent(parent_network, event_name, geometry_type, event_id_field, route_id_field, from_date_field,
                            to_date_field, loc_error_field, measure_field, to_measure_field, event_spans_routes,
                            to_route_id_field, store_route_name, route_name_field, to_route_name_field)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing
• Standard: Requiere ArcGIS Location Referencing
• Advanced: Requiere ArcGIS Location Referencing