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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 porcentaje—El valor del parámetro Porcentaje se utilizará para colocar los puntos a lo largo de las entidades por porcentaje. Por distancia—El 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

Python

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})

Nombre	Explicación	Tipo 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. PERCENTAGE—El valor del parámetro Percentage se utilizará para colocar los puntos a lo largo de las entidades por porcentaje. DISTANCE—El 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_POINTS—Se incluirán puntos adicionales en el punto inicial y final de la entidad. NO_END_POINTS—No 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_CHAINAGE—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 Input_Features. NO_CHAINAGE—Los 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')

Entornos

Espacio de trabajo actual, Palabra clave CONFIG de salida, La salida tiene valores M, La salida tiene valores Z

Información de licenciamiento

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