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.

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

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points})
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

Muestra de código

Ejemplo 1 de GeneratePointsAlongLines (ventana de Python)

La siguiente secuencia de comandos 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.GeneratePointsAlongLines_management('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.GeneratePointsAlongLines_management('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)
Ejemplo 2 de GeneratePointsAlongLines (secuencia de comandos independiente)

El siguiente script independiente muestra cómo utilizar 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'

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

# Execute GeneratePointsAlongLines by percentage
arcpy.GeneratePointsAlongLines_management(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