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

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

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

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

Точки могут быть расставлены с фиксированным интервалом для всех объектов или вдоль объектов в процентах от их длины. Точки также можно разместить, используя поле ввода; поле может представлять собой фиксированный интервал для каждого объекта или заданные расстояния для каждого объекта.
Используйте параметр Размещение точек, чтобы задать метод, который будет использоваться для размещения выходных точек.
Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле 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')

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

Текущая рабочая область, Выходное ключевое слово CONFIG, Выходные данные имеют M-значения, Выходные данные имеют Z-значения

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

Basic: Да
Standard: Да
Advanced: Да

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

Отзыв по этому разделу?