Построить точки вдоль линий (Управление данными)

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

Создает вдоль линий или полигонов точечные объекты на фиксированном расстоянии друг от друга или на расстоянии, соответствующем процентному отношению от длины объекта.

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

  • Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле ORIG_FID будет добавлено к выходному классу объектов, оно будет содержать ID входных объектов.

    Если отмечен параметр Добавить поля накопленного расстояния и последовательности, будут добавлены следующие поля:

    • ORIG_LEN— Суммарное расстояние вдоль линии от начальной точки линии до точки. Значения расстояний добавляются в единицах пространственной привязки значения Входные объекты.
    • ORIG_SEQ— Порядковый номер для каждой точки в порядке создания точек из каждой входной строки.

Параметры

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

Линейные или полигональные объекты, конвертируемые в точки.

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

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

Feature Class
Размещение точек

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

  • По прямоугольникуЗначение параметра Проценты используется для размещения точек вдоль объектов по процентному соотношению.
  • По расстояниюЗначение параметра Расстояние используется для размещения точек вдоль объектов на фиксированном расстоянии. Это значение по умолчанию
String
Расстояние
(Дополнительный)

Интервал от начала объекта, вдоль которого размещаются точки.

Linear Unit
Процент
(Дополнительный)

Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта.

Double
Включить конечные точки
(Дополнительный)

Задает, добавляются ли дополнительные точки в начале и конце объекта.

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

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

  • Отмечено – Поля накопленного расстояния (ORIG_LEN) и последовательности (ORIG_SEQ) будут добавлены к выходным данным. Значения расстояний добавляются в единицах пространственной привязки значения Входные объекты.
  • Не отмечено – Поля накопленного расстояния и последовательности не будут добавлены к выходным данным. Это значение по умолчанию
Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})
ИмяОписаниеТип данных
Input_Features

Линейные или полигональные объекты, конвертируемые в точки.

Feature Layer
Output_Feature_Class

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

Feature Class
Point_Placement

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

  • PERCENTAGEЗначение параметра Percentage используется для размещения точек вдоль объектов по процентному соотношению.
  • DISTANCEЗначение параметра Distance используется для размещения точек вдоль объектов на фиксированном расстоянии. Это значение по умолчанию
String
Distance
(Дополнительный)

Интервал от начала объекта, вдоль которого размещаются точки.

Linear Unit
Percentage
(Дополнительный)

Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта.

Double
Include_End_Points
(Дополнительный)

Задает, добавляются ли дополнительные точки в начале и конце объекта.

  • END_POINTSДополнительные точки в начале и конце объекта добавляются.
  • NO_END_POINTSДополнительные точки в начале и конце объекта не добавляются. Это значение по умолчанию
Boolean
Add_Chainage_Fields
(Дополнительный)

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

  • ADD_CHAINAGEПоля накопленного расстояния (ORIG_LEN) и последовательности (ORIG_SEQ) будут добавлены к выходным данным. Значения расстояний добавляются в единицах пространственной привязки значения Input_Features.
  • NO_CHAINAGEПоля накопленного расстояния и последовательности не будут добавлены к выходным данным. Это значение по умолчанию
Boolean

Пример кода

GeneratePointsAlongLines, пример 1 (окно Python)

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

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)
GeneratePointsAlongLines, пример 2 (автономный скрипт)

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

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