Построить точки вдоль 3D-линий (Инструменты 3D Analyst)

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

Создает точечные 3D-объекты вдоль 3D-линий с помощью трехмерных расстояний.

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

Этот инструмент создает точечные 3D-объекты вдоль 3D-линий, измеряя расстояние, на котором необходимо создавать точки, с помощью трехмерных расстояний. Если точки, которые выбираются из 3D-линии, необходимо вычислить с помощью двухмерных расстояний вдоль плоскости x,y, используйте вместо него инструмент Создать точки вдоль линий
Точки могут быть расставлены с фиксированным интервалом для всех объектов или вдоль объектов в процентах от их длины. Точки также можно разместить, используя поле ввода; поле может представлять собой фиксированный интервал для каждого объекта или заданные расстояния для каждого объекта.

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

Подпись	Объяснение	Тип данных
Входные объекты	Линейные 3D-объекты, которые будут использованы для создания точек.	Feature Layer
Выходной класс пространственных объектов	Точечные 3D-объекты, которые будут созданы из входных линий.	Feature Class
Размещение точек (Дополнительный)	Указывает метод, который будет использован для выбора точек вдоль линейных 3D-объектов. By Percentage–The Distance parameter value will be used to place points at fixed distances along the features. This is the default. By Distance–The Percentage parameter value will be used to place points along the features by percentage. By Distance Field–Field values from the Distance Field parameter value will be used to place points along the features.	String
Расстояние (Дополнительный)	Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра Размещение точек задано По расстоянию.	Linear Unit
Процент (Дополнительный)	Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра Размещение точек задано По процентам.	Double
Включить конечные точки (Дополнительный)	Задает, добавляются ли дополнительные точки в начале и конце объекта. Отмечено–Additional points will be included at the start point and end point of the feature. Не отмечено–No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
Добавить поля накопленного расстояния и последовательности (Дополнительный)	Указывает, будут ли добавлены поля накопленного расстояния и последовательности к выходным данным. Отмечено–The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the Input Features parameter value's spatial reference. Не отмечено–The accumulated distance and sequence fields will not be added to the output. This is the default.	Boolean
Поле расстояния (Дополнительный)	Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра Размещение точек задано По полю расстояния.	Field

arcpy.3d.GeneratePointsAlong3DLines(in_features, out_features, {point_placement}, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})

Имя	Объяснение	Тип данных
in_features	Линейные 3D-объекты, которые будут использованы для создания точек.	Feature Layer
out_features	Точечные 3D-объекты, которые будут созданы из входных линий.	Feature Class
point_placement (Дополнительный)	Указывает метод, который будет использован для выбора точек вдоль линейных 3D-объектов. `PERCENTAGE`–The `percentage` parameter value will be used to place points along the features by percentage. `DISTANCE`–The `distance` parameter value will be used to place points at fixed distances along the features. This is the default. `DISTANCE_FIELD`–Field values from the `distance_field` parameter value will be used to place points along the features.	String
distance (Дополнительный)	Интервал от начала объекта, вдоль которого размещаются точки. Это параметр активен, когда для параметра `point_placement` задано `DISTANCE_FIELD`.	Linear Unit
percentage (Дополнительный)	Процент от начала объекта, вдоль которого размещаются точки. Например, если используется процентное соотношение 40, точки будут расположены на расстоянии в 40 и 80 процентов от длины объекта. Это параметр активен, когда для параметра `point_placement` задано `PERCENTAGE`.	Double
include_end_points (Дополнительный)	Задает, добавляются ли дополнительные точки в начале и конце объекта. `END_POINTS`–Additional points will be included at the start point and end point of the feature. `NO_END_POINTS`–No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
add_chainage_fields (Дополнительный)	Указывает, будут ли добавлены поля накопленного расстояния и последовательности к выходным данным. `ADD_CHAINAGE`–The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the `in_features` parameter value's spatial reference. `NO_CHAINAGE`–The accumulated distance and sequence fields will not be added to the output. This is the default.	Boolean
distance_field (Дополнительный)	Поле из входных объектов, которое будет использоваться для размещения выходных точек. Если поле имеет числовой тип, то значение поля будет использоваться для размещения точек на этом интервале. Если поле относится к строковому типу, значения поля должны быть организованы в виде строки расстояний, разделенных точкой с запятой. Точки будут расставлены на этих расстояниях. Нулевые или отрицательные значения полей будут проигнорированы. Значения полей, превышающие длину объекта, будут проигнорированы для этого объекта. Расстояния будут указаны в линейных единицах пространственной привязки входных данных. Это параметр активен, когда для параметра `point_placement` задано `DISTANCE_FIELD`.	Field

Пример кода

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

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

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

Текущая рабочая область, Выходная система координат, Географические преобразования, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Экстент

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