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.
Las capas temporales se almacenan en la memoria y se pueden utilizar como entradas para otras funciones de geoprocesamiento en la sesión de ArcCatalog o ArcMap actual.
En ArcMap, las capas de entidades temporales pueden visualizarse si ha indicado que desea agregar los resultados de operaciones de geoprocesamiento a la visualización en Geoprocesamiento > Opciones de geoprocesamiento... > Agregar los resultados de las operaciones de geoprocesamiento a la visualización.
Una vez que sale de ArcCatalog o ArcMap, las capas de entidades temporales se quitan de la memoria. Para que una capa temporal permanezca en el disco, utilice las herramientas Guardar en archivo de capa o Copiar entidades.
Sintaxis
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})
Parámetro | 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. | 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.
| 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.
| 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.
| 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".
| 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".
| 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.
| Boolean |
point_event_type (Opcional) | Especifica si los eventos de punto se tratarán como entidades de punto o 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)
Ejemplo 5 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 personal.
# Name: MakeRouteEventLayer_Example5.py
# Description: Make a LINE event layer. Routes and events are in a personal 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.mdb"
# 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")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí