Точки в линию (Управление данными)

Краткая информация

Создает линейные объекты из точек.

Иллюстрация

Иллюстрация инструмента Точки в линию

Использование

  • Линейные объекты записываются в выходные данные только в том случае, если линия будет содержать две или более вершин.

  • Если в качестве значения параметра Поле линий указано поле, линейные объекты будут построены из точек с уникальными значениями в этом поле. Поле будет включено в выходной класс пространственных объектов.

  • Если в качестве значения параметра Поле сортировки указано поле, точки будут отсортированы в порядке возрастания значений поля.

  • Вы можете создавать полигоны из входных точек, отметив сначала параметр Замкнуть линию, чтобы создать замкнутые линейные объекты. Затем использовав выходной класс линейных объектов в качестве входных данных для инструмента Объект в полигон, чтобы создать полигональные объекты.

  • Параметр Метод построения линий указывает, как будут построены линейные объекты. Линейные объекты можно создавать путем непрерывного соединения точек или путем соединения двух последовательных точек по мере их сортировки. Например, если входные данные содержат три точки со значением A в Поле линий и четыре точки со значением B в Поле линий, от опций ожидается следующее поведение:

    • Построить непрерывную линию — будут созданы две выходные линии, одна с двумя сегментами и одна с тремя сегментами. Если отмечена опция Замкнуть линию, будет добавлен дополнительный сегмент, соединяющий последнюю точку с начальной точкой каждого линейного объекта, чтобы сформировать замкнутую линию.
    • Построить двухточечную линию — будут созданы пять выходных линий, каждая между последовательными точками с одинаковым значением в Поле линий. Если отмечена опция Замкнуть линию, будут добавлены дополнительные линейные объекты, соединяющие последнюю точку с начальной точкой для каждого набора входных точек с одинаковым значением в Поле линий, чтобы сформировать замкнутую форму.

  • Параметр Источник атрибутов позволяет указать, будут ли и каким образом атрибуты входных точек, заданные параметром Перенос полей, переноситься в выходные линии. Параметр Источник атрибутов поддерживает следующие опции:

    • Нет — Никакие атрибуты не будут перенесены.
    • Из начальной и конечной точек — Будут перенесены атрибуты из начальной и конечной точек каждой линии. У выходных имен и псевдонимов полей будут префиксы START_ и END_, например, START_FIELD1 (START_ALIAS1), END_FIELD1 (END_ALIAS1) и т.д.
    • Из начальной точки — Будут перенесены атрибуты из начальной точки каждой линии.
    • Из конечной точки — Будут перенесены атрибуты из конечной точки каждой линии.

  • Используйте параметр Перенос полей, чтобы определить поля, которые будут перенесены из входных данных. Значения полей будут перенесены в соответствии со значением параметра Источник атрибута. Если для этого параметра указано значение Нет, никакие атрибуты не будут перенесены.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Точечные объекты, которые будут использоваться для построения линий.

Feature Layer
Выходной класс объектов

Класс линейных объектов, который будет создан на основе точек.

Feature Class
Поле линий
(Дополнительный)

Поле, которое будет использоваться для определения уникальных значений атрибутов, чтобы можно было построить линейные объекты из точек с одинаковыми значениями.

Если поле не указано, линии будут построены без использования уникальных значений атрибутов. Это значение по умолчанию

Field
Поля сортировки
(Дополнительный)

Поле, которое будет использоваться для выбора последовательности точек.

Если поле не указано, точки, используемые для создания выходных линейных объектов, будут отсортированы в порядке их обнаружения. Это значение по умолчанию

Field
Замкнуть линию
(Дополнительный)

Определяет, будут ли выходные линейные объекты замкнутыми.

  • Отмечено — для непрерывной линии будет включен дополнительный сегмент, соединяющий последнюю точку с первой точкой, чтобы сформировать замкнутую линию. Для двухточечных линий будет добавлен дополнительный линейный объект, соединяющий последнюю точку с первой, чтобы сформировать замкнутую форму.
  • Не отмечено — дополнительный сегмент или линия не будут созданы для обеспечения замкнутой линии или замкнутой формы. Это значение по умолчанию
