run

Запустите автоматизацию метки на каждой системе координат в интервале

Описание

run метод вычисляет автоматизированные метки для одной системы координат путем выполнения алгоритма автоматизации. Во время автоматизации приложения для маркировки запускают этот метод в цикле, чтобы вычислить автоматизированные метки для каждой системы координат в автоматизируемом выборе.

Клиенты AutomationAlgorithm должен реализовать этот метод.

autoLabels = run(algObj,frame) обрабатывает один кадр, frame, использование algObj алгоритм автоматизации, и возвращает автоматизированные метки, autoLabels.

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

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

Алгоритм автоматизации в виде vision.labeler.AutomationAlgorithm объект.

Структурируйте, чьи метки вычисляются в виде числовой матрицы для Image сигналы или pointCloud объект для PointCloud сигналы.

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

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

Метки производятся алгоритмом автоматизации, возвращенным как категориальная матрица, массив структур или таблица.

Для алгоритмов, которые автоматизируют пиксельную маркировку, реализуйте run метод, чтобы возвратить autoLabels как a categorical пометьте матрицу, где каждая категория представляет пиксельную метку. Для получения дополнительной информации смотрите Как Магазин приложений Этикетировочной машины Экспортируемые Пиксельные Метки.

Для алгоритмов, которые автоматизируют непиксельные метки, реализуйте run метод, чтобы возвратить массив структур. Каждая структура в массиве содержит метки собственного имени и типа. Метод комбинирует метки того же имени и типа в одну структуру в массиве.

Эта таблица описывает столбцы autoLabels таблица или поля каждого autoLabels структура.

Имя поляОписание
Type

labelType перечисление, которое содержит тип метки. Допустимые типы метки:

  • labelType.Rectangle

  • labelType.Cuboid (Только приложение Ground Truth Labeler)

  • labelType.Line

  • labelType.Scene

NameВектор символов, содержащий имя метки.
Position

Положение меток заданного Name и Type. Формат Position зависит от типа метки.

Маркируйте TypePosition Формат
Rectangle — Прямоугольные метки видимой области (ROI)

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

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

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

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

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

Cuboid — Метки ROI кубоида

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 - ось, соответственно. Эти углы по часовой стрелке положительны при взгляде в прямом направлении их соответствующих осей.

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

ProjectedCuboid Метки ROI кубоида

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

Line — Метки ROI ломаной линии

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

Scene — Метки сцены

Логическое значение 1 если алгоритм решает, что метка присутствует в системе координат и 0 в противном случае.

Attributes (дополнительный)

Массив структур, который содержит одну структуру для каждого атрибута в метке. Если определение метки не содержит атрибуты, то autoLabels выведите не включает это поле.

Для каждой структуры в Attributes массив структур, имя той структуры является именем соответствующего атрибута. Значение структуры является значением соответствующего атрибута.

Просмотреть демонстрационный autoLabels массив структур, введите этот код в командной строке MATLAB®.

autoLabels(1).Name      = 'Car';
autoLabels(1).Type      = labelType.Rectangle;
autoLabels(1).Position  = [20 20 50 50];

autoLabels(2).Name      = 'Truck';
autoLabels(2).Type      = labelType.Rectangle;
autoLabels(2).Position  = [70 70 50 50; 100 100 25 25];

В качестве альтернативы для непиксельных меток, можно использовать run метод, чтобы возвратить autoLabels как таблица. Строки таблицы эквивалентны структурам в массиве структур. Столбцы таблицы эквивалентны полям структуры. Эта таблица эквивалентна демонстрационному autoLabels ранее заданный массив структур.

        Name          Type         Position  
    ____________    _________    ____________

    'Car'           Rectangle    [1x4 double]
    'Truck'         Rectangle    [2x4 double]

Введенный в R2017a