Exponenta Banner
exponenta event banner

bboxwarp

Применение геометрического преобразования к ограничивающим рамкам

свернуть все на странице

Синтаксис

baseB = bboxwarp (baseA, tform, ref)
[baseB, индексы] = bboxwarp (baseA, tform, ref)
[___] = bboxwarp (___, «Пороговое значение», пороговое значение)

Описание

пример

bboxB = bboxwarp(bboxA,tform,ref) преобразует ограничивающие рамки в bboxA в соответствии с геометрическим преобразованием, определенным tform. Ограничивающими прямоугольниками могут быть выровненные по оси прямоугольники, повернутые прямоугольники или кубоиды. Объект пространственной ссылки, refопределяет вид вывода, в который преобразуются поля.

[bboxB,indices] = bboxwarp(bboxA,tform,ref) дополнительно возвращает вектор индексов, указывающих, какие ограничивающие рамки в bboxA соответствуют деформированным версиям в выходных данных, bboxB.

[___] = bboxwarp(___,'OverlapThreshold',threshold) дополнительно устанавливает порог перекрытия.

Примеры

свернуть все

Открыть сценарий в реальном времени

Прочтите изображение.

I = imread('peppers.png');

Определите ограничивающие рамки и метки.

bboxA = [
    410 230 100 90
    186 78  80  60
    ]
bboxA = 2×4

   410   230   100    90
   186    78    80    60


labelsA = [
    "garlic"
    "onion"
    ];

Определите преобразование для горизонтального разворота и перемещения изображения.

tform = affine2d([-1 0 0; 0 1 0; 50 50 1]);

Создание выходного представления для imwarp.

rout = affineOutputView(size(I),tform);

Деформируйте изображение.

J = imwarp(I,tform,'OutputView',rout);

Деформируйте коробки.

[bboxB,indices] = bboxwarp(bboxA,tform,rout);
labelsB = labelsA(indices);

Просмотрите результаты.

annotatedI = insertObjectAnnotation(I,'Rectangle',bboxA,labelsA);
annotatedJ = insertObjectAnnotation(J,'Rectangle',bboxB,labelsB);
figure
montage({annotatedI, annotatedJ})

Figure contains an axes. The axes contains an object of type image.

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

свернуть все

Ограничивающие рамки, заданные как M-by-4, M-by-5 или M-by-9 непарабельная числовая матрица M ограничивающих рамок. Каждая строка матрицы M определяет ограничивающую рамку как прямоугольник, выровненный по оси, прямоугольник поворота или кубоид. В таблице ниже описан формат ограничивающих рамок.

Ограничивающая рамкаОписание
Выровненный по оси прямоугольник

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

  • M - количество выровненных по оси прямоугольников.

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

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

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

Повернутый прямоугольник

Определяется в пространственных координатах как M-by-5 числовая матрица со строками вида [xctr yctr xlen ylen yaw ], где:

  • M - число повернутых прямоугольников.

  • xctr и yctr указывают центр прямоугольника.

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

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

  • угол поворота в градусах. Вращение по часовой стрелке - положительное вокруг центра ограничивающей рамки.

Square rectangle rotated by -30 degrees.

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 соответственно. Углы поворота xrot, yrot и zrot находятся в градусах относительно кубовидного центра. Каждое вращение является положительным по часовой стрелке относительно положительного направления соответствующей пространственной оси. Функция вычисляет матрицы вращения, предполагая, что ZYX упорядочить углы Эйлера [xrot yrot zrot].

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

Геометрическое преобразование, указанное в affine2d объект. Функция bboxwarp поддерживает только аффинные преобразования масштаба, поворота и перемещения.

Пространственная ссылка, указанная как imref2d объект, возвращенный imwarp или affineOutputView функция. Объект определяет окно вывода для преобразования. Поля, которые полностью преобразованы вне выходного представления, определенного ref отбрасываются.

[J,rout] = imwarp(I,tform);
[bboxB,indices] = bboxwarp(bboxA,tform,rout);

rout = affineOutputView(size(I),tform)
J = imwarp(I,tform,'OutputView',rout);
[bboxB,indices] = bboxwarp(bboxA,tform,rout);

Порог перекрытия, заданный как положительный скаляр, меньший или равный 1. Величина перекрытия между преобразованными полями и областью, определенной видом вывода, определяется следующим образом:

площадь (bbox пересекает ограничивающий прямоугольник )/площадь (bbox)

  • ограничивающий прямоугольник - определяется входным пространственным опорным объектом, ref.

  • bbox - Результат преобразования полей в bboxA.

Если вычисленное значение перекрытия больше значения threshold затем преобразованные поля обрезаются до границы ограничивающего прямоугольника. В противном случае ящики отбрасываются. Снижение порога может привести к тому, что части объекта будут отброшены.

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

свернуть все

Деформированные ограничивающие рамки, возвращаемые в виде матрицы M2-by-N M2 ограничивающих рамок. Количество возвращаемых ограничивающих рамок меньше количества ограничивающих рамок на входе. Каждая строка M2 матрицы определяет одну ограничительную рамку того же типа, что и входные данные. bboxA.

Индексы, возвращаемые как вектор целых чисел. Индексы указывают, какие ограничивающие рамки находятся на входе, bboxA, которые соответствуют искаженным версиям в выходных данных, bboxB.

См. также

| | | |

Представлен в R2019b

Документация по инструментарию компьютерного зрения

Поддержка