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

designHighpassFIR

Формирование КИХ-фильтра верхних частот.

Библиотека

EngeeDSP

Синтаксис

Вызов функции

  • B = designHighpassFIR() — формирует КИХ-фильтр верхних частот с порядком фильтра 100, частотой среза 0.25 и окном Хэмминга. Аргумент B — это вектор коэффициентов фильтра длиной 101.

    Аргумент SystemObject по умолчанию имеет значение false. Для реализации фильтра присвойте коэффициенты фильтра из вектора B объекту FIRFilter.

  • B = designHighpassFIR(Name=Value) — задает параметры с помощью одного или нескольких аргументов типа «имя-значение».

    Например, B = designHighpassFIR(FilterOrder=30, CutoffFrequency=0.5, Window="hann", SystemObject=true) проектирует КИХ-фильтр верхних частот с порядком фильтра 30, частотой среза 0.5 и окном Ханна. Поскольку аргумент SystemObject имеет значение true, функция формирует КИХ-фильтр верхних частот. В данном случае B — это системный объект FIRFilter.

    При указании только частичного списка параметров фильтра функция проектирует фильтр, устанавливая для остальных параметров значения по умолчанию.

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

Аргументы

Входные аргументы «имя-значение»

Укажите необязательные пары аргументов в виде Name=Value, где Name — имя аргумента, а Value — соответствующее значение. Порядок аргументов типа «имя-значение» не имеет значения.

# FilterOrder — порядок КИХ-фильтра верхних частот
100 (по умолчанию) | четное неотрицательное целое число

Details

Порядок КИХ-фильтра верхних частот, заданный как четное неотрицательное целое число.

Типы данных

Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64

# CutoffFrequency — частота среза КИХ-фильтра верхних частот
0.25 (по умолчанию) | нормализованный скаляр

Details

Частота среза КИХ-фильтра верхних частот, , заданная как нормализованный скаляр в диапазоне (0, 1].

Типы данных

Float32, Float64

# Window — метод проектирования окна
"hamming" (по умолчанию) | "hann" | "blackman" | "blackman-harris" | "chebyshev" | "kaiser" | "custom"

Details

Метод проектирования окна, заданный одним из следующих значений:

  • "hamming";

  • "hann";

  • "blackman";

  • "blackman-harris";

  • "chebyshev" — по умолчанию затухание боковых лепестков составляет 60 дБ;

  • "kaiser";

  • "custom" — укажите вектор пользовательского окна в аргументе CustomWindow.

Типы данных

Char, String

# CustomWindow — вектор пользовательского окна
вектор

Details

Вектор пользовательского окна, заданный как вектор длины FilterOrder + 1.

Типы данных

Float32, Float64

# Datatype — тип данных коэффициентов фильтра по имени типа
Float64 (по умолчанию) | Float32

Details

Тип данных коэффициентов фильтра по имени типа, заданный как Float64 или Float32.

Для указания типа данных коэффициентов фильтра можно использовать аргумент Datatype или like, но нельзя использовать оба аргумента одновременно.

Если вы указываете тип данных коэффициентов фильтра с помощью данного аргумента, функция игнорирует типы данных других числовых аргументов.

Типы данных

DataType

# like — тип данных коэффициентов фильтра по прототипу
вещественное число с плавающей запятой

Details

Тип данных коэффициентов фильтра, заданный как прототип вещественного числа с плавающей запятой.

Для указания типа данных коэффициентов фильтра можно использовать аргумент Datatype или like, но нельзя использовать оба аргумента одновременно.

Если вы указываете тип данных коэффициентов фильтра с помощью данного аргумента, функция игнорирует типы данных других числовых аргументов.

Типы данных

Float32, Float64

# SystemObject — флаг создания системного объекта
false (по умолчанию) | true

Details

Флаг создания системного объекта, заданный как

  • false — функция возвращает вектор коэффициентов КИХ-фильтра;

  • true — функция возвращает объект FIRFilter.

Типы данных

Bool

# Verbose — флаг печати вызова функции в Engee
false (по умолчанию) | true

Details

Флаг печати вызова функции в Engee, заданный как

  • false — функция не выводит вызов функции;

  • true — функция выводит весь вызов функции, включая значения по умолчанию для аргументов типа Name=Value, которые не были указаны при вызове функции.

    Используйте это значение для просмотра всех параметров, используемых функцией для проектирования и реализации фильтра.

Типы данных

Bool

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

# B — коэффициенты фильтра или объект фильтра
вектор-строка | объект FIRFilter

Details

Коэффициенты КИХ-фильтра верхних частот или объект фильтра, возвращаемые в виде:

  • Вектора-строки — функция возвращает вектор-строку длины FilterOrder + 1, если для аргумента SystemObject установлено значение false.

    Если в любом из входных аргументов указаны значения с одинарной точностью, функция вычисляет коэффициенты фильтра с одинарной точностью.

    Если тип данных указан с помощью аргумента Datatype или like, функция игнорирует типы данных других числовых аргументов.

  • Системного объекта FIRFilter — функция возвращает объект фильтра, если для аргумента SystemObject установлено значение true.

Типы данных

Float32, Float64