Boolean
Метод построения линий
(Дополнительный)

Определяет метод, который будет использоваться для построения линейных объектов.

  • Построить непрерывную линиюЛинейные объекты будут создаваться путем непрерывного соединения точек. Это значение по умолчанию
  • Построить двухточечную линиюЛинейные объекты будут созданы путем соединения двух последовательных точек.
String
Источник атрибута
(Дополнительный)

Определяет, как будут перенесены указанные атрибуты.

  • НетНикакие атрибуты не будут перенесены. Это значение по умолчанию
  • И начальная, и конечная точкиБудут перенесены атрибуты из начальной и конечной точек линии.
  • Начальная точкаБудут перенесены атрибуты из начальной точки линии.
  • Конечная точкаБудут перенесены атрибуты из конечной точки линии.
String
Перенос полей
(Дополнительный)

Поля, содержащие значения, которые будут перенесены из исходных точек в выходные линии. Если поля не выбраны, никакие атрибуты не будут перенесены.

Если значение параметра Источник атрибута задано как Нет, этот параметр будет неактивен.

Field

arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})
ИмяОписаниеТип данных
Input_Features

Точечные объекты, которые будут использоваться для построения линий.

Feature Layer
Output_Feature_Class

Класс линейных объектов, который будет создан на основе точек.

Feature Class
Line_Field
(Дополнительный)

Поле, которое будет использоваться для определения уникальных значений атрибутов, чтобы можно было построить линейные объекты из точек с одинаковыми значениями.

Если поле не указано, линии будут построены без использования уникальных значений атрибутов. Это значение по умолчанию

Field
Sort_Field
(Дополнительный)

Поле, которое будет использоваться для выбора последовательности точек.

Если поле не указано, точки, используемые для создания выходных линейных объектов, будут отсортированы в порядке их обнаружения. Это значение по умолчанию

Field
Close_Line
(Дополнительный)

Определяет, будут ли выходные линейные объекты замкнутыми.

  • CLOSEДля непрерывной линии будет включен дополнительный сегмент, соединяющий последнюю точку с первой точкой, чтобы сформировать замкнутую линию. Для двухточечных линий будет добавлен дополнительный линейный объект, соединяющий последнюю точку с первой, чтобы сформировать замкнутую форму.
  • NO_CLOSEДополнительный сегмент или линия не будут созданы для обеспечения замкнутой линии или замкнутой формы. Это значение по умолчанию
Boolean
Line_Construction_Method
(Дополнительный)

Определяет метод, который будет использоваться для построения линейных объектов.

  • CONTINUOUSЛинейные объекты будут создаваться путем непрерывного соединения точек. Это значение по умолчанию
  • TWO_POINTЛинейные объекты будут созданы путем соединения двух последовательных точек.
String
Attribute_Source
(Дополнительный)

Определяет, как будут перенесены указанные атрибуты.

  • NONEНикакие атрибуты не будут перенесены. Это значение по умолчанию
  • BOTH_ENDSБудут перенесены атрибуты из начальной и конечной точек линии.
  • STARTБудут перенесены атрибуты из начальной точки линии.
  • ENDБудут перенесены атрибуты из конечной точки линии.
String
Transfer_Fields
[Transfer_Fields,...]
(Дополнительный)

Поля, содержащие значения, которые будут перенесены из исходных точек в выходные линии. Если поля не выбраны, никакие атрибуты не будут перенесены.

Если значение параметра Attribute_Source задано как NONE, этот параметр будет неактивен.

Field

Пример кода

Пример PointsToLine (окно Python)

В следующем скрипте окна Python показано, как используется функция PointsToLine в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
                              "C:/output/output.gdb/out_lines",
                              "ROUTE1", "MEASURE")
PointsToLine, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции 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)
PointsToLine, пример 3 (автономный скрипт)

В следующем автономном скрипте показано использование функции 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)

Связанные разделы