De puntos a líneas (Administración de datos)

Resumen

Crea entidades de línea a partir de puntos.

Ilustración

Ilustración de la herramienta De puntos a líneas

Uso

  • Las entidades de línea solo se escriben en la salida si la línea contiene dos o más vértices.

  • Si se especifica un campo como el valor del parámetro Campo de línea, las entidades de línea se construirán solo con puntos del valor único en el campo. El campo se incluirá en la clase de entidad de salida.

  • Si se especifica un campo como el valor del parámetro Ordenar campo, los puntos se ordenarán en orden ascendente del campo.

  • Puede crear polígonos a partir de puntos de entrada marcando primero el parámetro Cerrar línea para crear entidades de línea cerrada. Luego use la clase de entidad de línea de salida como entrada para la herramienta De entidad a polígono para crear entidades de polígono.

  • El parámetro Método de construcción de línea especifica cómo se construirán las entidades de línea. Las entidades de línea se pueden crear conectando puntos continuamente o conectando dos puntos consecutivos a medida que se ordenan. Por ejemplo, si la entrada contiene tres puntos que tienen un valor de Campo de línea de A y cuatro puntos tienen un valor de Campo de línea de B, se esperan los siguientes comportamientos de las opciones:

    • Construir línea continua: se crearán dos líneas de salida, una con dos segmentos y otra con tres segmentos. Si el parámetro Cerrar línea está marcado, se agregará un segmento adicional que conecta el último punto con el punto de inicio de cada entidad de línea para formar una línea cerrada.
    • Construir línea de dos puntos: se crearán cinco líneas de salida, cada una entre puntos consecutivos con el mismo valor de Campo de línea. Si el parámetro Cerrar línea está marcado, se agregarán entidades de línea adicionales que conectan el último punto con el punto de inicio para cada conjunto de puntos de entrada con el mismo valor de Campo de línea para formar una forma cerrada.

  • El parámetro Origen de atributo le permite especificar si los atributos de los puntos de entrada especificados por el parámetro Transferir campos se transferirán a las líneas de salida y cómo. El parámetro Origen de atributo admite las siguientes opciones:

    • Ninguno: no se transferirán atributos.
    • Desde los puntos inicial y final: los atributos se transferirán desde los puntos inicial y final de cada línea. Los nombres y alias de los campos de salida tendrán los prefijos START_ y END_; por ejemplo, START_FIELD1 (START_ALIAS1), END_FIELD1 (END_ALIAS1) y así sucesivamente.
    • Desde el punto inicial: los atributos se transferirán desde el punto inicial de cada línea.
    • Desde el punto final: los atributos se transferirán desde el punto final de cada línea.

  • Utilice el parámetro Transferir campos para identificar los campos que se transferirán desde la entrada. Los valores de campo se transferirán de acuerdo con el valor del parámetro Origen de atributo. Si se especifica el valor Ninguno para ese parámetro, no se transferirá ningún atributo.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de punto que se utilizarán para construir líneas.

Feature Layer
Clase de entidad de salida

La clase de entidad de línea que se creará a partir de los puntos de entrada.

Feature Class
Campo de línea
(Opcional)

El campo que se usará para identificar valores de atributos únicos para que las entidades de línea se puedan construir usando puntos de los mismos valores.

Si no se especifica ningún campo, las líneas se construirán sin utilizar valores de atributos únicos. Esta es la opción predeterminada.

Field
Campo de ordenamiento
(Opcional)

El campo que se utilizará para ordenar el orden de los puntos.

Si no se especifica ningún campo, los puntos utilizados para crear entidades de línea de salida se clasificarán en el orden en que se encuentren. Esta es la opción predeterminada.

Field
Cerrar línea
(Opcional)

Especifica si se cerrarán las entidades de línea de salida.

  • Activado: para una línea continua, se incluirá un segmento adicional que conecte el último punto con el primero para formar una línea cerrada. Para las líneas de dos puntos, se incluirá una entidad de línea adicional que conecte el último punto con el primero para formar una forma cerrada.
  • Desactivado: no se creará ningún segmento o línea adicional para garantizar una línea cerrada o una forma cerrada. Esta es la opción predeterminada.
Boolean
Método de construcción de líneas
(Opcional)

