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 anteriores a esta herramienta para reducir el número de rutas y eventos que se procesarán.

  • No todos los tipos de tablas tienen un campo de Object ID. Cuando esta herramienta utiliza dichas tablas, la capa resultante no se podrá seleccionar y no se podrá utilizar eficazmente por ciertas operaciones de geoprocesamiento. Considere usar la herramienta Crear tabla de consultas antes de esta herramienta para agregar un campo ObjectID virtual.

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.

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

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
Nombre de capa o vista de tabla

La capa 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 utilizan 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.

  • Desactivada: no agregar un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.
  • Activada: 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 sólo es válido cuando el tipo de evento es POINT.

  • Desactivada: no agregar un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.
  • Activada: 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 ángulo
(Opcional)

Especifica si se calculará 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.

  • Desactivada: no escribir el complemento del ángulo. Escribir sólo el ángulo que se calculó. Esta es la opción predeterminada.
  • Activada: escribir el complemento del ángulo.
Boolean
Los eventos con un desplazamiento positivo se posicionarán a la derecha de las rutas
(Opcional)

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

  • Desactivada: los eventos con desplazamiento positivo se visualizarán a la izquierda de la ruta. Las mediciones, y no necesariamente la dirección digitalizada, determinan el lado de la ruta. Esta es la opción predeterminada.
  • Activada: los eventos con desplazamiento positivo se visualizarán a la derecha 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.

  • Desactivada: los eventos de punto se tratarán como entidades de punto. Esta es la opción predeterminada.
  • Activada: 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.

Field
in_table

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

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
out_layer

La capa 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 utilizan 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 agregar un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.
  • ERROR_FIELDAgregar 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 sólo es válido cuando el tipo de evento es POINT.

  • NO_ANGLE_FIELDNo agregar un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.
  • ANGLE_FIELDAgregar 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 calculará el complemento del ángulo de ubicación. Este parámetro solo es válido si add_angle_field = "ANGLE_FIELD".

  • ANGLENo escribir el complemento del ángulo. Escribir sólo el ángulo que se calculó. Esta es la opción predeterminada.
  • COMPLEMENTEscribir el complemento del ángulo.
Boolean
offset_direction
(Opcional)

Especifica el lado en el que se muestran 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 desplazamiento positivo se visualizarán a la izquierda de la ruta. Las mediciones, y no necesariamente la dirección digitalizada, determinan el lado de la ruta. Esta es la opción predeterminada.
  • RIGHTLos eventos con desplazamiento positivo se visualizarán a la derecha 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.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
Ejemplo 2 de MakeRouteEventLayer (script independiente)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función MakeRouteEventLayer en una secuencia de comandos 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" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
Ejemplo 3 de MakeRouteEventLayer (script independiente)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función MakeRouteEventLayer en una secuencia de comandos 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" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
Ejemplo 4 de MakeRouteEventLayer (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función MakeRouteEventLayer en un script 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" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

Información de licenciamiento

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

Temas relacionados