Generar puntos a lo largo de líneas 3D (3D Analyst)

Resumen

Crea entidades de punto 3D a lo largo de líneas 3D utilizando distancias tridimensionales.

Uso

  • Esta herramienta genera entidades de punto 3D a lo largo de líneas midiendo la distancia a la que se crearán los puntos mediante el uso de distancias tridimensionales. Cuando sea necesario calcular los puntos que se muestrean desde la línea 3D usando distancias bidimensionales a lo largo del plano x,y, utilice la herramienta Generar puntos a lo largo de líneas en su lugar.

  • Los puntos pueden colocarse a un intervalo fijo para todas las entidades, o a lo largo de las entidades por porcentaje de la longitud de la entidad. Los puntos también pueden colocarse utilizando un campo de la entrada; el campo puede representar un intervalo fijo para cada entidad o distancias específicas para cada entidad.

    Utilice el parámetro Ubicación de punto para especificar el método que se utilizará para colocar los puntos de salida.

  • The attributes of the input features will be maintained in the output feature class. A new field, ORIG_FID, will be added to the output feature class and set to the input feature IDs.

  • Si el parámetro Agregar campos de distancia acumulada y secuencia está activado, se agregarán los campos siguientes:

    • ORIG_LEN— Distancia acumulada a lo largo de la línea desde el punto inicial de la línea hasta el punto. Los valores de distancia se agregan en las unidades de la referencia espacial del valor de Entidades de entrada.
    • ORIG_SEQ— Número de secuencia de cada punto en el orden de los puntos creados a partir de cada línea de entrada.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Entidades de línea 3D que se utilizarán para crear puntos.

Feature Layer
Clase de entidad de salida

Entidades de punto 3D que se crearán a partir de las líneas de entrada.

Feature Class
Ubicación del punto

Especifica el método que se utilizará para muestrear los puntos a lo largo de las entidades de línea 3D.

  • Por distanciaEl valor del parámetro Distancia se utilizará para colocar los puntos en distancias fijas a lo largo de las entidades. Esta es la opción predeterminada.
  • Por porcentajeEl valor del parámetro Porcentaje se utilizará para colocar los puntos a lo largo de las entidades por porcentaje.
  • Por campo de distanciaLos valores de campo del valor del parámetro Campo de distancia se utilizarán para colocar puntos a lo largo de las entidades.
String
Distancia
(Opcional)

El intervalo desde el comienzo de la entidad con el que se colocarán los puntos.

Este parámetro se activa cuando el parámetro Ubicación de punto se establece en Por distancia.

Linear Unit
Porcentaje
(Opcional)

El porcentaje desde el comienzo de la entidad con el que se colocarán los puntos. Por ejemplo, si se utiliza un porcentaje de 40, los puntos se colocarán al 40 por ciento y al 80 por ciento desde la distancia de la entidad.

Este parámetro se activa cuando el parámetro Ubicación de punto se establece en Por porcentaje.

Double
Incluir extremos
(Opcional)

Especifica si se incluirán puntos adicionales en el punto inicial y final de la entidad.

  • Activado: se incluirán puntos adicionales en el punto inicial y final de la entidad.
  • Desactivado: no se agregarán puntos adicionales en el punto inicial y final de la entidad. Esta es la opción predeterminada.
Boolean
Agregar campos de distancia acumulada y secuencia
(Opcional)

Especifica si los campos de distancia acumulada y secuencia se agregarán a la salida.

  • Activado: los campos de distancia acumulada (ORIG_LEN) y secuencia (ORIG_SEQ) se agregarán a la salida. Los valores de distancia se agregan en las unidades de la referencia espacial del valor de Entidades de entrada.
  • Desactivado: los campos de distancia acumulada y secuencia no se agregarán a la salida. Esta es la opción predeterminada.
Boolean
Campo de distancia
(Opcional)

Campo de las entidades de entrada que se utilizará para colocar los puntos de salida.

Si el campo es de tipo numérico, el valor del campo se utilizará para situar los puntos en ese intervalo.

Si el campo es de tipo cadena de caracteres, los valores del campo deben organizarse como una cadena de caracteres de distancias delimitada por un punto y coma. Los puntos se colocarán a esas distancias.

Los valores de campo que sean cero o negativos se ignorarán. Los valores de campo que superen la longitud de una entidad se ignorarán para la entidad en cuestión.

Las distancias estarán en las unidades lineales de la referencia espacial de entrada.

Este parámetro se activa cuando el parámetro Ubicación de punto se establece en Por campo de distancia.

Field

arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})
NombreExplicaciónTipo de datos
in_feature

Entidades de línea 3D que se utilizarán para crear puntos.

Feature Layer
out_features

Entidades de punto 3D que se crearán a partir de las líneas de entrada.

Feature Class
point_placement

Especifica el método que se utilizará para muestrear los puntos a lo largo de las entidades de línea 3D.

  • PERCENTAGEEl valor del parámetro percentage se utilizará para colocar los puntos a lo largo de las entidades por porcentaje.
  • DISTANCEEl valor del parámetro distance se utilizará para colocar los puntos en distancias fijas a lo largo de las entidades. Esta es la opción predeterminada.
  • DISTANCE_FIELDLos valores de campo del valor del parámetro distance_field se utilizarán para colocar puntos a lo largo de las entidades.
String
distance
(Opcional)

El intervalo desde el comienzo de la entidad con el que se colocarán los puntos.

Este parámetro se activa cuando el parámetro point_placement se establece en DISTANCE_FIELD.

Linear Unit
percentage
(Opcional)

El porcentaje desde el comienzo de la entidad con el que se colocarán los puntos. Por ejemplo, si se utiliza un porcentaje de 40, los puntos se colocarán al 40 por ciento y al 80 por ciento desde la distancia de la entidad.

Este parámetro se activa cuando el parámetro point_placement se establece en PERCENTAGE.

Double
include_end_points
(Opcional)

Especifica si se incluirán puntos adicionales en el punto inicial y final de la entidad.

  • END_POINTSSe incluirán puntos adicionales en el punto inicial y final de la entidad.
  • NO_END_POINTSNo se incluirán puntos adicionales en el punto inicial y final de la entidad. Esta es la opción predeterminada.
Boolean
add_chainage_fields
(Opcional)
Boolean
distance_field
(Opcional)

Campo de las entidades de entrada que se utilizará para colocar los puntos de salida.

Si el campo es de tipo numérico, el valor del campo se utilizará para situar los puntos en ese intervalo.

Si el campo es de tipo cadena de caracteres, los valores del campo deben organizarse como una cadena de caracteres de distancias delimitada por un punto y coma. Los puntos se colocarán a esas distancias.

Los valores de campo que sean cero o negativos se ignorarán. Los valores de campo que superen la longitud de una entidad se ignorarán para la entidad en cuestión.

Las distancias estarán en las unidades lineales de la referencia espacial de entrada.

Este parámetro se activa cuando el parámetro point_placement se establece en DISTANCE_FIELD.

Field

Muestra de código

Ejemplo de GeneratePointsAlong3DLines (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.GeneratePointsAlong3DLines("hiking_trail.shp", "evaluation_points.shp", "PERCENTAGE"
                                      percentage=5, add_chainage_fields="ADD_CHAINAGE")

Temas relacionados