Generar puntos a lo largo de líneas (Administración de datos)

Resumen

Crea entidades de puntos a lo largo de líneas o polígonos a intervalos fijos o por porcentaje de la longitud de la entidad.

Uso

  • Los atributos de las entidades de entrada se mantendrán en la clase de entidad de salida. Se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida y se establecerá en los Id. de entidad de entrada.

    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

Las entidades de línea o poligonales que se convertirán a puntos.

Feature Layer
Clase de entidad de salida

La clase de entidad de puntos que se creará a partir de las entidades de entrada.

Feature Class
Ubicación del punto

Especifica el método utilizado para crear puntos.

  • Por porcentajeEl valor del parámetro Porcentaje se utilizará para colocar los puntos a lo largo de las entidades por porcentaje.
  • 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.
String
Distancia
(Opcional)

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

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.

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 o secuencia no se agregarán a la salida. Esta es la opción predeterminada.
Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})
NombreExplicaciónTipo de datos
Input_Features

Las entidades de línea o poligonales que se convertirán a puntos.

Feature Layer
Output_Feature_Class

La clase de entidad de puntos que se creará a partir de las entidades de entrada.

Feature Class
Point_Placement

Especifica el método que se utilizará para crear puntos.

  • 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.
String
Distance
(Opcional)

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

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.

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)

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

  • ADD_CHAINAGELos 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 Input_Features.
  • NO_CHAINAGELos campos de distancia acumulada o secuencia no se agregarán a la salida. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de GeneratePointsAlongLines (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función GeneratePointsAlongLines de modo inmediato.

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.management.GeneratePointsAlongLines('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)
Ejemplo 2 de GeneratePointsAlongLines (secuencia de comandos independiente)

El siguiente script independiente muestra cómo utilizar la función GeneratePointsAlongLines.

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Run GeneratePointsAlongLines by distance
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Run GeneratePointsAlongLines by percentage
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

Información de licenciamiento

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

Temas relacionados