Especifica el método que se utilizará para construir las entidades de línea.

  • Construir líneas continuasLas entidades de línea se crearán conectando puntos continuamente. Esta es la opción predeterminada.
  • Construir líneas de dos puntosLas entidades de línea se crearán conectando dos puntos consecutivos.
String
Origen de atributo
(Opcional)

Especifica cómo se transferirán los atributos especificados.

  • NingunaNo se transferirán atributos. Esta es la opción predeterminada.
  • Puntos inicial y finalSe transferirán los atributos de los puntos inicial y final de la línea.
  • Punto de inicioSe transferirán los atributos desde el punto inicial de la línea.
  • Punto finalSe transferirán los atributos desde el punto final de la línea.
String
Transferir campos
(Opcional)

Los campos que contienen valores que se transferirán desde los puntos de origen a las líneas de salida. Si no se selecciona ningún campo, no se transferirá ningún atributo.

Si el valor del parámetro Origen de atributo se especifica como Ninguno, este parámetro estará inactivo.

Field

arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
NombreExplicaciónTipo de datos
Input_Features

Las entidades de punto que se utilizarán para construir líneas.

Feature Layer
Output_Feature_Class

La clase de entidad de línea que se creará a partir de los puntos de entrada.

Feature Class
Line_Field
(Opcional)

El campo que se usará para identificar valores de atributos únicos para que las entidades de línea se puedan construir usando puntos de los mismos valores.

Si no se especifica ningún campo, las líneas se construirán sin utilizar valores de atributos únicos. Esta es la opción predeterminada.

Field
Sort_Field
(Opcional)

El campo que se utilizará para ordenar el orden de los puntos.

Si no se especifica ningún campo, los puntos utilizados para crear entidades de línea de salida se clasificarán en el orden en que se encuentren. Esta es la opción predeterminada.

Field
Close_Line
(Opcional)

Especifica si se cerrarán las entidades de línea de salida.

  • CLOSEPara una línea continua, se incluirá un segmento adicional que conecte el último punto con el primero para formar una línea cerrada. Para las líneas de dos puntos, se incluirá una entidad de línea adicional que conecte el último punto con el primero para formar una forma cerrada.
  • NO_CLOSENo se creará ningún segmento o línea adicional para garantizar una línea cerrada o una forma cerrada. Esta es la opción predeterminada.
Boolean
Line_Construction_Method
(Opcional)

Especifica el método que se utilizará para construir las entidades de línea.

  • CONTINUOUSLas entidades de línea se crearán conectando puntos continuamente. Esta es la opción predeterminada.
  • TWO_POINTLas entidades de línea se crearán conectando dos puntos consecutivos.
String
Attribute_Source
(Opcional)

Especifica cómo se transferirán los atributos especificados.

  • NONENo se transferirán atributos. Esta es la opción predeterminada.
  • BOTH_ENDSSe transferirán los atributos de los puntos inicial y final de la línea.
  • STARTSe transferirán los atributos desde el punto inicial de la línea.
  • ENDSe transferirán los atributos desde el punto final de la línea.
String
Transfer_Fields
[Transfer_Fields,...]
(Opcional)

Los campos que contienen valores que se transferirán desde los puntos de origen a las líneas de salida. Si no se selecciona ningún campo, no se transferirá ningún atributo.

Si el valor del parámetro Attribute_Source se especifica como NONE, este parámetro se desactivará.

Field

Muestra de código

Ejemplo de PointsToLine (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
                              "C:/output/output.gdb/out_lines",
                              "ROUTE1", "MEASURE")
Ejemplo 2 de PointsToLine (script independiente)

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

# Description: Convert point features into line features

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inFeatures = "calibration_points.shp"
outFeatures = "C:/output/output.gdb/out_lines"
lineField = "ROUTE1"
sortField = "MEASURE"

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField)
Ejemplo 3 de PointsToLine (script independiente)

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

# Description: Convert point features into line features

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/points.gdb"

# Set local variables
inFeatures = "in_points"
outFeatures = "out_lines"
lineField = "lineID"
sortField = "stopID"
transFields = ["OBJECTID", "stopID"]

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField,
                              "NO_CLOSE", "TWO_POINT", "BOTH_ENDS", transFields)

Temas relacionados