libdspl-2.0
Библиотека алгоритмов цифровой обработки сигналов
Коды ошибок при вызове функций

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

Макросы

#define RES_OK   0
 Функция завершилась корректно. Ошибки отсутствуют. Подробнее...
 
#define ERROR_ARG_PARAM   0x01180716
 Неверный параметр вызова программы. Данная ошибка возникает, когда производится вызов программы с неверным количеством параметров argc и указателем argv на массив параметров вызова программы. Подробнее...
 
#define ERROR_DAT_TYPE   0x04012020
 Неверный тип данных. Данная ошибка возникает при сохранении данных в бинарный файл, когда параметр, задающий тип данных в памяти (вещественные или комплексные) задан неверно. Подробнее...
 
#define ERROR_DIV_ZERO   0x04102226
 Ошибка деления на ноль. Функция возвращает данную ошибку, если в вычислительном алгоритме возникло деление на ноль. Подробнее...
 
#define ERROR_ELLIP_MODULE   0x05121315
 Модуль эллиптического интеграла Якоби должен быть от 0 до 1. Данная ошибка возникает при расчете эллиптических функций Якоби при неверном задании параметра эллиптического модуля. Функция завершает работу и возвращает данный код ошибки. Подробнее...
 
#define ERROR_FFT_SIZE   0x06062021
 Неверно задан размер БПФ. Размер БПФ может быть составным вида \(n = n_0 \times n_1 \times n_2 \ldots \times n_p \times m\), где \(n_i = 2,3,5,7\), а \(m \) – произвольный простой множитель не превосходящий 46340. Ошибка возникает, когда множитель \(m \) превосходит 46340. Подробнее...
 
#define ERROR_FILTER_A0   0x06090100
 Параметр \(a_0\) передаточной характеристики \(H(z)\) цифрового БИХ-фильтра не может быть равен нулю. Подробнее...
 
#define ERROR_FILTER_APPROX   0x06090116
 Неизвестный тип аппроксимации цифрового или аналогового фильтра. Данная ошибка возникает при неверном задании масок типа цифрового БИХ-фильтра. Библиотека поддерживает следущие аппроксимации: Баттерворта, Чебышева первого рода, Чебышева второго рода и эллиптические. Подробнее...
 
#define ERROR_FILTER_FT   0x06090620
 Неверно заданы частоты преобразования ФНЧ-ПФ и ФНЧ-РФ. Частотные маски полосовых и режекторных фильтров имеют две частоты среза или частоты заграждения. При реализации частотных преобразований фильтров необходимо задавать левую частоту среза меньше правой.
Подробнее...
 
#define ERROR_FILTER_ORD   0x06091518
 Порядок фильтра задан неверно. Порядок фильтра должен быть задан положительным целым значением. Подробнее...
 
#define ERROR_FILTER_ORD_BP   0x06091519
 Порядок полосового или режекторного фильтра задан неверно. Порядок полосового и режекторного фильтра должен быть задан чётным положительным значением. Подробнее...
 
#define ERROR_FILTER_RP   0x06091816
 Параметр неравномерности фильтра в полосе пропускания задан неверно. Данный параметр задается в дБ и должен быть положительным числом. Подробнее...
 
#define ERROR_FILTER_RS   0x06091819
 Параметр подавления фильтра в полосе заграждения задан неверно. Данный параметр задается в дБ и должен быть положительным числом. Подробнее...
 
#define ERROR_FILTER_TYPE   0x06092025
 Неизвестный тип фильтра. Библиотека поддерживает следущие типы фильтров: ФНЧ, ФВЧ, полосовой и режекторный. Подробнее...
 
#define ERROR_FILTER_WP   0x06092316
 Параметр частоты среза фильтра задан неверно. Частота среза фильтра должна быть положительной от 0 до 1 для цифрового КИХ-фильтра. Подробнее...
 
#define ERROR_FILTER_WS   0x06092319
 Параметр частоты заграждения фильтра задан неверно. Частота заграждения должна быть положительным числом от 0 до 1. Подробнее...
 
#define ERROR_FNAME   0x06140113
 Ошибка в имени файла. Необходимо задать корректное имя файла. Подробнее...
 
#define ERROR_FOPEN   0x06151605
 Ошибка открытия файла. Файл с заданным именем не может быть открыт для записи и (или) чтения. Подробнее...
 
#define ERROR_FREAD_SIZE   0x06180501
 Ошибка чтения блока данных из бинарного файла. Ошибка возникает, если при чтении блока данных из файла размер считанного блока не соответствует требуемому значению. Подробнее...
 
#define ERROR_FWRITE_SIZE   0x06231820
 Ошибка записи блока данных в бинарный файла. Ошибка возникает, если при записи блока данных в файл, размер записанного блока не соответствует требуемому значению. Подробнее...
 
#define ERROR_GNUPLOT_CREATE   0x07161203
 Невозможно подключиться к пакету GNUPLOT. Пожалуйста проверьте, что пакет доступен. Подробнее...
 
#define ERROR_GNUPLOT_TERM   0x07161220
 Неизвестный параметра вызова программы, задающий терминал GNUPLOT.
Данный параметр может принимать одно из следюущих значений:
--noplot построение графика не производиться;
--plotwin построение графиков производиться в отельном окне (окнах);
--plotpng построение графиков производиться в png - файл.
. Подробнее...
 
#define ERROR_LAPACK   0x12011601
 Встроенная функция пакета LAPACK вернула код ошибки. Данная ошибка возвращается функцией, если она использует одну из встроенных функций LAPACK, которая завершилась с ошибкой. Подробнее...
 
#define ERROR_MALLOC   0x13011212
 Ошибка динамического выделения памяти. Данная ошибка означает, что при динамическом выделении памяти произошла ошбика. В результате функция malloc в теле вызваемой функции вернула NULL указатель. Дальнейшая обработка функцией невозможна. Подробнее...
 
#define ERROR_MATRIX_SIZE   0x13011926
 Неверный размер матрицы. Подробнее...
 
#define ERROR_MIN_MAX   0x13091413
 Минимальное значение (нижняя граница) больше максимального. Подробнее...
 
#define ERROR_NEGATIVE   0x14050701
 Отрицательный параметр. Функция возвращает данный код ошибки, когда принимает отрицательный параметр в переменную, которая не может быть отрицательной. Подробнее...
 
#define ERROR_POLY_AN   0x16150114
 Неверно задан старший коэффициент полинома. Например при вычислении кореней полинома степени \(N\). Подробнее...
 
#define ERROR_POLY_ORD   0x16151518
 Неверно задан порядок полинома. Порядок полинома должен быть положительным целым числом. Подробнее...
 
#define ERROR_PTR   0x16201800
 Ошибка указателя. Данная ошибка означает, что один из обязательных указателей (память под который должна быть выделена) передан как NULL. При возникновении данной ошибки, функция завершает работу и возвращает данный код ошибки. Подробнее...
 
#define ERROR_RAND_SIGMA   0x18011909
 Неверно задано среднеквадратическое отклонение нормального распределения случайной величины. Среднеквадратическое отклонение должно быть неотрицательным вещественным числом. Подробнее...
 
#define ERROR_RAND_TYPE   0x18012009
 Неизвестный датчик псевдослучайных чисел. В библиотеке используются следующие датчики: Подробнее...
 
#define ERROR_RESAMPLE_RATIO   0x18051801
 Коэффициент передискретизации задан неверно. Коэффициент передискретизации задается отношением \(\frac{P}{Q}\), где \(P\) и \(Q\) вещественные положительные числа. Подробнее...
 
#define ERROR_RESAMPLE_FRAC_DELAY   0x18050604
 Неверное значение дробной задержки. Дробная задержка может принимать значения от -1 до 1, где 1 соответствует одному интервалу дискретизации \(1/F_{\textrm{s}}\). Подробнее...
 
#define ERROR_SIZE   0x19092605
 Ошибка при передаче размера массива. Данная ошибка возникает когда помимо указателя на массив входных или выходных данных передается неверный размер массива (меньше или равный нулю). При возникновении данной ошибки, функция завершает работу и возвращает данный код ошибки. Подробнее...
 
#define ERROR_SYM_TYPE   0x19251320
 Ошибка параметра типа заполнения массивов в линейном или логарифмическом масштабе. Допустимые типы заполнения: симметричный и периодический. Подробнее...
 
#define ERROR_UNWRAP   0x21142318
 Ошибка параметров функции раскрытия периодичности. Параметр периода и отступа должны быть положительными числами. Подробнее...
 
#define ERROR_WIN_PARAM   0x23091601
 Ошибка значения параметра оконной функции. Для каждой параметрической оконной функции существуют допустимые значения параметра. Подробнее...
 
#define ERROR_WIN_SYM   0x23091925
 Симметричность или периодичность заданного окна не поддерживается. Подробнее...
 
#define ERROR_WIN_TYPE   0x23092025
 Неизвестный тип оконной функции. Подробнее...
 

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

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

Макросы

◆ ERROR_ARG_PARAM

#define ERROR_ARG_PARAM   0x01180716

Неверный параметр вызова программы. Данная ошибка возникает, когда производится вызов программы с неверным количеством параметров argc и указателем argv на массив параметров вызова программы.

См. определение в файле dspl.h строка 562

◆ ERROR_DAT_TYPE

#define ERROR_DAT_TYPE   0x04012020

Неверный тип данных. Данная ошибка возникает при сохранении данных в бинарный файл, когда параметр, задающий тип данных в памяти (вещественные или комплексные) задан неверно.

См. определение в файле dspl.h строка 566

◆ ERROR_DIV_ZERO

#define ERROR_DIV_ZERO   0x04102226

Ошибка деления на ноль. Функция возвращает данную ошибку, если в вычислительном алгоритме возникло деление на ноль.

См. определение в файле dspl.h строка 567

◆ ERROR_ELLIP_MODULE

#define ERROR_ELLIP_MODULE   0x05121315

Модуль эллиптического интеграла Якоби должен быть от 0 до 1. Данная ошибка возникает при расчете эллиптических функций Якоби при неверном задании параметра эллиптического модуля. Функция завершает работу и возвращает данный код ошибки.

См. определение в файле dspl.h строка 569

◆ ERROR_FFT_SIZE

#define ERROR_FFT_SIZE   0x06062021

Неверно задан размер БПФ. Размер БПФ может быть составным вида \(n = n_0 \times n_1 \times n_2 \ldots \times n_p \times m\), где \(n_i = 2,3,5,7\), а \(m \) – произвольный простой множитель не превосходящий 46340. Ошибка возникает, когда множитель \(m \) превосходит 46340.

См. определение в файле dspl.h строка 571

◆ ERROR_FILTER_A0

#define ERROR_FILTER_A0   0x06090100

Параметр \(a_0\) передаточной характеристики \(H(z)\) цифрового БИХ-фильтра не может быть равен нулю.

См. определение в файле dspl.h строка 572

◆ ERROR_FILTER_APPROX

#define ERROR_FILTER_APPROX   0x06090116

Неизвестный тип аппроксимации цифрового или аналогового фильтра. Данная ошибка возникает при неверном задании масок типа цифрового БИХ-фильтра. Библиотека поддерживает следущие аппроксимации: Баттерворта, Чебышева первого рода, Чебышева второго рода и эллиптические.

См. определение в файле dspl.h строка 573

◆ ERROR_FILTER_FT

#define ERROR_FILTER_FT   0x06090620

Неверно заданы частоты преобразования ФНЧ-ПФ и ФНЧ-РФ. Частотные маски полосовых и режекторных фильтров имеют две частоты среза или частоты заграждения. При реализации частотных преобразований фильтров необходимо задавать левую частоту среза меньше правой.

См. определение в файле dspl.h строка 574

◆ ERROR_FILTER_ORD

#define ERROR_FILTER_ORD   0x06091518

Порядок фильтра задан неверно. Порядок фильтра должен быть задан положительным целым значением.

См. определение в файле dspl.h строка 575

◆ ERROR_FILTER_ORD_BP

#define ERROR_FILTER_ORD_BP   0x06091519

Порядок полосового или режекторного фильтра задан неверно. Порядок полосового и режекторного фильтра должен быть задан чётным положительным значением.

