Извлечь объекты из облака точек (Инструменты 3D Analyst)

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

Извлекает отдельные объекты из классифицированного облака точек в точечные, полигональные или мультипатч-объекты.

Иллюстрация

Иллюстрация инструмента Извлечение объектов из облака точек

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

Этот инструмент использует расстояние кластеризации, чтобы определить, какие точки принадлежат одному и тому же объекту. Если несколько кодов классов потенциально могут представлять один и тот же объект, назначьте общий идентификатор группы, который будет связывать коды классов во время операции кластеризации. Например, точкам большого дерева могут быть присвоены коды классов 3, 4 или 5. Трем кодам классов может быть присвоен общий идентификатор группы, чтобы обеспечить правильную идентификацию дерева.
Извлечение объектов предлагает количественный набор данных, который можно использовать для создания инвентаризации активов, которую можно визуализировать на карте или сцене. 3D-формы, созданные с помощью этого инструмента, могут помочь в оценке видимости или воздействия тени. Упрощенные геометрические представления также могут стать полезной картографической абстракцией для визуализации объектов в объемных облаках точек.
Используйте параметр Минимальное число точек, чтобы исключить объекты, определяемые небольшим количеством точек, которые могут не давать значимых выходных данных.
При использовании опции Вогнутая 2D-оболочка или Вогнутая 3D-оболочка для параметра Тип выходной геометрии альфа-радиус для определения выходной геометрии может быть вычислен либо для каждого объекта, либо для всех объектов может использоваться один и тот же альфа-радиус. Вычисление альфа-радиуса для каждого объекта может быть полезно при извлечении нескольких объектов с сильно отличающимися характеристиками. При применении одинакового альфа-радиуса ко всем объектам укажите желаемый радиус, используя параметр Альфа-радиус. Если значение не задано, радиус, используемый для параметра Вогнутая 2D-оболочка, будет таким же, как значение параметра Расстояние кластеризации. При использовании опции Вогнутая 3D-оболочка радиус будет получен путем деления значения параметра Расстояние кластеризации на значение параметра Масштабный коэффициент вертикальной кластеризации, если масштабный коэффициент больше 0. Если масштабный коэффициент равен 0, будет создана выпуклая оболочка.
Выходные объекты будут иметь следующие атрибуты:
- ObjectCode—Код класса или ID группы, используемый для идентификации типа объекта.
- COUNT—Число точек, связанных с объектом.
- ALPHA—Альфа-радиус, используемый для построения выходной формы. Это поле добавляется только в том случае, если параметру Тип выходной геометрии присвоено значение Вогнутая 2D-оболочка или Вогнутая 3D-оболочка.
Следующие атрибуты добавляются только для полигонального типа геометрии:
- MIN_Z—Наименьшее значение z для точек, принадлежащих объекту.
- MAX_Z—Наибольшее значение z для точек, принадлежащих объекту.
Такие атрибуты, как площадь поверхности и объем, могут быть вычислены для выходных данных мультипатч с помощью инструмента Добавить информацию Z.

