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.

Uso

• 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.

• 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	Entidades de línea o polígono que se utilizarán para colocar 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 que se utilizará para colocar 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. Por campo de distancia—Los 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
Método de distancia (Opcional)	Especifica el método de medición que se utilizará para crear los puntos. Este parámetro se activa cuando el parámetro Ubicación de punto se establece en Por distancia. Planar—Los puntos se crearán utilizando un método planar. Las mediciones de tipo planar usan matemáticas cartesianas 2D. Esta es la opción predeterminada. Geodésica—Los puntos se crearán utilizando un método geodésico. Las mediciones geodésicas calculan la distancia entre dos puntos en la superficie terrestre. Es la opción predeterminada cuando la entrada tiene un sistema de coordenadas geográfico.	String

Python

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

Nombre	Explicación	Tipo de datos
Input_Features	Entidades de línea o polígono que se utilizarán para colocar 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 colocar 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. DISTANCE_FIELD—Los valores de campo del valor del parámetro Distance_Field se utilizarán para colocar puntos.	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.	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_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 y secuencia no se agregarán a la salida. Esta es la opción predeterminada.	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
Distance_Method (Opcional)	Especifica el método de medición que se utilizará para crear los puntos. Este parámetro se activa cuando el parámetro Point_Placement se establece en DISTANCE. PLANAR—Los puntos se crearán utilizando un método planar. Las mediciones de tipo planar usan matemáticas cartesianas 2D. Esta es la opción predeterminada. GEODESIC—Los puntos se crearán utilizando un método geodésico. Las mediciones geodésicas calculan la distancia entre dos puntos en la superficie terrestre. Es la opción predeterminada cuando la entrada tiene un sistema de coordenadas geográfico.	String

Muestra de código

Ejemplo 1 de GeneratePointsAlongLines (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra 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)
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_by_field', 'DISTANCE_FIELD', Distance_Field='distance')

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')

# Run GeneratePointsAlongLines by distance field
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'DISTANCE_FIELD',
                                          Distance_Field='distance')

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í