Superponer Eventos de rutas (Referenciación lineal)

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 un mapa utilizando la herramienta Crear capa de eventos de ruta.

• 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 las propiedades de los eventos de entrada o de superposición son de tipo Point, las propiedades de los eventos de salida se deben definir con el tipo Point si se realiza una superposición Intersecar. Las propiedades de los eventos de salida se deben definir con el tipo Line si se realiza una superposición Combinación.

• Si tanto las propiedades de evento de entrada como los de superposición son del tipo Point, solo se considera que se intersecan aquellos puntos que tengan el mismo valor de medición exacto. 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 va a 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 rutas y eventos que se procesarán.

• Si los eventos de entrada o de superposición carecen de un campo ObjectID, use la herramienta Crear tabla de consultas antes de esta herramienta para agregar un campo ObjectID virtual.

Sintaxis

arcpy.lr.OverlayRouteEvents(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. Campo Identificador de rutas: campo que contiene los 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 salida (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
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 carácter. Tipo de evento: el tipo de eventos en la tabla de eventos de superposición (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
overlay_type	El tipo de superposición que se va a realizar. INTERSECT —Sólo escribe los eventos superpuestos en la tabla de eventos de salida. Esta es la opción predeterminada. UNION —Escribe todos los eventos en la tabla de salida. Los eventos lineales se dividen en sus intersecciones.	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. Campo Identificador de rutas: campo que contendrá los valores que indican la ruta en la que se encuentra cada evento. Tipo de evento: el tipo de eventos que contendrá la tabla de eventos de salida (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 solo campo de medición. 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 contendrá los valores de medición. 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 contendrá los valores de medición. Se requiere cuando el tipo de evento es LINE.	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. ZERO —Mantiene los eventos de línea de longitud cero. Esta es la opción predeterminada. NO_ZERO —No mantiene los eventos de línea de longitud cero.	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. FIELDS —Incluye todos los campos de las tablas de entrada en la tabla de salida. Esta es la opción predeterminada. NO_FIELDS —No incluye todos los campos de las tablas de entrada en la tabla de salida. Sólo se mantienen los campos de ObjectID y de ubicación de ruta.	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. INDEX —Crea un índice de atributos. Esta es la opción predeterminada. NO_INDEX —No crea un índice de atributos.	Boolean

Muestra de código

Ejemplo 1 de OverlayRouteEvents (ventana de Python)

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr("accident.dbf", "rkey POINT mile", "pavecond.dbf", 
                            "rkey LINE fmp tmp", "INTERSECT", "accpav", 
                            "rkey POINT mile" )

Ejemplo 2 de OverlayRouteEvents (script independiente)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos independiente de Python.

# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Import system modules 
import arcpy
# Set workspace
arcpy.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 3 de OverlayRouteEvents (script independiente)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función OverlayRouteEvents en una secuencia de comandos independiente de Python utilizando datos de geodatabase de archivos.

# Description: Line-on-line UNION overlay (both tables are in a file 
#              geodatabase)
# Import system modules
import arcpy
# Set workspace
arcpy.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 4 de OverlayRouteEvents (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función OverlayRouteEvents en un script de Python independiente utilizando datos de geodatabase corporativa.

# Description: Point-on-line INTERSECT overlay (both tables are in enterprise 
#              geodatabase)
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc)
in_props = "rkey POINT mile"  
ov_tbl = arcpy.ValidateTableName("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

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

Información de licenciamiento

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