Функции ввода - вывода данных

Функции
int	dspl_get_version (int printFlag)
	Функция возвращает версию библиотеки DSPL. Подробнее...
int	dspl_writebin (double *x, double *y, int n, char *fn)
	Сохранить вектор в бинарный файл Подробнее...
int	dspl_writetxt (double *x, double *y, int n, char *fn)
	Сохранить вектор данных в текстовый файл Подробнее...

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

Функции ввода и вывода данных. Запись и считывание данных в бинарные и текстовые файлы.

Функции

dspl_get_version()

int dspl_get_version

(

int

printFlag

)

Функция возвращает версию библиотеки DSPL.

Аргументы

[in]

printFlag

Флаг вывода текущей версии в консоль. Если printFlag==1, тогда функция выведет текущую версию библиотеки в консоль.

Возвращает

Верия библиотеки DSPL в формате 0x0000YYMM, где YY - год, MM - месяц компиляции библиотеки.
Например 0x00000F0B соответствует версии 15.11

Автор

Бахурин Сергей. www.dsplib.org

dspl_writebin()

int dspl_writebin	(	double *	x,
		double *	y,
		int	n,
		char *	fn
	)

Сохранить вектор в бинарный файл

Функция сохраняет реальный или комплексный вектор размера [n x 1] в бинарный файл fn.

Файл является универсальным для хранения как одномерных, так и двумерных массивов и имеет следующий формат:

type 4 байта типа int.
Может принимать значение:
DSPL_DAT_COMPLEX, если указатель y не равен NULL;
DSPL_DAT_REAL, если указатель y равен NULL.

n 4 байта типа int.
Количество строк данных.

m 4 байта типа int.
Количество столбцов данных.
При сохранении вектора всегда равно 1.

pR n*m*sizeof(double) Массив реальной части.

pI n*m*sizeof(double) Массив мнимой части.
Только если y не равен NULL.

Файл может быть использован для верификации алгоритмов сторонними пакетами, такими как GNU Octave или Matlab.

Аргументы

[in]	x	Указатель на первый вектор. Размер вектора [n x 1].
[in]	y	Указатель на второй вектор. Размер вектора [n x 1]. Может быть NULL. Файл будет содержать только один столбец соответствующий вектору x если y == NULL.
[in]	n	Размер входных векторов.
[in]	fn	Имя файла.

Возвращает

DSPL_OK Файл сохранен успешно.
В противном случае код ошибки:
DSPL_ERROR_PTR Если x==NULL.
DSPL_ERROR_SIZE Если n<1.
DSPL_ERROR_FNAME Если fn==NULL.
DSPL_ERROR_FOPEN Если файл fn не может быть создан.

Заметки

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

Автор

Бахурин Сергей. www.dsplib.org

dspl_writetxt()

int dspl_writetxt	(	double *	x,
		double *	y,
		int	n,
		char *	fn
	)

Сохранить вектор данных в текстовый файл

Функция сохраняет реальный или комплексный вектор в текстовый файл fn.

Файл имеет следующий формат
x[0] y[0]
x[1] y[1]
...
x[n-1] y[n-1]

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

Аргументы

[in]	x	Указатель на первый вектор. Размер вектора [n x 1].
[in]	y	Указатель на второй вектор. Размер вектора [n x 1]. Может быть NULL. Файл будет содержать только один столбец соответствующий вектору x если y == NULL.
[in]	n	Размер входных векторов.
[in]	fn	Имя файла.

Возвращает

DSPL_OK Файл сохранен успешно.
В противном случае код ошибки:
DSPL_ERROR_PTR Если x==NULL.
DSPL_ERROR_SIZE Если n<1.
DSPL_ERROR_FNAME Если fn==NULL.
DSPL_ERROR_FOPEN Если файл fn не может быть создан.

Заметки

Данная функция производит округление данных при записи в файл. Поэтому не рекомендуется использовать ее для верификации данных DSPL.

Автор

Бахурин Сергей. www.dsplib.org

Примеры:

dft_freq_fig1.c, dft_freq_fig4.c, goertzel_dtmf.c, hilbert_fft.c, resample_lagrange_ex_fs.c, resample_lagrange_ex_interp.c, resample_lagrange_filter_frac_delay.c, resample_lagrange_filter_interp.c, resample_spline_ex_fs.c, resample_spline_ex_interp.c, resample_spline_filter_frac_delay.c, resample_spline_filter_interp.c и win_spectral_leakage.c.