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 compatible con ArcGIS. La tabla de salida puede ser un archivo .dbf o una tabla de geodatabase.

  • El valor del parámetro Tabla de eventos 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 Punto, las propiedades de los eventos de salida también deben ser de tipo Punto.

  • Si las propiedades de los eventos de entrada y de superposición son de tipo Línea, las propiedades de los eventos de salida también deben ser de tipo Línea.

  • Si alguna de las propiedades de los eventos de entrada o de superposición son de tipo Punto, las propiedades de los eventos de salida deben definirse como de tipo Punto cuando el valor del parámetro Tipo de superposición es Intersecar. Las propiedades de los eventos de salida se deben definir como de tipo Línea cuando el valor del parámetro Tipo de superposición es Combinación.

  • Si tanto las propiedades de evento de entrada como los de superposición son del tipo Punto, 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 identificador de rutas acelera el proceso de segmentación dinámica. Si va a utilizar el valor del parámetro Tabla de eventos de salida para la segmentación dinámica, se recomienda que cree un índice de atributos.

  • Utilice la herramienta Crear vista de tabla antes de ejecutar esta herramienta para reducir el número de eventos que se procesarán.

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

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de eventos de entrada

La tabla de eventos de entrada.

Table View
Propiedades de tabla de eventos de entrada

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 la ruta. Sólo se debe especificar un campo de medición inicial.
    • Línea: 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 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
Tabla de eventos de superposición

La tabla de eventos de superposición.

Table View
Propiedades de Tabla de eventos de superposición

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 un campo numérico, de texto o GUID.

Tipo de evento: el tipo de evento de la tabla de eventos de superposición (Punto o Línea).

  • Punto: 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.
  • Línea: 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: campo que contiene valores de medición inicial. Este campo debe ser numérico y se requiere cuando el tipo de evento es Punto o Línea. Cuando el Tipo de evento es Punto, la etiqueta de este parámetro pasa a ser Campo de medición.

Campo de medición final: un campo que contiene valores de medición final. Este campo debe ser numérico y se requiere cuando el tipo de evento es Línea.

Route Measure Event Properties
Tipo de superposición

Especifica el tipo de superposición que se realizará.

  • IntersecarSolo se escribirán los eventos superpuestos en la tabla de eventos de salida. Esta es la opción predeterminada.
  • CombinaciónTodos los eventos se escribirán en la tabla de salida. Los eventos lineales se dividirán en sus intersecciones.
String
Tabla de eventos de salida

La tabla que se creará.

Table
Propiedades de la Tabla de eventos de salida

Los campos de ubicación de ruta y el tipo de eventos que se escribirán en la tabla de eventos de salida.

  • Campo Identificador de rutas: el campo que contendrá valores que indican la ruta en la que se encuentra cada evento. El campo puede ser un campo numérico, de texto o GUID.
  • Tipo de vento: tipos de evento que contendrá la tabla de eventos de salida (Punto o Línea).
    • Punto: los eventos de punto ocurren en una ubicación precisa a lo largo de la ruta. Solo se debe especificar un único campo de medición.
    • Línea: 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á 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 contendrá 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
Mantener los eventos de línea de longitud cero
(Opcional)

Especifica si los eventos de línea de longitud cero se agregarán al valor del parámetro Tabla de eventos de salida. Este parámetro sólo es válido cuando el tipo de evento de salida es Línea.

  • Activado: se agregarán eventos de línea de longitud cero. Esta es la opción predeterminada.
  • Desactivado: no se agregarán eventos de línea de longitud cero.
Boolean
Incluir todos los campos de la entrada
(Opcional)

Especifica si todos los campos de las tablas de eventos de superposición y de entrada se incluirán en el valor del parámetro Tabla de eventos de salida.

  • Activado: todos los campos de las tablas de entrada se incluirán en la tabla de salida. Esta es la opción predeterminada.
  • Activado: no todos los campos de las tablas de entrada se incluirán en la tabla de salida. Solo se incluirán el campo ObjectID y los campos de ubicación de ruta.
