Modificar evento LRS (Location Referencing)

Resumen

Modifica las propiedades de un evento del sistema de referenciación lineal (LRS).

Uso

• Los campos modificados deberían tener 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.

• Esta herramienta se puede utilizar para agregar o quitar las siguientes propiedades de un evento:

  Evento actual para una red continua

  Tipo de evento	Admite nombre de ruta	Admite abarcar varias rutas
  Línea	No	N/A
  Línea	Sí	N/A
  Punto	No	N/A
  Punto	Sí	N/A

  Evento modificado para una red continua

  Tipo de evento	Admite nombre de ruta	Admite abarcar varias rutas
  Línea	Sí	N/A
  Línea	No	N/A
  Punto	Sí	N/A
  Punto	No	N/A

  Evento actual para una red de ingeniería

  Tipo de evento	Admite nombre de ruta	Admite abarcar varias rutas
  Línea	No	No
  Línea	Sí	No
  Línea	Sí	No
  Línea	Sí	Sí
  Punto	No	N/A
  Punto	Sí	N/A

  Evento modificado para una red de ingeniería

  Tipo de evento	Admite nombre de ruta	Admite abarcar varias rutas
  Línea	Sí	No
  Línea	No	No
  Línea	Sí	Sí
  Línea	Sí	No
  Punto	Sí	N/A
  Punto	No	N/A

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad de evento LRS	Clase de entidad de entrada o capa de entidades del evento.	Feature Layer
Campo de Id. de evento	Nombre del campo Id. de evento.	Field
Campo Id. de ruta	Nombre del campo Id. de ruta.	Field
Campo de fecha inicial	Nombre del campo de fecha inicial	Field
Campo de fecha final	Nombre del campo de fecha final	Field
Campo de error de ubicación	Nombre del campo de error de ubicación.	Field
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.	Field
Campo de medición final (Opcional)	Nombre del campo de medición final. Solo es necesario para los eventos de línea.	Field
El evento abarca varias rutas (Opcional)	Tal cual—Sin cambios en la propiedad. Esta es la opción predeterminada. No abarcar rutas—Los registros de eventos no abarcan rutas. Solo es aplicable a los eventos de línea. Abarcar rutas—Los registros de eventos pueden abarcar rutas. Solo es aplicable a los eventos de línea.	String
Campo de Id. de ruta final (Opcional)	Nombre del campo Id. de ruta final. Solo es necesario si es un evento de línea y abarca rutas.	Field
Almacenar nombre de ruta (Opcional)	Tal cual—Sin cambios en la propiedad. Esta es la opción predeterminada. No almacenar nombre de ruta—No almacena el nombre de ruta con los registros de eventos. Almacenar nombre de ruta—Almacena el nombre de la ruta con los registros de eventos.	String
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á habilitado.	Field
Campo de nombre de ruta final (Opcional)	Nombre del campo de nombre de ruta final. Es obligatorio si es un evento de línea, se elige Almacenar nombre de ruta y abarca rutas.	Field

Salida derivada

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

Python

arcpy.locref.ModifyLRSEvent(in_feature_class, 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
in_feature_class	Clase de entidad de entrada o capa de entidades del evento.	Feature Layer
event_id_field	Nombre del campo Id. de evento.	Field
route_id_field	Nombre del campo Id. de ruta.	Field
from_date_field	Nombre del campo de fecha inicial	Field
to_date_field	Nombre del campo de fecha final	Field
loc_error_field	Nombre del campo de error de ubicación.	Field
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.	Field
to_measure_field (Opcional)	Nombre del campo de medición final. Solo es necesario para los eventos de línea.	Field
event_spans_routes (Opcional)	Determina si los registros de eventos van a abarcar rutas. AS_IS—Sin cambios en la propiedad. Esta es la opción predeterminada. NO_SPANS_ROUTES—Los registros de eventos no abarcan rutas. Solo es aplicable a los eventos de línea. SPANS_ROUTES—Los registros de eventos pueden abarcar rutas. Solo es aplicable a los eventos de línea.	String
to_route_id_field (Opcional)	Nombre del campo Id. de ruta final. Solo es necesario si es un evento de línea y abarca rutas.	Field
store_route_name (Opcional)	Determina si los registros de eventos almacenarán el nombre de la ruta. AS_IS—Sin cambios en la propiedad. Esta es la opción predeterminada. 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.	String
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.	Field
to_route_name_field (Opcional)	Nombre del campo de nombre de ruta final. Es obligatorio si se trata de un evento de línea y se han establecido store_route_name y SPANS_ROUTES.	Field

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 ModifyLRSEvent (ventana de Python)

El siguiente script muestra cómo utilizar la herramienta ModifyLRSEvent en una ventana de Python para que los eventos abarquen rutas.

# Name: Modify_LRS_Event_ex1.py
# Description: Modify an event registered to a network so that it spans routes.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = "c:/data.gdb/LRS/Event1"
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.ModifyLRSEvent(in_feature_class, 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 ModifyLRSEvent (script independiente)

En el siguiente script se muestra cómo utilizar la herramienta ModifyLRSEvent en un script independiente de Python para que los eventos abarquen rutas.

# Name: Modify_LRS_Event_ex2.py
# Description: Modify an event registered to a network so that it spans routes.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables:
in_feature_class = r"C:/data.gdb/LRS/Event1"
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:  Modify LRS Event From Existing Dataset
arcpy.locref.ModifyLRSEvent(in_feature_class, 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 (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)