gatherLabelData

Соберите данные о метке из основной истины

Описание

пример

labelData = gatherLabelData(gTruth,typeOfLabel) возвращает данные о метке, собранные в достоверные данные, gTruth. Функция возвращает данные о метке, заданные typeOfLabel.

[labelData,timestamps] = gatherLabelData(___) дополнительно возвращает метки времени изображений, сопоставленные с собранными данными о метке, с помощью аргументов от предыдущего синтаксиса.

[___] = gatherLabelData(___,Name,Value) использование Name,Value парные аргументы, чтобы задать, как собрать данные.

Примеры

свернуть все

Соберите все метки многоугольника от изображения groundtruth.

data = load('groundtruthVisionTeam.mat');
gtruth = data.groundtruthVisionTeam;

Соберите все объекты многоугольника.

labelData = gatherLabelData(gtruth, labelType('Polygon'), 'GroupLabelData', 'LabelType');
 
polygons = labelData{1}.PolygonData{1}(:,1);
polygonLabels = labelData{1}.PolygonData{1}(:,2);

Визуализируйте метки многоугольника.

im = imread('visionteam.jpg');
imshow(im);
showShape('polygon', polygons, 'Label', polygonLabels);

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

свернуть все

Достоверные данные в виде groundTruth объект или вектор из groundTruth объекты.

Пометьте типы, из которых можно собрать данные о метке в виде вектора из labelType объекты. gatherLabelData функция собирает данные о метке из каждого groundTruth объект задан входом gTruth Данные о метке сгруппированы в столбцах или именем метки или типом метки, заданным GroupLabelData аргумент значения имени.

Допустимые перечисляемые типы

Можно задать один или несколько из этих перечисляемых типов.

  • labelType.Rectangle — Прямоугольные метки ROI

  • labelType.Cuboid — ROI кубоида помечает (облака точек)

  • labelType.ProjectedCuboid — Спроектированные метки ROI кубоида (изображения и видеоданные)

  • labelType.Line — Метки ROI линии

  • labelType.PixelLabel — Пиксельные метки ROI

  • labelType.Polygon — Пиксельные метки ROI

  • labelType.Scene — Метки сцены

Чтобы собрать данные о метке для сцен, необходимо задать labelTypes как labelType.Scene скаляр перечисления. Вы не можете задать никакие другие типы метки с labelType.Scene.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: SampleFactor=5 пропускает каждую 5-ю систему координат.

Демонстрационный фактор к поддемонстрационным данным о метке в виде положительного целого числа. Демонстрационный фактор K включает каждый K th система координат. Увеличьте демонстрационный фактор, чтобы исключить избыточные системы координат из сигналов с высокими частотами дискретизации, такими как видео.

Столбцы группы из данных о метке в виде 'LabelName' или 'LabelType'.

  • 'LabelName' — Группирует данные о метке по определениям метки.

  • 'LabelType' — Группирует данные о метке типом метки. Эта опция может использоваться, чтобы собрать данные о метке с порядком размещения видимой области (ROI), сохраненным типом метки.

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

свернуть все

Пометьте данные, возвращенные как M- 1 массив ячеек таблиц, где, M количество groundTruth объекты в gTruth. Столбцы таблиц представляют данные о метке, сгруппированные или именем метки или типом Лабе, заданным GroupLabelData аргумент значения имени.

Для каждой ячейки в таблице формат возвращенных данных о метке зависит от типа метки.

Маркируйте TypeФормат устройства хранения данных для меток в каждой метке времени
labelType.Rectangle

M- 4 числовых матрицы формы [x, y, w, h], где:

  • M количество меток в системе координат.

  • x и y задайте верхний левый угол прямоугольника.

  • w задает ширину прямоугольника, который является его длиной вдоль x - ось.

  • h задает высоту прямоугольника, который является его длиной вдоль y - ось.

labelType.Cuboid

M- 9 числовых матриц со строками формы [xctr, yctr, zctr, xlen, ylen, zlen, xrot, yrot, zrot], где:

  • M количество меток в системе координат.

  • xctr, yctr, и zctr задайте центр кубоида.

  • xlen, ylen, и zlen задайте длину кубоида вдоль x - оси, y - оси, и z - ось, соответственно, прежде чем вращение было применено.

  • xrot, yrot, и zrot задайте углы поворота для кубоида вдоль x - ось, y - ось, и z - ось, соответственно. Эти углы по часовой стрелке положительны при взгляде в прямом направлении их соответствующих осей.

Рисунок показывает, как эти значения определяют положение кубоида.

labelType.ProjectedCuboid

M- 8 векторов из формы [x1, y1, w1, h1, x2, y2, w2, h2], где:

  • M количество меток в системе координат.

  • x1, y1 задает x, координаты y для верхнего левого местоположения передней стороны спроектированного кубоида

  • w1 задает ширину для передней стороны спроектированного кубоида.

  • h1 задает высоту для передней стороны спроектированного кубоида.

  • x2, y2 задает x, координаты y для верхнего левого местоположения задней стороны спроектированного кубоида.

  • w2 задает ширину для задней стороны спроектированного кубоида.

  • h2 задает высоту для задней стороны спроектированного кубоида.

Рисунок показывает, как эти значения определяют положение кубоида.

Labeled projected cuboid

labelType.Line

M- 1 вектор из массивов ячеек, где M количество меток в системе координат. Каждый массив ячеек содержит N- 2 числовых матрицы формы [x1 y1; x2 y2; ... ; xN yN] для N точки в ломаной линии.

labelType.PixelLabel

Данные о метке для всех пиксельных определений метки хранятся в одном M-by-1 PixelLabelData столбец для изображений M или систем координат. Каждый элемент содержит имя файла для пиксельного изображения метки. Пиксельное изображение метки описывает метку или помечает содержавшимся в соответствующем изображении. Метки могут быть описаны как 1-или 3-матриц метки канала. Использовать PixelLabelData с любым из приложений этикетировочной машины необходимо использовать одноканальную матрицу метки, где значения имеют тип uint8. Можно преобразовать матрицу данных о пиксельных метках с 3 каналами в одноканальную матрицу метки программно, чтобы использовать с приложениями этикетировочной машины.

labelType.Polygon

M- 1 вектор из массивов ячеек, где M количество меток. Каждый массив ячеек содержит N- 2 числовых матрицы формы [x1 y1; x2 y2; ... ; xN yN] для N точки в многоугольнике.

labelType.SceneЛогический 1 TRUE) если метка сцены применяется, в противном случае логический 0 ложь)

Метки времени, возвращенные как M- 1 массив ячеек duration векторы, где:

  • M количество groundTruth объекты в gTruth.

  • labelData{m} содержит метки времени, который находится в mth groundTruth объект gTruth.

Ограничения

  • gatherLabelData функция не собирает данные о метке для подметок или атрибутов. Если метка содержит подметки или атрибуты в labelData выведите, функция возвращает положение родительской метки только.

Введенный в R2021a