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, o ambos.

  • 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 un valor de parámetro de Tolerancia clúster grande para superar las discrepancias entre las rutas de origen y de destino, se pueden producir resultados inesperados.

  • El valor Tipo de evento (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.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de eventos de entrada

La tabla de eventos de entrada.

Table View
Propiedades de tabla de eventos

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: el campo que contiene 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 entrada (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
Entidades de rutas de origen

Las entidades de ruta de entrada.

Feature Layer
Campo de identificador de rutas de origen

El campo que contiene los valores que identifican de manera única cada ruta de entrada.

Field
Entidades de rutas de destino

Las entidades de ruta en las que se transformarán los eventos de entrada.

Feature Layer
Campo Identificador de rutas de destino

El campo que contiene los valores que identifican de manera única cada ruta de destino.

Field
Tabla de eventos de salida

La tabla que se creará.

Table
Propiedades de la Tabla de eventos de salida

Parámetro que consiste en los campos de ubicación de ruta y el tipo de eventos que se escribirán en la tabla de eventos de salida.

  • Campo Identificador de rutas: el campo que contendrá 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. Solo se debe especificar un único 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á 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á valores de medición. Se requiere cuando el tipo de evento es LINE.
Route Measure Event Properties
Tolerancia clúster

La distancia máxima tolerada entre los eventos de entrada y las rutas de destino.

Linear Unit
Incluir todos los campos de la entrada
(Opcional)

Especifica si el valor del parámetro Tabla de eventos de salida contendrá los campos de ubicación de ruta más todos los atributos de los eventos de entrada.

  • Activado: el valor del parámetro 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.
  • Desactivado: el valor del parámetro Tabla de eventos de salida solo contendrá los campos de ubicación de ruta más el campo ObjectID de los eventos de entrada.
Boolean

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})
NombreExplicaciónTipo 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: el campo que contiene 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 entrada (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án en la tabla de eventos de salida.

  • Campo Identificador de rutas: el campo que contendrá 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. Solo se debe especificar un único 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á 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á 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 el valor del parámetro out_table contendrá los campos de ubicación de ruta más todos los atributos de los eventos de entrada.

  • FIELDSEl valor del parámetro out_table 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_FIELDSEl valor del parámetro out_table contendrá solo los campos de ubicación de ruta más el campo ObjectID de los eventos de entrada.
Boolean

Muestra de código

Ejemplo 1 de TransformRouteEvents (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función TransformRouteEvents.

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 una secuencia de comandos 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 una secuencia de comandos 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)

Información de licenciamiento

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

Temas relacionados