Crear capa de Eventos de rutas (Herramientas de 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.

Etiqueta	Explicación	Tipo 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 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
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. Activado—Se agregará un campo para almacenar los errores de ubicación. Desactivado—No se agregará un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.	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. Activado—Se agregará un campo para almacenar los ángulos de ubicación. Desactivado—No se agregará un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.	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 el parámetro Generar un campo de ángulo está activado. Normal—Se calculará el ángulo normal (perpendicular). Esta es la opción predeterminada. Tangente—Se 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 el parámetro Generar un campo de ángulo está activado. Activado—Se escribirá el complemento del ángulo. Desactivado—No se escribirá el complemento del ángulo. Solo se escribirá el ángulo calculado. Esta es la opción predeterminada.	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. 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. 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.	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. Activado—Los eventos de punto se tratarán como entidades multipunto. Desactivado—Los eventos de punto se tratarán como entidades de punto. Esta es la opción predeterminada.	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})

Nombre	Explicación	Tipo 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. 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
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. `ERROR_FIELD`—Se agregará un campo para almacenar los errores de ubicación. `NO_ERROR_FIELD`—No se agregará un campo para almacenar los errores de ubicación. Esta es la opción predeterminada.	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. `ANGLE_FIELD`—Se agregará un campo para almacenar los ángulos de ubicación. `NO_ANGLE_FIELD`—No se agregará un campo para almacenar los ángulos de ubicación. Esta es la opción predeterminada.	Boolean
angle_type (Opcional)	Especifica el tipo de ángulo de ubicación que se calculará. Este parámetro solo es válido cuando el parámetro `add_angle_field` se establece en `ANGLE_FIELD`. `NORMAL`—Se calculará el ángulo normal (perpendicular). Esta es la opción predeterminada. `TANGENT`—Se 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 cuando el parámetro `add_angle_field` se establece en `ANGLE_FIELD`. `COMPLEMENT`—Se escribirá el complemento del ángulo. `ANGLE`—No se escribirá el complemento del ángulo. Solo se escribirá el ángulo calculado. Esta es la opción predeterminada.	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. `RIGHT`—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. `LEFT`—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.	Boolean
point_event_type (Opcional)	Especifica si los eventos de punto se tratarán como entidades de punto o entidades multipunto. `MULTIPOINT`—Los eventos de punto se tratarán como entidades multipunto. `POINT`—Los eventos de punto se tratarán como entidades de punto. Esta es la opción predeterminada.	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)

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

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

Entornos

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

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Crear capa de Eventos de rutas (Herramientas de referenciación lineal)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados