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

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

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

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

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

Используйте параметр Размещение точек, чтобы задать метод, который будет использоваться для размещения выходных точек.
Атрибуты входных объектов будут сохранены в выходном классе объектов. Новое поле ORIG_FID будет добавлено в выходной класс объектов и установлено на ID входных объектов.
Если отмечен параметр Добавить поля накопленного расстояния и последовательности, будут добавлены следующие поля:
- ORIG_LEN—Суммарное расстояние вдоль линии от начальной точки линии до точки. Значения расстояний добавляются в единицах пространственной привязки значения Входные объекты.
- ORIG_SEQ—Порядковый номер для каждой точки в порядке создания точек из каждой входной строки.

Подпись	Объяснение	Тип данных
Входные объекты	Линейные или полигональные объекты, которые будут использоваться для размещения точек.	Feature Layer
Выходной класс пространственных объектов	Класс точечных объектов, который будет создан из входных объектов.	Feature Class
Размещение точек	Задает метод, который будет использоваться для размещения точек. По процентам–Значение параметра Проценты используется для размещения точек вдоль объектов по процентному соотношению. По расстоянию–Значение параметра Расстояние используется для размещения точек вдоль объектов на фиксированном расстоянии. Используется по умолчанию. По полю расстояния–Значения полей из значения параметра Поле расстояния будут использоваться для размещения точек вдоль объектов.	String
Расстояние (Дополнительный)	Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра Размещение точек задано По расстоянию.	Linear Unit
Процент (Дополнительный)	Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра Размещение точек задано По процентам.	Double
Включить конечные точки (Дополнительный)	Задает, добавляются ли дополнительные точки в начале и конце объекта. Отмечено–Дополнительные точки в начале и конце объекта добавляются. Не отмечено–Дополнительные точки в начале и конце объекта не добавляются. Используется по умолчанию.	Boolean
Добавить поля накопленного расстояния и последовательности (Дополнительный)	Указывает, будут ли добавлены поля накопленного расстояния и последовательности к выходным данным. Отмечено–Поля накопленного расстояния (`ORIG_LEN`) и последовательности (`ORIG_SEQ`) будут добавлены к выходным данным. Значения расстояний добавляются в единицах пространственной привязки значения параметра Входные объекты. Не отмечено–Поля накопленного расстояния и последовательности не будут добавлены к выходным данным. Используется по умолчанию.	Boolean
Поле расстояния (Дополнительный)	Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра Размещение точек задано По полю расстояния.	Field
Метод расстояний (Дополнительный)	Определяет метод измерения, который будет использоваться для создания точек. Это параметр активен, когда для параметра Размещение точек задано По расстоянию. Плоскостной–Точки будут созданы с использованием планарного метода. При выполнении измерений на плоскости используется декартова система координат 2D. Используется по умолчанию. Геодезический–Точки будут созданы с использованием геодезического метода. Геодезические измерения позволяют рассчитать расстояние между двумя точками на поверхности Земли.	String

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields}, {Distance_Field}, {Distance_Method})

Имя	Объяснение	Тип данных
Input_Features	Линейные или полигональные объекты, которые будут использоваться для размещения точек.	Feature Layer
Output_Feature_Class	Класс точечных объектов, который будет создан из входных объектов.	Feature Class
Point_Placement	Задает метод, который будет использоваться для размещения точек. `PERCENTAGE`–Значение параметра `Percentage` используется для размещения точек вдоль объектов по процентному соотношению. `DISTANCE`–Значение параметра `Distance` используется для размещения точек вдоль объектов на фиксированном расстоянии. Используется по умолчанию. `DISTANCE_FIELD`–Значения полей из значения параметра `Distance_Field` будут использоваться для размещения точек.	String
Distance (Дополнительный)	Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра `Point_Placement` задано `DISTANCE`.	Linear Unit
Percentage (Дополнительный)	Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра `Point_Placement` задано `PERCENTAGE`.	Double
Include_End_Points (Дополнительный)	Задает, добавляются ли дополнительные точки в начале и конце объекта. `END_POINTS`–Дополнительные точки в начале и конце объекта добавляются. `NO_END_POINTS`–Дополнительные точки в начале и конце объекта не добавляются. Используется по умолчанию.	Boolean
Add_Chainage_Fields (Дополнительный)	Указывает, будут ли добавлены поля накопленного расстояния и последовательности к выходным данным. `ADD_CHAINAGE`–Поля накопленного расстояния (`ORIG_LEN`) и последовательности (`ORIG_SEQ`) будут добавлены к выходным данным. Значения расстояний добавляются в единицах пространственной привязки значения `Input_Features`. `NO_CHAINAGE`–Поля накопленного расстояния и последовательности не будут добавлены к выходным данным. Используется по умолчанию.	Boolean
Distance_Field (Дополнительный)	Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра `Point_Placement` задано `DISTANCE_FIELD`.	Field
Distance_Method (Дополнительный)	Определяет метод измерения, который будет использоваться для создания точек. Это параметр активен, когда для параметра `Point_Placement` задано `DISTANCE`. `PLANAR`–Точки будут созданы с использованием планарного метода. При выполнении измерений на плоскости используется декартова система координат 2D. Используется по умолчанию. `GEODESIC`–Точки будут созданы с использованием геодезического метода. Геодезические измерения позволяют рассчитать расстояние между двумя точками на поверхности Земли.	String

Пример кода

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)
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_by_field', 'DISTANCE_FIELD', Distance_Field='distance')

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')

# Run GeneratePointsAlongLines by distance field
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'DISTANCE_FIELD',
                                          Distance_Field='distance')

Параметры среды

Текущая рабочая область, Выходное ключевое слово конфигурации, Наличие выходных значений M, Выходные данные содержат Z значения

Информация о лицензировании