Подпись | Описание | Тип данных |
Входные объекты | Точечные объекты, которые будут использоваться для построения линий. | Feature Layer |
Выходной класс объектов | Класс линейных объектов, который будет создан на основе точек. | Feature Class |
Поле линий (Дополнительный) | Поле, которое будет использоваться для определения уникальных значений атрибутов, чтобы можно было построить линейные объекты из точек с одинаковыми значениями. Если поле не указано, линии будут построены без использования уникальных значений атрибутов. Это значение по умолчанию | Field |
Поля сортировки (Дополнительный) | Поле, которое будет использоваться для выбора последовательности точек. Если поле не указано, точки, используемые для создания выходных линейных объектов, будут отсортированы в порядке их обнаружения. Это значение по умолчанию | Field |
Замкнуть линию (Дополнительный) | Определяет, будут ли выходные линейные объекты замкнутыми.
| Boolean |
Метод построения линий (Дополнительный) | Определяет метод, который будет использоваться для построения линейных объектов.
| String |
Источник атрибута (Дополнительный) | Определяет, как будут перенесены указанные атрибуты.
| String |
Перенос полей (Дополнительный) | Поля, содержащие значения, которые будут перенесены из исходных точек в выходные линии. Если поля не выбраны, никакие атрибуты не будут перенесены. Если значение параметра Источник атрибута задано как Нет, этот параметр будет неактивен. | Field |
Краткая информация
Создает линейные объекты из точек.
Иллюстрация
Использование
Линейные объекты записываются в выходные данные только в том случае, если линия будет содержать две или более вершин.
Если в качестве значения параметра Поле линий указано поле, линейные объекты будут построены из точек с уникальными значениями в этом поле. Поле будет включено в выходной класс пространственных объектов.
Если в качестве значения параметра Поле сортировки указано поле, точки будут отсортированы в порядке возрастания значений поля.
Вы можете создавать полигоны из входных точек, отметив сначала параметр Замкнуть линию, чтобы создать замкнутые линейные объекты. Затем использовав выходной класс линейных объектов в качестве входных данных для инструмента Объект в полигон, чтобы создать полигональные объекты.
Параметр Метод построения линий указывает, как будут построены линейные объекты. Линейные объекты можно создавать путем непрерывного соединения точек или путем соединения двух последовательных точек по мере их сортировки. Например, если входные данные содержат три точки со значением A в Поле линий и четыре точки со значением B в Поле линий, от опций ожидается следующее поведение:
- Построить непрерывную линию — будут созданы две выходные линии, одна с двумя сегментами и одна с тремя сегментами. Если отмечена опция Замкнуть линию, будет добавлен дополнительный сегмент, соединяющий последнюю точку с начальной точкой каждого линейного объекта, чтобы сформировать замкнутую линию.
- Построить двухточечную линию — будут созданы пять выходных линий, каждая между последовательными точками с одинаковым значением в Поле линий. Если отмечена опция Замкнуть линию, будут добавлены дополнительные линейные объекты, соединяющие последнюю точку с начальной точкой для каждого набора входных точек с одинаковым значением в Поле линий, чтобы сформировать замкнутую форму.
-
Параметр Источник атрибутов позволяет указать, будут ли и каким образом атрибуты входных точек, заданные параметром Перенос полей, переноситься в выходные линии. Параметр Источник атрибутов поддерживает следующие опции:
- Нет — Никакие атрибуты не будут перенесены.
- Из начальной и конечной точек — Будут перенесены атрибуты из начальной и конечной точек каждой линии. У выходных имен и псевдонимов полей будут префиксы START_ и END_, например, START_FIELD1 (START_ALIAS1), END_FIELD1 (END_ALIAS1) и т.д.
- Из начальной точки — Будут перенесены атрибуты из начальной точки каждой линии.
- Из конечной точки — Будут перенесены атрибуты из конечной точки каждой линии.
Используйте параметр Перенос полей, чтобы определить поля, которые будут перенесены из входных данных. Значения полей будут перенесены в соответствии со значением параметра Источник атрибута. Если для этого параметра указано значение Нет, никакие атрибуты не будут перенесены.
Параметры
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 (Дополнительный) | Определяет, будут ли выходные линейные объекты замкнутыми.
| Boolean |
Line_Construction_Method (Дополнительный) | Определяет метод, который будет использоваться для построения линейных объектов.
| String |
Attribute_Source (Дополнительный) | Определяет, как будут перенесены указанные атрибуты.
| String |
Transfer_Fields [Transfer_Fields,...] (Дополнительный) | Поля, содержащие значения, которые будут перенесены из исходных точек в выходные линии. Если поля не выбраны, никакие атрибуты не будут перенесены. Если значение параметра Attribute_Source задано как NONE, этот параметр будет неактивен. | Field |
Пример кода
В следующем скрипте окна Python показано, как используется функция PointsToLine в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
"C:/output/output.gdb/out_lines",
"ROUTE1", "MEASURE")
В следующем автономном скрипте показано использование функции 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.
# 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)