visionhdl.ImageFilter

2D КИХ-фильтрация

Описание

visionhdl.ImageFilter выполняет двумерную фильтрацию конечной импульсной характеристики (FIR) на пиксельном потоке. Это поддерживает использование программируемых коэффициентов фильтра.

Примечание

Запуск в R2016b, вместо того, чтобы использовать step метод, чтобы выполнить операцию, заданную Системой object™, можно вызвать объект с аргументами, как будто это была функция. Например, y = step(obj,x) и y = obj(x) выполните эквивалентные операции.

Конструкция

F = visionhdl.ImageFilter возвращает Системный объект, F, это выполняет двумерную КИХ-фильтрацию на потоке входного пикселя.

F = visionhdl.ImageFilter(Name,Value) возвращается 2D КИХ фильтруют Системный объект, F, с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы. Name имя свойства и Value соответствующее значение. Name должен появиться в одинарных кавычках (''). Можно задать несколько аргументов пары "имя-значение" в любом порядке как Name1,Value1,...,NameN,ValueN. Свойства, не заданные, сохраняют свои значения по умолчанию.

F = visionhdl.ImageFilter(coeff,lineSize,Name,Value) возвращается 2D КИХ фильтруют Системный объект, F, с Coefficients набор свойств к coeff, LineBufferSize свойство к lineSize, и дополнительные опции заданы одним или несколькими Name,Value парные аргументы.

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

`coeff`	Отфильтруйте коэффициенты в виде матрицы. Каждая размерность матрицы должна иметь по крайней мере 2 элемента и не больше, чем 64 элемента. Этот аргумент устанавливает Содействующее значение свойства.
`lineSize`	Размер буфера памяти линии в виде степени двойки, которая размещает количество активных пикселей в горизонтальной линии. Этот аргумент устанавливает `LineBufferSize` значение свойства.

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

`F`	`visionhdl.ImageFilter` Системный объект

Свойства

`CoefficientsSource`	Выберите источник для определения коэффициентов фильтра. `'Property'` (значение по умолчанию) — Выбор это значение, чтобы задать коэффициенты фильтра с помощью `Coefficients` свойство. `'Input port'` — Выберите это значение, чтобы задать коэффициенты фильтра с помощью `coeff` аргумент.
`Coefficients`	Коэффициенты фильтра в виде матрицы. Каждая размерность матрицы должна иметь по крайней мере 2 элемента и не больше, чем 64 элемента. Это свойство применяется, когда вы устанавливаете `CoefficientsSource` к `'Property'`. `double` и `single` типы данных поддерживаются для симуляции, но не для генерации HDL-кода. Значение по умолчанию: `[1,0;0,-1]`
`PaddingMethod`	Выберите один из этих методов для дополнения контура входного изображения. `'Constant'` — Интерпретируйте пиксели вне фрейма изображения как наличие постоянного значения. `'Replicate'` — Повторите значение пикселей в ребре изображения. `'Symmetric'` — Установите значение дополнительных пикселей, чтобы зеркально отразить ребро изображения. `'None'` — Исключите дополнительную логику. Объект не устанавливает пиксели вне фрейма изображения ни к какому конкретному значению. Эта опция уменьшает аппаратные ресурсы, используемые объектом и очищением, требуемым между системами координат, но влияет на точность выходных пикселей в ребрах системы координат. Чтобы обеспечить пиксельную потоковую синхронизацию, выходная система координат одного размера с входным кадром. Однако избегать использования пикселей, вычисленных от неопределенных дополнительных значений, маски от KernelSize/2 пиксели вокруг ребра системы координат для нисходящих операций. Для получения дополнительной информации смотрите Пропускную способность Увеличения с Дополнением Ни одного. Для получения дополнительной информации об этих методах, смотрите, что Ребро Дополняет. Значение по умолчанию: `'Constant'`
`PaddingValue`	Постоянное значение раньше заполняло контур входного изображения. Это свойство применяется, когда вы устанавливаете `PaddingMethod` к `'Constant'`. Объект бросает это значение к совпадающему типу данных как входной пиксель. Значение по умолчанию: 0
`LineBufferSize`	Задайте степень двойки, которая размещает количество активных пикселей в одной горизонтальной линии. Выберите степень двойки, которая размещает количество активных пикселей в горизонтальной линии. Если вы задаете значение, которое не является степенью двойки, объект использует следующую самую большую степень двойки. Объект выделяет (coefficient rows – 1)-by-`LineBufferSize` ячейки памяти, чтобы сохранить пиксели. Значение по умолчанию: 2048
`CoefficientsDataType`	Выберите метод для определения типа данных коэффициентов фильтра. Это свойство применяется, когда вы устанавливаете `CoefficientsSource` к `'Property'`. `'Same as first input'`'(значение по умолчанию) — Наборы тип данных коэффициентов, чтобы совпадать с типом данных `pixelIn` аргумент `step` метод. `'custom'` — Устанавливает тип данных коэффициентов совпадать с типом данных, заданным в `CustomCoefficientsDataType` свойство. При преобразовании коэффициентов в заданный тип данных объект округляется к самому близкому представимому значению и насыщает на переполнении.
`CustomCoefficientsDataType`	Тип данных для коэффициентов фильтра в виде `numerictype(signed,WL,FL)`, где WL является размером слова, и FL является дробной длиной в битах. Это свойство применяется, когда вы устанавливаете `CoefficientsDataType` к `'custom'`. Значение по умолчанию: `numerictype(true,16,15)`
`OutputDataType`	Выберите метод для определения типа данных выходных пикселей. `'Same as first input'` (значение по умолчанию) — Наборы тип данных выходных пикселей, чтобы совпадать с типом данных `pixelIn` аргумент `step` метод. `'full precision'` — Вычисляет типы внутренних и выходных данных, использующие правила полной точности. Эти правила обеспечивают точные численные данные фиксированной точки и предотвращают квантование в объекте. Биты добавляются, по мере необходимости, чтобы предотвратить округление и переполнение. `'custom'` — Устанавливает тип данных выходных пикселей совпадать с типом данных, который вы задаете в `CustomOutputDataType` свойство.
`CustomOutputDataType`	Тип данных для выходных пикселей в виде `numerictype(signed,WL,FL)`, где WL является размером слова, и FL является дробной длиной в битах. Это свойство применяется только, когда вы устанавливаете `OutputDataType` к `custom`. Значение по умолчанию: `numerictype(true,8,0)`
`OverflowAction`	Действие переполнения используется в операциях фиксированной точки. Объект использует вычисления с фиксированной точкой во внутренних вычислениях, когда вход является любым целым числом или типом данных с фиксированной точкой. Эта опция не применяется, когда типом входных данных является `single` или `double`. Значение по умолчанию: `Wrap`
`RoundingMethod`	Режим Rounding используется в операциях фиксированной точки. Объект использует вычисления с фиксированной точкой во внутренних вычислениях, когда вход является любым целым числом или типом данных с фиксированной точкой. Эта опция не применяется, когда типом входных данных является `single` или `double`. Значение по умолчанию: `Floor`

Методы

шаг	2D КИХ-фильтрация

Характерный для всех системных объектов
`release`	Позвольте изменения значения свойства Системного объекта

Примеры

свернуть все

Отфильтруйте пиксельный поток

Этот пример использует:

Скрипт Open Live Script

Этот пример реализует 2D фильтр размытия на изображении миниатюр.

Загрузите исходное изображение из файла. Выберите фрагмент изображения, совпадающего с желаемым тестовым размером.

frmOrig = imread('rice.png');
frmActivePixels = 64;
frmActiveLines = 48;
frmInput = frmOrig(1:frmActiveLines,1:frmActivePixels);
figure
imshow(frmInput,'InitialMagnification',300)
title 'Input Image'

Создайте сериализатор, возражают и задают размер неактивных пиксельных областей.

frm2pix = visionhdl.FrameToPixels(...
      'NumComponents',1,...
      'VideoFormat','custom',...
      'ActivePixelsPerLine',frmActivePixels,...
      'ActiveVideoLines',frmActiveLines,...
      'TotalPixelsPerLine',frmActivePixels+10,...
      'TotalVideoLines',frmActiveLines+10,...
      'StartingActiveLine',6,...     
      'FrontPorch',5);

Создайте объект фильтра.

 filt2d = visionhdl.ImageFilter(...
          'Coefficients',ones(2,2)/4,...
          'CoefficientsDataType','Custom',...
          'CustomCoefficientsDataType',numerictype(0,1,2),...
          'PaddingMethod','Symmetric');

Сериализируйте тестовое изображение путем вызова объекта сериализатора. pixIn вектор значений интенсивности. ctrlIn вектор структур управляющего сигнала.

Примечание: Этот объектный синтаксис запускается только в R2016b или позже. Если вы используете более ранний релиз, заменяете каждый вызов объекта с эквивалентным step синтаксис. Например, замените myObject(x) с step(myObject,x).

[pixIn,ctrlIn] = frm2pix(frmInput);

Подготовьтесь обрабатывать пиксели путем предварительного выделения выходных векторов.

[~,~,numPixelsPerFrame] = getparamfromfrm2pix(frm2pix);
pixOut = zeros(numPixelsPerFrame,1,'uint8');
ctrlOut  = repmat(pixelcontrolstruct,numPixelsPerFrame,1);

Для каждого пикселя в заполненной системе координат вычислите отфильтрованное значение. Контролируйте управляющие сигналы определить задержку объекта. Задержка настройки фильтра зависит от:

Количество активных пикселей в линии.
Размер ядра фильтра.
Оптимизация симметричных или дублирующихся коэффициентов.

foundValIn = false;
foundValOut = false;
for p = 1:numPixelsPerFrame  
    if (ctrlIn(p).valid && foundValIn==0)
        foundValIn = p;
    end
    [pixOut(p),ctrlOut(p)] = filt2d(pixIn(p),ctrlIn(p));
    if (ctrlOut(p).valid && foundValOut==0)
        foundValOut = p;
    end
end
sprintf('object latency is %d cycles',foundValOut-foundValIn)

ans = 
'object latency is 101 cycles'

Создайте объект deserializer с форматом, совпадающим с тем из сериализатора. Преобразуйте пиксельный поток во фрейм изображения путем вызова объекта deserializer. Отобразите получившееся изображение.

pix2frm = visionhdl.PixelsToFrame(...
      'NumComponents',1,...
      'VideoFormat','custom',...
      'ActivePixelsPerLine',frmActivePixels,...
      'ActiveVideoLines',frmActiveLines);
[frmOutput,frmValid] = pix2frm(pixOut,ctrlOut);
if frmValid
    figure
    imshow(frmOutput, 'InitialMagnification',300)
    title 'Output Image'
end

Алгоритмы

Этот объект реализует алгоритмы, описанные на странице с описанием блока Image Filter.

Документация