Подпись	Объяснение	Тип данных
Входное облако точек	Классифицированный набор данных LAS, пакет слоев сцены облака точек или сервис I3S облака точек, которые будут использоваться для обнаружения объектов.	LAS Dataset Layer; Scene Layer; File
Коды классов для извлечения	Коды классов, которые будут обрабатываться для идентификации объектов. Общий идентификатор группы может быть назначен для группировки нескольких кодов классов в один и тот же объект. Столбцы таблицы значений: Class Code–The class code value that will be used to identify objects. This number can be any value from 0 to 255. Group ID–The group ID that will be used to combine multiple class codes. This number can be any value from 0 to 255.	Value Table
Расстояние кластеризации	Трехмерное расстояние, которое будет использоваться для идентификации точек, принадлежащих одному и тому же объекту.	Linear Unit
Выходные объекты	Выходные объекты, геометрией которых могут быть точки, полигоны или объекты-мультипатч, в зависимости от значения параметра Тип выходной геометрии.	Feature Class
Тип выходной геометрии (Дополнительный)	Задает тип геометрии, которая будет создана для каждого объекта. Указанный тип будет определять, будут ли объекты представлены в виде точек, полигонов или объектов-мультипатчей. Centerpoint–Three-dimensional points will be generated that represent each object with a point that is created approximately in the middle of the object's convex hull. Bounding Circle–Two-dimensional polygons will be generated that represent each object with the minimum bounding circle that surrounds its points. 2D Bounding Box–Two-dimensional polygons will be generated that represent each object with the smallest oriented bounding box that contains its points. 2D Convex Hull–Two-dimensional polygons will be generated that represent each object with the convex hull that contains its points. 2D Concave Hull–Two-dimensional polygons will be generated that represent each object with a concave hull that encompasses its points. Bounding Sphere–Multipatch features will be generated that represent each object with a minimum bounding sphere that encompasses its points. 3D Bounding Box–Multipatch features will be generated that represent each object with the smallest oriented bounding box that contains its points. 3D Convex Hull–Multipatch features will be generated that represent each object with the convex hull that surrounds its points. This is the default. 3D Concave Hull–Multipatch features will be generated that represent each object with the concave hull that surrounds its points. This option approximates the closest fitting geometry that can be generated from the points.	String
Минимальное число точек (Дополнительный)	Минимальное количество точек, которое должен иметь объект, чтобы формировать выходные данные. Значением по умолчанию является 10.	Long
Масштабный коэффициент вертикальной кластеризации	Масштабный коэффициент, который будет применен к значениям z, что влияет на то, как применяется расстояние кластеризации вдоль оси z и как точки группируются в объекты. Значение по умолчанию равно 1, допустимые значения варьируются от 0.0 до 10.0. Масштабный коэффициент, равный 0, приведет к двумерной кластеризации; масштабный коэффициент меньше 1, но больше 0, приведет к большему z-диапазону для каждого объекта. Аналогично, коэффициент масштабирования по вертикали, превышающий 1, приведет к тому, что точки вдоль оси z будут сгруппированы на более коротком расстоянии. Коэффициент вертикального масштабирования применяется только к группировке точек. Геометрия точек не будет изменена, и z-единицы измерения изменены не будут.	Double
Вычислить уникальный альфа-радиус для каждого объекта (Дополнительный)	Задает, будет ли альфа-радиус вычисляться для каждого объекта или один и тот же альфа-радиус будет применен ко всем объектам. Этот параметр включается только если параметру Тип выходной геометрии присвоено значение Вогнутая 2D-оболочка или Вогнутая 3D-оболочка. Отмечено–A unique alpha radius will be calculated for each object. Не отмечено–The same alpha radius will be used for all objects. When this option is specified, the Alpha Radius parameter can be used to define this value. If no value is specified, an alpha radius will be calculated for the entire dataset. This is the default.	Boolean
Альфа-радиус (Дополнительный)	Альфа-радиус, который будет использоваться для определения альфа-формы при построении объектов элемента. Этот параметр применяется, когда параметр Вычислять уникальный альфа-радиус для каждого объекта выключен, а параметру Тип выходной геометрии присвоено значение Вогнутая 2D-оболочка или Вогнутая 3D-оболочка. Больший альфа-радиус создаст более унифицированный элемент объекта с более простыми границами до точки достижения выпуклой оболочки, в то время как меньшие значения позволят охватить точки объекта с большей детализацией, а также увеличат вероятность построения несвязанных частей. Если альфа-радиус не задан, его значение выводится по значениям параметров Расстояние кластеризации и Масштабный коэффициент вертикальной кластеризации. См. раздел Использование в справке по инструменту для получения дополнительной информации о том, как вычисляется альфа-радиус по умолчанию.	Linear Unit
Поверхность минимальной высоты (Дополнительный)	Поверхность минимальной высоты, которая будет использоваться для фильтрации объектов по высоте. В выходных данных будут представлены только те точки, которые находятся выше этой поверхности.	Raster Layer
Поверхность максимальной высоты (Дополнительный)	Поверхность максимальной высоты, которая будет использоваться для фильтрации выходных данных. В выходных данных будут представлены только те точки, которые находятся ниже этой поверхности.	Raster Layer

arcpy.3d.ExtractObjectsFromPointCloud(in_point_cloud, class_codes_to_extract, clustering_distance, out_features, {geometry_type}, {min_points}, vertical_scale_factor, {alpha_calculation}, {alpha_radius}, {min_height}, {max_height})

