libdspl-2.0
Библиотека алгоритмов цифровой обработки сигналов
Свертка и цифровая фильтрация

Функции

int conv (double *a, int na, double *b, int nb, double *c)
 Линейная свертка двух вещественных векторов Подробнее...
 
int conv_cmplx (complex_t *a, int na, complex_t *b, int nb, complex_t *c)
 Линейная свертка двух комплексных векторов Подробнее...
 
int filter_iir (double *b, double *a, int ord, double *x, int n, double *y)
 Фильтрация вещественного сигнала вещественным БИХ-фильтром Подробнее...
 

Подробное описание

Функции для расчета циклической и линейной сверток, а также цифровой КИХ и БИХ фильтрации.

Функции

◆ conv()

int conv ( double *  a,
int  na,
double *  b,
int  nb,
double *  c 
)

Линейная свертка двух вещественных векторов


Функция рассчитывает линейную свертку двух векторов $ c = a * b$.

Аргументы
[in]aУказатель на первый вектор $a$.
Размер вектора [na x 1].

[in]naРазмер первого вектора.

[in]bУказатель на второй вектор $b$.
Размер вектора [nb x 1].

[in]nbРазмер второго вектора.

[out]cУказатель на вектор свертки $ c = a * b$.
Размер вектора [na + nb - 1 x 1].
Память должна быть выделена.

Возвращает
RES_OK если свертка расчитана успешно.
В противном случае код ошибки.
Заметки
Если вектора a и b представляют собой коэффициенты двух полиномов, то результат линейной свертки представляет собой коэффициенты произведения исходных полиномов.

Пример использования функции:

double ar[3] = {1.0, 2.0, 3.0};
double br[4] = {3.0, -1.0, 2.0, 4.0};
double cr[6];
int n;
conv(ar, 3, br, 4, cr);
for(n = 0; n < 6; n++)
printf("cr[%d] = %5.1f\n", n, cr[n]);


Результат работы:

cr[0] =   3.0
cr[1] =   5.0
cr[2] =   9.0
cr[3] =   5.0
cr[4] =  14.0
cr[5] =  12.0
Автор
Бахурин Сергей www.dsplib.org

См. определение в файле conv.c строка 86

Используется в ratcompos().

◆ conv_cmplx()

int conv_cmplx ( complex_t a,
int  na,
complex_t b,
int  nb,
complex_t c 
)

Линейная свертка двух комплексных векторов


Функция рассчитывает линейную свертку двух векторов $ c = a * b$.

Аргументы
[in]aУказатель на первый вектор $a$.
Размер вектора [na x 1].

[in]naРазмер первого вектора.

[in]bУказатель на второй вектор $b$.
Размер вектора [nb x 1].

[in]nbРазмер второго вектора.

[out]cУказатель на вектор свертки $ c = a * b$.
Размер вектора [na + nb - 1 x 1].
Память должна быть выделена.

Возвращает
RES_OK если свертка рассчитана успешно.
В противном случае код ошибки.
Заметки
Если вектора a и b представляют собой коэффициенты двух полиномов, то результат линейной свертки представляет собой коэффициенты произведения исходных полиномов.

Пример использования функции:

complex_t ac[3] = {{0.0, 1.0}, {1.0, 1.0}, {2.0, 2.0}};
complex_t bc[4] = {{3.0, 3.0}, {4.0, 4.0}, {5.0, 5.0}, {6.0, 6.0}};
complex_t cc[6];
int n;
conv_cmplx(ac, 3, bc, 4, cc);
for(n = 0; n < 6; n++)
printf("cc[%d] = %5.1f%+5.1fj\n", n, RE(cc[n]),IM(cc[n]));


Результат работы:

cc[0] =  -3.0 +3.0j
cc[1] =  -4.0+10.0j
cc[2] =  -5.0+25.0j
cc[3] =  -6.0+32.0j
cc[4] =   0.0+32.0j
cc[5] =   0.0+24.0j
Автор
Бахурин Сергей www.dsplib.org

См. определение в файле conv.c строка 183

◆ filter_iir()

int filter_iir ( double *  b,
double *  a,
int  ord,
double *  x,
int  n,
double *  y 
)

Фильтрация вещественного сигнала вещественным БИХ-фильтром


Функция рассчитывает выход фильтра заданного выражением

\[ H(z) = \frac{\sum_{n = 0}^{N} b_n z^{-n}} {1+{\frac{1}{a_0}}\sum_{m = 1}^{M} a_m z^{-n}}, \]

где $a_0$ не может быть 0, $N=M=$ord.

Аргументы
[in]bУказатель на вектор коэффициентов числителя передаточной функции БИХ-фильтра.
Размер вектора [ord + 1 x 1].

[in]aУказатель на вектор коэффициентов знаменателя передаточной функции БИХ-фильтра.
Размер вектора [ord + 1 x 1].
Этот указатель может быть NULL, тогда фильтрация производится без использования рекурсивной части.

[in]ordПорядок фильтра. Количество коэффициентов числителя и знаменателя передаточной функции БИХ-фильтра равно ord + 1.

[in]xУказатель на вектор отсчетов входного сигнала.

Размер вектора [n x 1].

Аргументы
[in]nДлина входного сигнала.

[out]yУказатель на вектор выходных отсчетов фильтра.
Размер вектора [n x 1].
Память должна быть выделена заранее.

Возвращает
RES_OK Если фильтрация произведена успешно.
В противном случае код ошибки:
Автор
Бахурин Сергей www.dsplib.org

См. определение в файле conv.c строка 556