Transformar Eventos de rutas (Referenciación lineal)

Resumen

Transforma las mediciones de los eventos desde una referencia de ruta a otra y los escribe en una nueva tabla de eventos.

Uso

• Transformar los eventos le permite utilizar los eventos de una referencia de ruta con otra referencia de ruta que tenga identificadores o mediciones de ruta diferentes.

• Cualquier evento total o parcial que se interseca con una ruta de destino se escribe en la nueva tabla de eventos.

• Para obtener los mejores resultados, las rutas de origen y las rutas de destino deben superponerse.

  Precaución:

  Si utiliza una tolerancia cluster grande para superar las discrepancias entre las rutas de origen y de destino, se pueden producir resultados inesperados.

• El tipo de evento de salida (Punto o Línea) debe coincidir con el tipo de evento de entrada.

• Utilice la herramienta Crear vista de tabla antes de esta herramienta para reducir eficazmente el número de rutas y eventos que se procesarán.

• La tabla de salida se puede visualizar en un mapa utilizando la herramienta Crear capa de eventos de ruta.

Sintaxis

arcpy.lr.TransformRouteEvents(in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})

Parámetro	Explicación	Tipo de datos
in_table	La tabla de eventos de entrada.	Table View
in_event_properties	Parámetro que consiste en los campos de ubicación de ruta y el tipo de eventos en la tabla de eventos de entrada. Campo Identificador de rutas: campo que contiene los valores que indican la ruta en la que se encuentra cada evento. Este campo puede ser numérico o de carácter. Tipo de evento: el tipo de eventos en la tabla de eventos de salida (POINT o LINE). POINT: los eventos de punto ocurren en una ubicación precisa a lo largo de la ruta. Sólo se debe especificar un campo de medición inicial. LINE: los eventos de línea definen una porción de la ruta. Deben especificarse tanto los campos de medición inicial como los de medición final. Campo de medición inicial: un campo que contiene valores de medición. Este campo debe ser numérico y se requiere cuando el tipo de evento es POINT o LINE. Tenga en cuenta que cuando el Tipo de evento es POINT, la etiqueta para este parámetro se convierte en Campo de medición. Campo de medición final: un campo que contiene valores de medición. Este campo debe ser numérico y se requiere cuando el tipo de evento es LINE.	Route Measure Event Properties
in_routes	Las entidades de ruta de entrada.	Feature Layer
route_id_field	El campo que contiene los valores que identifican de manera única cada ruta de entrada.	Field
target_routes	Las entidades de ruta en las que se transformarán los eventos de entrada.	Feature Layer
target_route_id_field	El campo que contiene los valores que identifican de manera única cada ruta de destino.	Field
out_table	La tabla que se creará.	Table
out_event_properties	Parámetro que consiste en los campos de ubicación de ruta y el tipo de eventos que se escribirá en la tabla de eventos de salida. Campo Identificador de rutas: campo que contendrá los valores que indican la ruta en la que se encuentra cada evento. Tipo de evento: el tipo de eventos que contendrá la tabla de eventos de salida (POINT o LINE). POINT: los eventos de punto ocurren en una ubicación precisa a lo largo de la ruta. Sólo se debe especificar un solo campo de medición. LINE: los eventos de línea definen una porción de la ruta. Deben especificarse tanto los campos de medición inicial como los de medición final. Campo de medición inicial: un campo que contendrá los valores de medición. Se requiere cuando el tipo de evento es POINT o LINE. Tenga en cuenta que cuando el Tipo de evento es POINT, la etiqueta para este parámetro se convierte en Campo de medición. Campo de medición final: un campo que contendrá los valores de medición. Se requiere cuando el tipo de evento es LINE.	Route Measure Event Properties
cluster_tolerance	La distancia máxima tolerada entre los eventos de entrada y las rutas de destino.	Linear Unit
in_fields (Opcional)	Especifica si la tabla de eventos de salida contendrá los campos de ubicación de ruta más todos los atributos de los eventos de entrada. FIELDS —La tabla de eventos de salida contendrá los campos de ubicación de ruta más todos los atributos de los eventos de entrada. Esta es la opción predeterminada. NO_FIELDS —La tabla de eventos de salida sólo contendrá los campos de ubicación de ruta más el campo Object ID de los eventos de entrada.	Boolean

Muestra de código

Ejemplo 1 de TransformRouteEvents (ventana de Python)

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.TransformRouteEvents_lr("pavement.dbf", "route1 LINE begin_mp end_mp", 
                              "hwy.shp", "route1", "hwy_new.shp", "route1", 
                              "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters")

Ejemplo 2 de TransformRouteEvents (script independiente)

A continuación se muestra cómo utilizar la función TransformRouteEvents en un script independiente de Python utilizando datos de geodatabase de archivos.

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
in_tbl = "accident"
in_props = "route1 POINT measure"
in_rt = "roads/hwy"               # hwy exists in the roads feature dataset 
in_rid = "route1" 
target_rt = "roads/hwy_new"       # hwy_new exists in the roads feature dataset 
target_rid = "route1" 
out_tbl = "trans_out2"
out_props = "route1 POINT mp"
tol = "0.1 meters"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

Ejemplo 3 de TransformRouteEvents (script independiente)

A continuación se muestra cómo utilizar la función TransformRouteEvents en un script de Python independiente utilizando datos de geodatabase corporativa.

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = arcpy.ValidateTableName("hwy_new", wkspc) 
target_rid = "route1" 
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

Entornos

Espacio de trabajo actual, Palabra clave CONFIG de salida, Espacio de trabajo temporal

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí