Etiqueta | Explicación | Tipo 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.
| 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.
| Boolean |
Agregar campos de distancia acumulada y secuencia (Opcional) | Especifica si los campos de distancia acumulada y secuencia se agregarán a la salida.
| 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 |
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
arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})
Nombre | Explicación | Tipo 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.
| 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.
| 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
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")