pointCloud

Объект для хранения 3-D облака точек

Описание

pointCloud объект создает данные об облаке точек из набора точек в 3-D системе координат. Данные об облаке точек хранятся как объект со свойствами, перечисленными в Свойствах. Используйте Функции объекта, чтобы получить, выбрать и удалить желаемые точки из данных об облаке точек.

Создание

Описание

ptCloud = pointCloud(xyzPoints) возвращает объект облака точек с координатами, заданными xyzPoints.

ptCloud = pointCloud(xyzPoints,Name,Value) создает pointCloud объект со свойствами, заданными как один или несколько Name,Value парные аргументы. Например, pointCloud(xyzPoints,'Color',[0 0 0]) устанавливает Color свойство точки xyzPoints как [0 0 0]. Заключите каждое имя свойства в кавычки. Любые незаданные свойства имеют значения по умолчанию.

Входные параметры

развернуть все

3-D координата указывает в виде M-by-3 список точек или M-by-N-by-3 массив для организованного облака точек. 3-D координатные точки задают x, y и положения z точки в 3-D координатном пространстве. Первые две размерности организованного облака точек соответствуют порядку сканирования от датчиков, таких как RGBD или лидар. Этот аргумент устанавливает Location свойство.

Типы данных: single | double

Выходные аргументы

развернуть все

Облако точек, возвращенное как pointCloud объект со свойствами, перечисленными в Свойствах.

Свойства

развернуть все

Это свойство доступно только для чтения.

Положение точек в 3-D координатном пространстве в виде M-by-3 или M-by-N-by-3 массив. Каждая запись задает x, y и координаты z точки в 3-D координатном пространстве. Вы не можете установить это свойство как пару "имя-значение". Используйте xyzPoints входной параметр.

Типы данных: single | double

Цвет облака точек в виде M-by-3 или M-by-N-by-3 массив. Используйте это свойство выбрать цвет точек в облаке точек. Каждая запись задает цвет RGB точки в данных об облаке точек. Поэтому можно задать тот же цвет для всех точек или различный цвет для каждой точки.

  • Заданные значения RGB должны лечь в области значений [0, 1], когда вы задаете тип данных для Color как single или double.

  • Заданные значения RGB должны лечь в области значений [0, 255], когда вы задаете тип данных для Color как uint8.

КоординатыДопустимое присвоение Color
M-by-3 массивM-by-3 массив, содержащий значения RGB для каждой точки
M-by-N-by-3 массивM-by-N-by-3 массив, содержащий значения RGB для каждой точки

Типы данных: uint8

Поверхностные нормали в виде M-by-3 или M-by-N-by-3 массив. Используйте это свойство задать вектор нормали относительно каждой точки в облаке точек. Каждая запись в поверхностных нормалях задает x, y и компонент z вектора нормали.

КоординатыПоверхностные нормали
M-by-3 массивM-by-3 массив, где каждая строка содержит соответствующий вектор нормали.
M-by-N-by-3 массивM-by-N-by-3 массив, содержащий 1 1 3 векторами нормали для каждой точки.

Типы данных: single | double

Полутоновая интенсивность в каждой точке в виде M-by-1 вектор или M-by-N матрица. Функция сопоставляет каждое значение интенсивности со значением цвета в текущей палитре.

КоординатыИнтенсивность
M-by-3 массивM-by-1 вектор, где каждая строка содержит соответствующее значение интенсивности.
M-by-N-by-3 массивM-by-N матрица, содержащая значение интенсивности для каждой точки.

Типы данных: single | double | uint8

Это свойство доступно только для чтения.

Число точек в облаке точек, сохраненном как положительное целое число.

Это свойство доступно только для чтения.

Область значений координат вдоль x - ось, сохраненная как вектор 1 на 2.

Это свойство доступно только для чтения.

Область значений координат вдоль y - ось, сохраненная как вектор 1 на 2.

Это свойство доступно только для чтения.

Область значений координат вдоль z - ось, сохраненная как вектор 1 на 2.

Функции объекта

findNearestNeighborsНайдите самых близких соседей точки в облаке точек
findNeighborsInRadiusНайдите соседей в радиусе точки в облаке точек
findPointsInROIНайдите точки в необходимой области в облаке точек
removeInvalidPointsУдалите недопустимые точки из облака точек
selectВыберите точки в облаке точек
copyСкопируйте массив объектов указателя

Советы

pointCloud объектом является handle объект. Если вы хотите создать отдельную копию облака точек, можно использовать MATLAB® copy метод.

ptCloudB = copy(ptCloudA)

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

ptCloud = pcFunction (ptCloud)

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Смотрите также

Функции

Введенный в R2020b