См. определение в файле dspl.h строка 576

◆ ERROR_FILTER_RP

#define ERROR_FILTER_RP   0x06091816

Параметр неравномерности фильтра в полосе пропускания задан неверно. Данный параметр задается в дБ и должен быть положительным числом.

См. определение в файле dspl.h строка 577

◆ ERROR_FILTER_RS

#define ERROR_FILTER_RS   0x06091819

Параметр подавления фильтра в полосе заграждения задан неверно. Данный параметр задается в дБ и должен быть положительным числом.

См. определение в файле dspl.h строка 578

◆ ERROR_FILTER_TYPE

#define ERROR_FILTER_TYPE   0x06092025

Неизвестный тип фильтра. Библиотека поддерживает следущие типы фильтров: ФНЧ, ФВЧ, полосовой и режекторный.

См. определение в файле dspl.h строка 579

◆ ERROR_FILTER_WP

#define ERROR_FILTER_WP   0x06092316

Параметр частоты среза фильтра задан неверно. Частота среза фильтра должна быть положительной от 0 до 1 для цифрового КИХ-фильтра.

См. определение в файле dspl.h строка 580

◆ ERROR_FILTER_WS

#define ERROR_FILTER_WS   0x06092319

Параметр частоты заграждения фильтра задан неверно. Частота заграждения должна быть положительным числом от 0 до 1.

См. определение в файле dspl.h строка 581

◆ ERROR_FNAME

#define ERROR_FNAME   0x06140113

Ошибка в имени файла. Необходимо задать корректное имя файла.

См. определение в файле dspl.h строка 582

◆ ERROR_FOPEN

#define ERROR_FOPEN   0x06151605

Ошибка открытия файла. Файл с заданным именем не может быть открыт для записи и (или) чтения.

См. определение в файле dspl.h строка 583

◆ ERROR_FREAD_SIZE

#define ERROR_FREAD_SIZE   0x06180501

Ошибка чтения блока данных из бинарного файла. Ошибка возникает, если при чтении блока данных из файла размер считанного блока не соответствует требуемому значению.

См. определение в файле dspl.h строка 584

◆ ERROR_FWRITE_SIZE

#define ERROR_FWRITE_SIZE   0x06231820

Ошибка записи блока данных в бинарный файла. Ошибка возникает, если при записи блока данных в файл, размер записанного блока не соответствует требуемому значению.

См. определение в файле dspl.h строка 586

◆ ERROR_GNUPLOT_CREATE

#define ERROR_GNUPLOT_CREATE   0x07161203

Невозможно подключиться к пакету GNUPLOT. Пожалуйста проверьте, что пакет доступен.

См. определение в файле dspl.h строка 588

◆ ERROR_GNUPLOT_TERM

#define ERROR_GNUPLOT_TERM   0x07161220

Неизвестный параметра вызова программы, задающий терминал GNUPLOT.
Данный параметр может принимать одно из следюущих значений:
--noplot построение графика не производиться;
--plotwin построение графиков производиться в отельном окне (окнах);
--plotpng построение графиков производиться в png - файл.
.

См. определение в файле dspl.h строка 590

◆ ERROR_LAPACK

#define ERROR_LAPACK   0x12011601

Встроенная функция пакета LAPACK вернула код ошибки. Данная ошибка возвращается функцией, если она использует одну из встроенных функций LAPACK, которая завершилась с ошибкой.

См. определение в файле dspl.h строка 597

◆ ERROR_MALLOC

#define ERROR_MALLOC   0x13011212

Ошибка динамического выделения памяти. Данная ошибка означает, что при динамическом выделении памяти произошла ошбика. В результате функция malloc в теле вызваемой функции вернула NULL указатель. Дальнейшая обработка функцией невозможна.

См. определение в файле dspl.h строка 599

◆ ERROR_MATRIX_SIZE

#define ERROR_MATRIX_SIZE   0x13011926

Неверный размер матрицы.

См. определение в файле dspl.h строка 600

◆ ERROR_MIN_MAX

#define ERROR_MIN_MAX   0x13091413

Минимальное значение (нижняя граница) больше максимального.

См. определение в файле dspl.h строка 601

