Etiqueta | Explicación | Tipo 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.
| Boolean |
Método de construcción de líneas (Opcional) | Especifica el método que se utilizará para construir las entidades de línea.
| String |
Origen de atributo (Opcional) | Especifica cómo se transferirán los atributos especificados.
| 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 |
Resumen
Crea entidades de línea a partir de puntos.
Ilustración
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
arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
Nombre | Explicación | Tipo 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.
| Boolean |
Line_Construction_Method (Opcional) | Especifica el método que se utilizará para construir las entidades de línea.
| String |
Attribute_Source (Opcional) | Especifica cómo se transferirán los atributos especificados.
| 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
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")
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)
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)