Resumen
Superpone dos tablas de eventos para crear una tabla de eventos de salida que representa la combinación o intersección de las entradas.
Uso
Se pueden llevar a cabo superposiciones de eventos de línea y línea, de línea y punto, de punto y línea y de punto y punto.
Los eventos de entrada y de superposición deben basarse en la misma referencia de ruta.
Las tablas de entrada pueden ser cualquier tipo de tabla que ArcGIS admita. La tabla de salida puede ser un archivo de dBASE o una tabla de geodatabase.
La tabla de salida se puede visualizar en ArcMap mediante la herramienta Crear capa de eventos de rutas o mediante el comando Mostrar eventos de rutas en ArcMap.
Si las propiedades de los eventos de entrada y de superposición son de tipo POINT, las propiedades de los eventos de salida también deben ser de tipo POINT.
Si las propiedades de los eventos de entrada y de superposición son de tipo LINE, las propiedades de los eventos de salida también deben ser de tipo LINE.
Si alguna de las propiedades de los eventos de entrada y de superposición son de tipo POINT, las propiedades de los eventos de salida deben definirse como de tipo POINT cuando se realiza una superposición INTERSECT. Las propiedades de los eventos de salida se deben definir como de tipo LINE, cuando se realiza una superposición UNION.
Si las propiedades de eventos de superposición y de entrada son de tipo POINT, se considera que solamente los puntos que tienen el mismo valor de medición exacto se intersecan. No hay tolerancia de búsqueda.
Un índice de atributos en el campo de identificador de rutas acelera el proceso de segmentación dinámica. Si utilizará la Tabla de eventos de salida para la segmentación dinámica, se recomienda que elija crear un índice de atributos.
Utilice la herramienta Crear vista de tabla antes de esta herramienta para reducir eficazmente el número de eventos que se procesarán.
Si alguno de los eventos de entrada o de superposición no tienen un campo Object ID, utilice la herramienta Realizar tabla de consultas antes de usar esta herramienta para agregar un campo Object ID virtual.
Sintaxis
OverlayRouteEvents_lr (in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})| Parámetro | Explicación | Tipo de datos |
in_table | La tabla de eventos de entrada. | 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 |
overlay_table | La tabla de eventos de superposición. | Table View |
overlay_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 superposición. Campo Identificador de rutas: el campo que contiene los valores que indican qué ruta está a lo largo de cada evento. Este campo puede ser numérico o de caracteres. Tipo de evento: el tipo de eventos en la tabla de eventos de superposición (POINT o LINE).
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 |
overlay_type | El tipo de superposición que se va a realizar.
| String |
out_table | La tabla que se creará. | Table |
out_event_properties | Parámetro que consiste en los campos de ubicación de ruta y el tipo de eventos que se escribirá en la tabla de eventos de salida.
| Route Measure Event Properties |
zero_length_events (Opcional) | Especifica si se mantienen los eventos de línea de longitud cero en la tabla de salida. Este parámetro sólo es válido cuando el tipo de evento de salida es LINE.
| Boolean |
in_fields (Opcional) | Especifica si todos los campos de las tablas de eventos de superposición y de entrada se escribirán en la tabla de eventos de salida.
| Boolean |
build_index (Opcional) | Especifica si se creará un índice de atributos para el campo identificador de rutas que se escriba en la tabla de eventos de salida.
| Boolean |
Muestra de código
Ejemplo de OverlayRouteEvents (Ventana de Python)
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr ("accident.dbf", "rkey POINT mile" , "pavecond.dbf", "rkey LINE fmp tmp", "INTERSECT", \
"accpav", "rkey POINT mile" )
Ejemplo de OverlayRouteEvents (Secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos de Python independiente.
# NAme: OverlayRouteEvents_Example.py
# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile" # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", \
out_tbl, in_props)
Ejemplo 2 de OverlayRouteEvents (Secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos de Python independiente utilizando los datos de geodatabase de archivos.
# Name OverlayRouteEvents_Example2.py
# Description: Line-on-line UNION overlay (both tables are in a file geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp" # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype"
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, in_props, "UNION", \
out_tbl, in_props, "NO_ZERO")
Ejemplo 3 de OverlayRouteEvents (Secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos de Python independiente utilizando los datos de geodatabase personal.
# Name: OverlayRouteEvents_Example3.py
# Description: Line-on-line UNION overlay (both tables are in a personal geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/Pitt.mdb"
# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp" # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype"
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, in_props, "UNION", \
out_tbl, in_props, "NO_ZERO")
Ejemplo 4 de OverlayRouteEvents (Secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos de Python independiente utilizando los datos SDE.
# Name: OverlayRouteEvents_Example4.py
# Description: Point-on-line INTERSECT overlay (both tables are in enterprise geodatabase)
# Import system modules
import arcoy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "rkey POINT mile"
ov_tbl = gp.QualifyTableName("pavecond", wkspc)
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost" # names are changed for out table
# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr (in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", \
out_tbl, out_props)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí