run

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

Описание

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

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

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

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

расширить все

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

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

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

расширить все

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

Для алгоритмов, которые автоматизируют маркировку пикселей, реализуйте run метод для возврата autoLabels как categorical матрица меток, где каждая категория представляет пиксельную метку. Для получения дополнительной информации см. раздел «Как приложения Labeler хранят экспортированные метки».

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

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

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

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

  • labelType.Rectangle

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

  • labelType.ProjectedCuboid

  • labelType.Line

  • labelType.Scene

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

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

Тип меткиPosition Формат
Rectangle - Интересующая прямоугольная область ( ROI) меток

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

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

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

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

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

Cuboid - Кубоидные метки информация только для чтения

M-by-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 - Кубоидные метки информация только для чтения

M-by-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-by-1 вектор массивов ячеек, где M - количество меток в системе координат. Каждый массив ячеек содержит N-by-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