Crear capa de Eventos de rutas (Referenciación lineal)

Resumen

Crea una capa de entidades temporal usando rutas y eventos de rutas.

Al utilizar la capa temporal (visualizada en un mapa o utilizada por otra herramienta de geoprocesamiento), se realiza la segmentación dinámica.

Uso

  • La tabla de entrada puede ser cualquier tipo de tabla que ArcGIS admita.

  • Utilice la herramienta Crear capa de entidades en las rutas o la herramienta Crear vista de tabla en los eventos para reducir el número de rutas y eventos que se procesarán antes de ejecutar esta herramienta.

  • No todos los tipos de tablas tienen un campo de Id. de objeto. Cuando esta herramienta utiliza tablas sin campo de Id. de objeto, a capa resultante no se podrá seleccionar y no se podrá utilizar eficazmente por ciertas operaciones de geoprocesamiento. Puede utilizar la herramienta Crear tabla de consulta para agregar un campo de Id. de objeto virtual antes de ejecutar esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de ruta de entrada

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

Feature Layer
Campo Identificador de rutas

El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID.

Field
Tabla de eventos de entrada

La tabla cuyas filas se ubicarán a lo largo de las rutas.

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 la ruta. Sólo se debe especificar un campo de medición inicial.
    • Línea: 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 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
Nombre de capa o vista de tabla

La tabla que se creará. Esta capa se almacena en la memoria, por lo tanto no se necesita una ruta.

Feature Layer
Campo de desplazamiento
(Opcional)

El campo que contiene los valores que se utilizarán para desplazar los eventos de la ruta subyacente. Este campo debe ser numérico.

Field
Generar un campo para localizar errores
(Opcional)

Especifica si un campo denominado LOC_ERROR se agregará a la capa temporal creada.

  • Desactivado: no se agregará un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.
  • Activado: se agregará un campo para almacenar los errores de ubicación.
Boolean
Generar un campo de ángulo
(Opcional)

Especifica si un campo denominado LOC_ANGLE se agregará a la capa temporal creada. Este parámetro solo es válido cuando el tipo de evento es Punto.

  • Desactivado: no se agregará un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.
  • Activado: se agregará un campo para almacenar los ángulos de ubicación.
Boolean
Tipo de ángulo calculado
(Opcional)

Especifica el tipo de ángulo de ubicación que se calculará. Este parámetro solo es válido si la opción Generar un campo de ángulo está activada.

  • NormalSe calculará el ángulo normal (perpendicular). Esta es la opción predeterminada.
  • TangenteSe calculará el ángulo tangente.
String
Escribir el complemento del ángulo en el campo de ángulo
(Opcional)

Especifica si se escribirá el complemento del ángulo de ubicación. Este parámetro solo es válido si la opción Generar un campo de ángulo está activada.

  • Desactivado: no se escribirá el complemento del ángulo. Solo se escribirá el ángulo calculado. Esta es la opción predeterminada.
  • Activado: se escribirá el complemento del ángulo.
Boolean
Los eventos con un desplazamiento positivo se mostrarán en el lado derecho de las rutas.
(Opcional)

Especifica el lado en el que se mostrarán los eventos de ruta con un desplazamiento positivo. Este parámetro sólo es válido si se especificó un campo de desplazamiento.

  • Desactivado: los eventos con un desplazamiento positivo se muestran en el lado izquierdo de la ruta. El lado de la ruta se determina por las mediciones y no necesariamente por la dirección digitalizada. Esta es la opción predeterminada.
  • Activado: los eventos con un desplazamiento positivo se muestran en el lado derecho de la ruta. La dirección digitalizada determina el lado de la ruta.
Boolean
Se generarán eventos de puntos como entidades multipunto
(Opcional)

Especifica si los eventos de punto se tratarán como entidades de punto o entidades multipunto.

  • Desactivado: los eventos de punto se tratarán como entidades de punto. Esta es la opción predeterminada.
  • Activado: los eventos de punto se tratarán como entidades multipunto.
Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})
NombreExplicaciónTipo de datos
in_routes

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