◆ ERROR_NEGATIVE

#define ERROR_NEGATIVE   0x14050701

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

См. определение в файле dspl.h строка 604

◆ ERROR_POLY_AN

#define ERROR_POLY_AN   0x16150114

Неверно задан старший коэффициент полинома. Например при вычислении кореней полинома степени \(N\).

\[ P_N(x) = a_0 + a_1 x + a_2 x^2 + \ldots a_N x^N \]

старший коэффициентом \(a_N\) не может быть равным нулю.

См. определение в файле dspl.h строка 608

◆ ERROR_POLY_ORD

#define ERROR_POLY_ORD   0x16151518

Неверно задан порядок полинома. Порядок полинома должен быть положительным целым числом.

См. определение в файле dspl.h строка 609

◆ ERROR_PTR

#define ERROR_PTR   0x16201800

Ошибка указателя. Данная ошибка означает, что один из обязательных указателей (память под который должна быть выделена) передан как NULL. При возникновении данной ошибки, функция завершает работу и возвращает данный код ошибки.

См. определение в файле dspl.h строка 610

◆ ERROR_RAND_SIGMA

#define ERROR_RAND_SIGMA   0x18011909

Неверно задано среднеквадратическое отклонение нормального распределения случайной величины. Среднеквадратическое отклонение должно быть неотрицательным вещественным числом.

См. определение в файле dspl.h строка 613

◆ ERROR_RAND_TYPE

#define ERROR_RAND_TYPE   0x18012009

Неизвестный датчик псевдослучайных чисел. В библиотеке используются следующие датчики:

  • MRG32K3A – 32 битный датчик MRG32K3A разработан Пьером Лекуэром.
  • MT19937-64 – 64-битный датчик Вихрь Мерсенна.

См. определение в файле dspl.h строка 614

◆ ERROR_RESAMPLE_FRAC_DELAY

#define ERROR_RESAMPLE_FRAC_DELAY   0x18050604

Неверное значение дробной задержки. Дробная задержка может принимать значения от -1 до 1, где 1 соответствует одному интервалу дискретизации \(1/F_{\textrm{s}}\).

См. определение в файле dspl.h строка 616

◆ ERROR_RESAMPLE_RATIO

#define ERROR_RESAMPLE_RATIO   0x18051801

Коэффициент передискретизации задан неверно. Коэффициент передискретизации задается отношением \(\frac{P}{Q}\), где \(P\) и \(Q\) вещественные положительные числа.

См. определение в файле dspl.h строка 615

◆ ERROR_SIZE

#define ERROR_SIZE   0x19092605

Ошибка при передаче размера массива. Данная ошибка возникает когда помимо указателя на массив входных или выходных данных передается неверный размер массива (меньше или равный нулю). При возникновении данной ошибки, функция завершает работу и возвращает данный код ошибки.

См. определение в файле dspl.h строка 618

◆ ERROR_SYM_TYPE

#define ERROR_SYM_TYPE   0x19251320

Ошибка параметра типа заполнения массивов в линейном или логарифмическом масштабе. Допустимые типы заполнения: симметричный и периодический.

См. определение в файле dspl.h строка 619

◆ ERROR_UNWRAP

#define ERROR_UNWRAP   0x21142318

Ошибка параметров функции раскрытия периодичности. Параметр периода и отступа должны быть положительными числами.

См. определение в файле dspl.h строка 622

◆ ERROR_WIN_PARAM

#define ERROR_WIN_PARAM   0x23091601

Ошибка значения параметра оконной функции. Для каждой параметрической оконной функции существуют допустимые значения параметра.

См. определение в файле dspl.h строка 625

◆ ERROR_WIN_SYM

#define ERROR_WIN_SYM   0x23091925

Симметричность или периодичность заданного окна не поддерживается.

См. определение в файле dspl.h строка 626

◆ ERROR_WIN_TYPE

#define ERROR_WIN_TYPE   0x23092025

Неизвестный тип оконной функции.

См. определение в файле dspl.h строка 627

◆ RES_OK

#define RES_OK   0

Функция завершилась корректно. Ошибки отсутствуют.

См. определение в файле dspl.h строка 558