Transformar Eventos de rutas (Herramientas de 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 del parámetro Tolerancia clúster grande para superar las discrepancias entre las rutas de origen y de destino, se pueden producir resultados inesperados.
El valor de 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 eventos que se procesarán.
La tabla de salida se puede visualizar en un mapa utilizando la herramienta Crear capa de eventos de ruta.

Etiqueta	Explicación	Tipo de datos
Tabla de eventos de entrada	La tabla de eventos de entrada.	Table View
Propiedades de tabla de eventos	Los campos de ubicación de ruta y el tipo de eventos de la tabla de eventos de superposición. Campo Identificador de rutas: el campo que contiene valores que indican la ruta en la que se encuentra cada evento. Este campo puede ser un campo numérico, de texto o GUID. Tipo de evento: el tipo de eventos de la tabla de eventos de entrada (Punto o Línea). Punto: los eventos de punto ocurren en una ubicación precisa a lo largo de una ruta. Sólo se debe especificar un campo de medición inicial. Línea: los eventos de línea definen una porción de una 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 Punto o Línea. Cuando el valor de Tipo de evento es Punto, la etiqueta para este parámetro pasa a ser 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 Línea.	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. El campo puede ser un campo numérico, de texto o GUID.	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. El campo puede ser un campo numérico, de texto o GUID.	Field
Tabla de eventos de salida	La tabla que se creará.	Table
Propiedades de la Tabla de eventos de salida	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. El campo puede ser un campo numérico, de texto o GUID. Tipo de evento: el tipo de eventos que contendrá la tabla de eventos de salida (Punto o Línea). Punto: los eventos de punto ocurren en una ubicación precisa a lo largo de una ruta. Solo se debe especificar un único campo de medición. Línea: los eventos de línea definen una porción de una 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. Este campo es obligatorio cuando el tipo de evento es Punto o Línea. Cuando el valor de Tipo de evento es Punto, la etiqueta para este parámetro pasa a ser Campo de medición. Campo de medición final: un campo que contendrá valores de medición. Este campo es obligatorio cuando el tipo de evento es Línea.	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})

Nombre	Explicación	Tipo de datos
in_table	La tabla de eventos de entrada.	Table View
in_event_properties	Los campos de ubicación de ruta y el tipo de eventos de la tabla de eventos de superposición. Route identifier field—El campo que contiene los valores que indican la ruta en la que se encuentra cada evento. Este campo puede ser un campo numérico, de texto o GUID. Event type—El tipo de eventos de la tabla de eventos de entrada (`POINT` o `LINE`). `POINT`—Los eventos de punto ocurren en una ubicación precisa a lo largo de una ruta. Sólo se debe especificar un campo de medición inicial. `LINE`—Los eventos de línea definen una porción de una ruta. Deben especificarse tanto los campos de medición inicial como los de medición final. From-measure field—Un campo que contiene los valores de medición. Este campo debe ser numérico y se requiere cuando el tipo de evento es `POINT` o `LINE`. To-measure field—Un campo que contiene los 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. El campo puede ser un campo numérico, de texto o GUID.	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. El campo puede ser un campo numérico, de texto o GUID.	Field
out_table	La tabla que se creará.	Table
out_event_properties	Los campos de ubicación de ruta y el tipo de eventos que se escribirán en la tabla de eventos de salida. Route identifier field—Campo que contendrá los valores que indican la ruta en la que se encuentra cada evento. El campo puede ser un campo numérico, de texto o GUID. Event type—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 una ruta. Solo se debe especificar un único campo de medición. `LINE`—Los eventos de línea definen una porción de una ruta. Deben especificarse tanto los campos de medición inicial como los de medición final. From-measure field—Un campo que contendrá valores de medición. Este campo es obligatorio si el tipo de evento es `POINT` o `LINE`. To-measure field—Un campo que contendrá valores de medición. Este campo es obligatorio si 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. `FIELDS`—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. Esta es la opción predeterminada. `NO_FIELDS`—El 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.lr.TransformRouteEvents("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"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(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 independiente de Python utilizando datos de geodatabases corporativas:

# 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"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(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í
Avanzado: Sí

Transformar Eventos de rutas (Herramientas de referenciación lineal)

Resumen

Uso

Precaución:

Parámetros

Entornos

Información de licenciamiento

Temas relacionados