Feature Layer
route_id_field

El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID.

Field
in_table

La tabla cuyas filas se ubicarán a lo largo de las rutas.

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.

  • Campo Identificador de rutas: 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.
  • Tipo de evento: el tipo de eventos en la tabla de eventos de superposición (POINT o LINE).
    • POINT: los eventos de punto se producen en una ubicación precisa de una ruta. Sólo se debe especificar un campo de medición inicial.
    • LINE: los eventos de línea definen una parte 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 POINT o LINE.
  • 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
out_layer

La tabla que se creará. Esta capa se almacena en la memoria, por lo tanto no se necesita una ruta.

Feature Layer
offset_field
(Opcional)

El campo que contiene los valores que se utilizarán para desplazar los eventos de la ruta subyacente. Este campo debe ser numérico.

Field
add_error_field
(Opcional)

Especifica si un campo denominado LOC_ERROR se agregará a la capa temporal creada.

  • NO_ERROR_FIELDNo se agregará un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.
  • ERROR_FIELDSe agregará un campo para almacenar los errores de ubicación.
Boolean
add_angle_field
(Opcional)

Especifica si un campo denominado LOC_ANGLE se agregará a la capa temporal creada. Este parámetro solo es válido cuando el tipo de evento es Punto.

  • NO_ANGLE_FIELDNo se agregará un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.
  • ANGLE_FIELDSe agregará un campo para almacenar los ángulos de ubicación.
Boolean
angle_type
(Opcional)

Especifica el tipo de ángulo de ubicación que se calculará. Este parámetro solo es válido si add_angle_field = "ANGLE_FIELD".

  • NORMALSe calculará el ángulo normal (perpendicular). Esta es la opción predeterminada.
  • TANGENTSe calculará el ángulo tangente.
String
complement_angle
(Opcional)

Especifica si se escribirá el complemento del ángulo de ubicación. Este parámetro solo es válido si add_angle_field = "ANGLE_FIELD".

  • ANGLENo se escribirá el complemento del ángulo. Solo se escribirá el ángulo calculado. Esta es la opción predeterminada.
  • COMPLEMENTSe escribirá el complemento del ángulo.
Boolean
offset_direction
(Opcional)

Especifica el lado en el que se mostrarán los eventos de ruta con un desplazamiento positivo. Este parámetro sólo es válido si se especificó un campo de desplazamiento.

  • LEFTLos eventos con un desplazamiento positivo se muestran en el lado izquierdo de la ruta. El lado de la ruta se determina por las mediciones y no necesariamente por la dirección digitalizada. Esta es la opción predeterminada.
  • RIGHTLos eventos con un desplazamiento positivo se muestran en el lado derecho de la ruta. La dirección digitalizada determina el lado de la ruta.
Boolean
point_event_type
(Opcional)

Especifica si los eventos de punto se tratarán como entidades de punto o entidades multipunto.

  • POINTLos eventos de punto se tratarán como entidades de punto. Esta es la opción predeterminada.
  • MULTIPOINTLos eventos de punto se tratarán como entidades multipunto.
Boolean

Muestra de código

Ejemplo 1 de MakeRouteEventLayer (ventana de Python)

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.MakeRouteEventLayer("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
Ejemplo 2 de MakeRouteEventLayer (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función MakeRouteEventLayer en un script independiente de Python.

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
Ejemplo 3 de MakeRouteEventLayer (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función MakeRouteEventLayer en un script independiente de Python.

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
Ejemplo 4 de MakeRouteEventLayer (script independiente)

La siguiente secuencia de comandos de Python se muestra cómo utilizar la función MakeRouteEventLayer en una secuencia de comandos de Python independiente utilizando datos de geodatabase corporativa.

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr)

Información de licenciamiento

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

Temas relacionados