Имя	Объяснение	Тип данных
in_point_cloud	Классифицированный набор данных LAS, пакет слоев сцены облака точек или сервис I3S облака точек, которые будут использоваться для обнаружения объектов.	LAS Dataset Layer; Scene Layer; File
class_codes_to_extract [class_codes_to_extract,...]	Коды классов, которые будут обрабатываться для идентификации объектов. Общий идентификатор группы может быть назначен для группировки нескольких кодов классов в один и тот же объект. Столбцы таблицы значений: `Class Code`–The class code value that will be used to identify objects. This number can be any value from 0 to 255. `Group`–The group ID that will be used to combine multiple class codes. This number can be any value from 0 to 255.	Value Table
clustering_distance	Трехмерное расстояние, которое будет использоваться для идентификации точек, принадлежащих одному и тому же объекту.	Linear Unit
out_features	Выходные объекты, геометрией которых могут быть точки, полигоны или объекты-мультипатч, в зависимости от значения параметра `geometry_type`.	Feature Class
geometry_type (Дополнительный)	Задает тип геометрии, которая будет создана для каждого объекта. Указанный тип будет определять, будут ли объекты представлены в виде точек, полигонов или объектов-мультипатчей. `CENTERPOINT`–Three-dimensional points will be generated that represent each object with a point that is created approximately in the middle of the object's convex hull. `BOUNDING_CIRCLE`–Two-dimensional polygons will be generated that represent each object with the minimum bounding circle that surrounds its points. `BOUNDING_BOX_2D`–Two-dimensional polygons will be generated that represent each object with the smallest oriented bounding box that contains its points. `CONVEX_HULL_2D`–Two-dimensional polygons will be generated that represent each object with the convex hull that contains its points. `CONCAVE_HULL_2D`–Two-dimensional polygons will be generated that represent each object with a concave hull that encompasses its points. `BOUNDING_SPHERE`–Multipatch features will be generated that represent each object with a minimum bounding sphere that encompasses its points. `BOUNDING_BOX_3D`–Multipatch features will be generated that represent each object with the smallest oriented bounding box that contains its points. `CONVEX_HULL_3D`–Multipatch features will be generated that represent each object with the convex hull that surrounds its points. This is the default. `CONCAVE_HULL_3D`–Multipatch features will be generated that represent each object with the concave hull that surrounds its points. This option approximates the closest fitting geometry that can be generated from the points.	String
min_points (Дополнительный)	Минимальное количество точек, которое должен иметь объект, чтобы формировать выходные данные. Значением по умолчанию является 10.	Long
vertical_scale_factor	Масштабный коэффициент, который будет применен к значениям z, что влияет на то, как применяется расстояние кластеризации вдоль оси z и как точки группируются в объекты. Значение по умолчанию равно 1, допустимые значения варьируются от 0.0 до 10.0. Масштабный коэффициент, равный 0, приведет к двумерной кластеризации; масштабный коэффициент меньше 1, но больше 0, приведет к большему z-диапазону для каждого объекта. Аналогично, коэффициент масштабирования по вертикали, превышающий 1, приведет к тому, что точки вдоль оси z будут сгруппированы на более коротком расстоянии. Коэффициент вертикального масштабирования применяется только к группировке точек. Геометрия точек не будет изменена, и z-единицы измерения изменены не будут.	Double
alpha_calculation (Дополнительный)	Задает, будет ли альфа-радиус вычисляться для каждого объекта или один и тот же альфа-радиус будет применен ко всем объектам. Этот параметр включается только, когда для параметра `geometry_type` задано значение `CONCAVE_HULL_2D` или `CONCAVE_HULL_3D`. `PER_OBJECT`–A unique alpha radius will be calculated for each object. `ALL_OBJECTS`–The same alpha radius will be used for all objects. When this option is specified, the `alpha_radius` parameter can be used to define this value. If no value is specified, an alpha radius will be calculated for the entire dataset. This is the default.	Boolean
alpha_radius (Дополнительный)	Альфа-радиус, который будет использоваться для определения альфа-формы при построении объектов элемента. Этот параметр применяется, когда для параметра `alpha_calculation` задано значение `ALL_OBJECTS`, а для параметра `geometry_type` задано `CONCAVE_HULL_2D` или `CONCAVE_HULL_3D`. Больший альфа-радиус создаст более унифицированный элемент объекта с более простыми границами до точки достижения выпуклой оболочки, в то время как меньшие значения позволят охватить точки объекта с большей детализацией, а также увеличат вероятность построения несвязанных частей. Если альфа-радиус не задан, его значение выводится по значениям параметров `clustering_distance` и `vertical_clustering_scale_factor`. См. раздел Использование в справке по инструменту для получения дополнительной информации о том, как вычисляется альфа-радиус по умолчанию.	Linear Unit
min_height (Дополнительный)	Поверхность минимальной высоты, которая будет использоваться для фильтрации объектов по высоте. В выходных данных будут представлены только те точки, которые находятся выше этой поверхности.	Raster Layer
max_height (Дополнительный)	Поверхность максимальной высоты, которая будет использоваться для фильтрации выходных данных. В выходных данных будут представлены только те точки, которые находятся ниже этой поверхности.	Raster Layer

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python:

import arcpy
arcpy.env.workspace = r"C:/GIS_Data"
arcpy.ddd.ExtractObjectsFromPointCloud("Terrestrial_Scan.lasd", [(4, 5), (5, 5)],
                                       "60 Centimeters", "Trees.shp",
                                       "CONCAVE_HULL_2D", 50)

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

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

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

Basic: Требуется 3D Analyst
Standard: Требуется 3D Analyst
Advanced: Требуется 3D Analyst