| Подпись | Описание | Тип данных |
Входные объекты | Линейные 3D-объекты, которые будут использованы для создания точек. | Feature Layer |
Выходной класс объектов | Точечные 3D-объекты, которые будут созданы из входных линий. | Feature Class |
Размещение точек | Указывает метод, который будет использован для выбора точек вдоль линейных 3D-объектов.
| String |
Расстояние (Дополнительный) | Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра Размещение точек задано По расстоянию. | Linear Unit |
Процент (Дополнительный) | Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра Размещение точек задано По процентам. | Double |
Включить конечные точки (Дополнительный) | Задает, добавляются ли дополнительные точки в начале и конце объекта.
| Boolean |
Добавить поля накопленного расстояния и последовательности (Дополнительный) | Указывает, будут ли добавлены поля накопленного расстояния и последовательности к выходным данным.
| Boolean |
Поле расстояния (Дополнительный) | Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра Размещение точек задано По полю расстояния. | Field |
Краткая информация
Создает точечные 3D-объекты вдоль 3D-линий с помощью трехмерных расстояний.
Использование
Этот инструмент создает точечные 3D-объекты вдоль 3D-линий, измеряя расстояние, на котором необходимо создавать точки, с помощью трехмерных расстояний. Если точки, которые выбираются из 3D-линии, необходимо вычислить с помощью двухмерных расстояний вдоль плоскости x-y, используйте вместо него инструмент Создать точки вдоль линий
Точки могут быть расставлены с фиксированным интервалом для всех объектов или вдоль объектов в процентах от их длины. Точки также можно разместить, используя поле ввода; поле может представлять собой фиксированный интервал для каждого объекта или заданные расстояния для каждого объекта.
Используйте параметр Размещение точек, чтобы задать метод, который будет использоваться для размещения выходных точек.
The attributes of the input features will be maintained in the output feature class. A new field, ORIG_FID, will be added to the output feature class and set to the input feature IDs.
Если отмечен параметр Добавить поля накопленного расстояния и последовательности, будут добавлены следующие поля:
- ORIG_LEN— Суммарное расстояние вдоль линии от начальной точки линии до точки. Значения расстояний добавляются в единицах пространственной привязки значения Входные объекты.
- ORIG_SEQ— Порядковый номер для каждой точки в порядке создания точек из каждой входной строки.
Параметры
arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})| Имя | Описание | Тип данных |
in_feature | Линейные 3D-объекты, которые будут использованы для создания точек. | Feature Layer |
out_features | Точечные 3D-объекты, которые будут созданы из входных линий. | Feature Class |
point_placement | Указывает метод, который будет использован для выбора точек вдоль линейных 3D-объектов.
| String |
distance (Дополнительный) | Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра point_placement задано DISTANCE_FIELD. | Linear Unit |
percentage (Дополнительный) | Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра point_placement задано PERCENTAGE. | Double |
include_end_points (Дополнительный) | Задает, добавляются ли дополнительные точки в начале и конце объекта.
| Boolean |
add_chainage_fields (Дополнительный) | Boolean | |
distance_field (Дополнительный) | Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра point_placement задано DISTANCE_FIELD. | Field |
Пример кода
В следующем примере показано использование этого инструмента в окне Python:
import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.GeneratePointsAlong3DLines("hiking_trail.shp", "evaluation_points.shp", "PERCENTAGE"
percentage=5, add_chainage_fields="ADD_CHAINAGE")