Intersecar líneas 3D (3D Analyst)

Resumen

Calcula los segmentos de intersección y superposición de las líneas en el espacio 3D.

Uso

  • La herramienta funciona por pares. Cuando se intersecan más de dos líneas, el número de puntos de salida será una combinación matemática de las líneas que se cortan. Por ejemplo, tres líneas de intersección generarán tres puntos de salida, uno para la primera y la segunda intersección, otro para la primera y la tercera intersección, y otro para la segunda y la tercera intersección. Del mismo modo, cuando se intersecan cuatro líneas de entrada, se generan seis puntos de salida: para la primera y la segunda, para la primera y la tercera, para la primera y la cuarta, para la segunda y la tercera, para la segunda y la cuarta, y para la tercera y la cuarta.

  • Las entidades de entrada deben tener un índice espacial. Utilice la herramienta Agregar índice espacial para crear un índice nuevo (especialmente para los shapefiles) o volver a generar un índice existente si hay alguna duda de que sea correcto.

  • Si se proporcionan líneas 2D como entrada, se supone que todos los vértices se encuentran en una elevación cero.

  • Cuando se intersecan dos líneas con valores z diferentes debido a la tolerancia vertical permitida en la detección de intersecciones, el punto de salida utiliza la más alta de las dos elevaciones. De forma similar, cuando se intersecan dos segmentos de línea con valores z diferentes, la entidad de línea de salida se basa en los segmentos con valores z más altos.

  • Algunas líneas de salida pueden constar de varias partes debido a las dos líneas de entrada con varias secciones de superposición discontinuas o al acercamiento y alejamiento de las líneas en la dirección z.

  • Cuando los atributos se transfieren a la salida, los valores colocados en el primer conjunto de campos proceden de la primera línea de entrada y los valores del segundo conjunto de campos, de la segunda línea de entrada. Si se especifican dos capas de entidades de línea de entrada, las líneas de entrada primera y segunda proceden de la primera y la segunda capa de entidades de entrada de línea, respectivamente. Si solo se especifica una capa de entidades de línea de entrada, la regla es la misma, salvo que las columnas parecen repetirse.

  • Las entidades de punto de salida incluirán los siguientes campos de atributo:

    • I3L_TYPE: el valor 0 indica que el punto marca el extremo del segmento de línea de superposición, mientras que el valor 1 indica que el punto es una intersección de dos líneas.
    • I3L_GROUP: valor único que identifica todos los puntos que comparten la misma posición en el espacio horizontal.
    • I3L_OID1: id. de entidad de la primera entidad de línea de intersección.
    • I3L_OID2: id. de entidad de la segunda entidad de línea de intersección.
    • I3L_LINE1Z: valor z del punto de intersección de la primera línea.
    • I3L_LINE2Z: valor z del punto de intersección de la segunda línea.
    • I3L_Z_DIFF: diferencia en Z entre las dos líneas de entrada en la ubicación XY de la intersección.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Entidades de línea que se evaluarán para intersecciones. La entrada puede constar de una o dos clases o capas de entidades de línea. Si se especifica una entrada, cada entidad se comparará con las demás de esa clase de entidad. Ninguna entidad se comparará consigo misma.

Feature Layer
Diferencia Z máxima
(Opcional)

Distancia vertical máxima entre segmentos de línea que se cortan.

Linear Unit
Atributos para unir
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • Todos los atributosTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto los Id. de entidadTodos los atributos, excepto el atributo FID de las entidades de entrada, se transferirán a la clase de entidad de salida.
  • Solo Id. de entidadSolo se transferirá a la clase de entidad de salida el atributo FID de las entidades de entrada.
String
Clase de entidad de puntos de salida
(Opcional)

Puntos de salida que representan las ubicaciones en las que se intersecan las líneas de entrada, incluidas las ubicaciones en las que empiezan y terminan los segmentos de líneas de superposición.

Feature Class
Clase de entidad de línea de salida
(Opcional)

Líneas de salida que representan las secciones de superposición que existen entre las líneas de entrada.

Feature Class

Salida derivada

EtiquetaExplicaciónTipo de datos
Recuento de intersecciones de salida

Número de ubicaciones de intersección en las líneas de entrada.

Largo

arcpy.ddd.Intersect3DLines(in_lines, {max_z_diff}, {join_attributes}, {out_point_fc}, {out_line_fc})
NombreExplicaciónTipo de datos
in_lines
[in_lines,...]

Entidades de línea que se evaluarán para intersecciones. La entrada puede constar de una o dos clases o capas de entidades de línea. Si se especifica una entrada, cada entidad se comparará con las demás de esa clase de entidad. Ninguna entidad se comparará consigo misma.

Feature Layer
max_z_diff
(Opcional)

Distancia vertical máxima entre segmentos de línea que se cortan.

Linear Unit
join_attributes
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • ALLTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_FIDTodos los atributos, excepto el atributo FID de las entidades de entrada, se transferirán a la clase de entidad de salida.
  • ONLY_FIDSolo se transferirá a la clase de entidad de salida el atributo FID de las entidades de entrada.
String
out_point_fc
(Opcional)

Puntos de salida que representan las ubicaciones en las que se intersecan las líneas de entrada, incluidas las ubicaciones en las que empiezan y terminan los segmentos de líneas de superposición.

Feature Class
out_line_fc
(Opcional)

Líneas de salida que representan las secciones de superposición que existen entre las líneas de entrada.

Feature Class

Salida derivada

NombreExplicaciónTipo de datos
out_intersection_count

Número de ubicaciones de intersección en las líneas de entrada.

Largo

Muestra de código

Ejemplo de Intersect3DLines (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.Intersect3DLines(['floor_centerlines.shp', 'stairs.shp'], '2 Meters', 
                           'ONLY_FID', 'intersection_pts.shp')

Información de licenciamiento

  • Basic: Requiere 3D Analyst o ArcGIS Location Referencing
  • Standard: Requiere 3D Analyst o ArcGIS Location Referencing
  • Advanced: Requiere 3D Analyst o ArcGIS Location Referencing

Temas relacionados