Boolean
Crear índice
(Opcional)

Especifica si se creará un índice de atributos para el campo identificador de rutas que se escriba en el valor del parámetro Tabla de eventos de salida.

  • Activado: se creará un índice de atributo. Esta es la opción predeterminada.
  • Desactivado: no se creará ningún índice de atributo.
Boolean

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})
NombreExplicaciónTipo de datos
in_table

La tabla de eventos de entrada.

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.

  • Campo Identificador de rutas: 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.
  • Tipo de evento: el tipo de eventos en la tabla de eventos de superposición (POINT o LINE).
    • POINT: los eventos de punto se producen en una ubicación precisa de una ruta. Sólo se debe especificar un campo de medición inicial.
    • LINE: los eventos de línea definen una parte 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 POINT o LINE.
  • 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

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 un campo numérico, de texto o GUID.

Tipo de evento: el tipo de eventos en la tabla de eventos de superposición (POINT o LINE).

  • POINT: los eventos de punto se producen en una ubicación precisa de una ruta. Sólo se debe especificar un campo de medición inicial.
  • LINE: los eventos de línea definen una parte 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 POINT o LINE.

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

Especifica el tipo de superposición que se realizará.

  • INTERSECTSolo se escribirán los eventos superpuestos en la tabla de eventos de salida. Esta es la opción predeterminada.
  • UNIONTodos los eventos se escribirán en la tabla de salida. Los eventos lineales se dividirán en sus intersecciones.
String
out_table

La tabla que se creará.

Table
out_event_properties

Los campos de ubicación de ruta y el tipo de eventos que se escribirán 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. El campo puede ser un campo numérico, de texto o GUID.
  • Tipo de evento: el tipo de eventos que contendrá la tabla de eventos de salida (POINT o LINE).
    • POINT: los eventos de punto se producen en una ubicación precisa de una ruta. Solo se debe especificar un único campo de medición.
    • LINE: los eventos de línea definen una parte 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 contendrá valores de medición. Este campo es obligatorio si el tipo de evento es POINT o LINE.
  • Campo de medición final: un campo que contendrá valores de medición. Este campo es obligatorio si el tipo de evento es LINE.
Route Measure Event Properties
zero_length_events
(Opcional)

Especifica si los eventos de línea de longitud cero se agregarán al valor del parámetro out_table. Este parámetro sólo es válido cuando el tipo de evento de salida es LINE.

  • ZEROSe agregarán eventos de línea de longitud cero. Esta es la opción predeterminada.
  • NO_ZERONo se agregarán 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 incluirán en el valor del parámetro out_table.

  • FIELDSTodos los campos de las tablas de entrada se incluirán en la tabla de salida. Esta es la opción predeterminada.
  • NO_FIELDSNo todos los campos de las tablas de entrada se incluirán en la tabla de salida. Solo se incluirán el campo ObjectID y los campos de ubicación de ruta.
Boolean
build_index
(Opcional)

Especifica si se creará un índice de atributos para el campo identificador de rutas escrito en el valor del parámetro out_table.

  • INDEXSe creará un índice de atributo. Esta es la opción predeterminada.
  • NO_INDEXNo se creará ningún índice de atributo.
Boolean

Muestra de código

Ejemplo 1 de OverlayRouteEvents (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función OverlayRouteEvents.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.OverlayRouteEvents("accident.dbf", "rkey POINT mile", "pavecond.dbf", 
                            "rkey LINE fmp tmp", "INTERSECT", "accpav", 
                            "rkey POINT mile" )
Ejemplo 2 de OverlayRouteEvents (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función OverlayRouteEvents en un script 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"

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(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" 

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, in_props, "UNION", 
                            out_tbl, in_props, "NO_ZERO")
Ejemplo 4 de OverlayRouteEvents (script independiente)

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

# Description: Point-on-line INTERSECT overlay (both tables are in an 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

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, out_props)

Información de licenciamiento

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

Temas relacionados