From 524afc8c8b1c9496c92e60b42f1f4707dff942e5 Mon Sep 17 00:00:00 2001 From: Dsplib Date: Wed, 13 Dec 2023 22:14:27 +0300 Subject: [PATCH] Changes to be committed: modified: dspl/src/randomgen/randb.c modified: dspl/src/randomgen/randb2.c modified: dspl/src/randomgen/randi.c modified: dspl/src/randomgen/randn.c modified: dspl/src/randomgen/randn_cmplx.c modified: dspl/src/randomgen/random_init.c modified: dspl/src/randomgen/randu.c modified: dspl/src/randomgen/randu_mrg32k3a.c modified: dspl/src/resampling/farrow_lagrange.c modified: dspl/src/resampling/farrow_spline.c modified: dspl/src/signals/signal_pimp.c modified: dspl/src/signals/signal_saw.c modified: dspl/src/types/cmplx2re.c modified: dspl/src/types/re2cmplx.c --- dspl/src/randomgen/randb.c | 6 +++--- dspl/src/randomgen/randb2.c | 8 ++++---- dspl/src/randomgen/randi.c | 4 ++-- dspl/src/randomgen/randn.c | 4 ++-- dspl/src/randomgen/randn_cmplx.c | 2 +- dspl/src/randomgen/random_init.c | 6 +++--- dspl/src/randomgen/randu.c | 4 ++-- dspl/src/randomgen/randu_mrg32k3a.c | 2 +- dspl/src/resampling/farrow_lagrange.c | 7 +++---- dspl/src/resampling/farrow_spline.c | 5 ++--- dspl/src/signals/signal_pimp.c | 2 +- dspl/src/signals/signal_saw.c | 2 +- dspl/src/types/cmplx2re.c | 6 +++--- dspl/src/types/re2cmplx.c | 6 +++--- 14 files changed, 31 insertions(+), 33 deletions(-) diff --git a/dspl/src/randomgen/randb.c b/dspl/src/randomgen/randb.c index 9e1b89e..7c331cc 100644 --- a/dspl/src/randomgen/randb.c +++ b/dspl/src/randomgen/randb.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -31,7 +31,7 @@ #ifdef DOXYGEN_ENGLISH /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randb(double* x, int n, random_t* prnd) + \brief Binary unipolar [0, 1] pseudorandom vector. The function generates a unipolar pseudo-random vector, @@ -74,7 +74,7 @@ As a result of the program run, you can see the graph: #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randb(double* x, int n, random_t* prnd) + \brief Генерация бинарного униполярного [0, 1] псевдослучайного вектора Функция генерирует униполярный псевдослучайный вектор, diff --git a/dspl/src/randomgen/randb2.c b/dspl/src/randomgen/randb2.c index 9eda6f6..ae8f77e 100644 --- a/dspl/src/randomgen/randb2.c +++ b/dspl/src/randomgen/randb2.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -29,10 +29,10 @@ #ifdef DOXYGEN_ENGLISH /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randb2(double* x, int n, random_t* prnd) + \brief Binary bipolar [-1, 1] pseudorandom vector. -The function generates a unipolar pseudo-random vector, +The function generates a bipolar pseudo-random vector, each element of which takes an equally probable value of -1 or 1 \param[in,out] x @@ -72,7 +72,7 @@ As a result of the program run, you can see the graph: #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randb2(double* x, int n, random_t* prnd) + \brief Генерация бинарного биполярного [-1, 1] псевдослучайного вектора Функция генерирует биполярный псевдослучайный вектор, diff --git a/dspl/src/randomgen/randi.c b/dspl/src/randomgen/randi.c index 63af99b..e0c3efa 100644 --- a/dspl/src/randomgen/randi.c +++ b/dspl/src/randomgen/randi.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -35,7 +35,7 @@ #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randi(int* x, int n, int start, int stop, random_t* prnd) + \brief Генерация целочисленного вектора равномерно распределенных псевдослучайных чисел. diff --git a/dspl/src/randomgen/randn.c b/dspl/src/randomgen/randn.c index ef6c7f7..32873cd 100644 --- a/dspl/src/randomgen/randn.c +++ b/dspl/src/randomgen/randn.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -34,7 +34,7 @@ #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randn(double* x, int n, double mu, double sigma, random_t* prnd) + \brief Генерация вектора нормально распределенных псевдослучайных чисел. Функция использует преобразование Бокса-Мюллера для приведения diff --git a/dspl/src/randomgen/randn_cmplx.c b/dspl/src/randomgen/randn_cmplx.c index d5f3fdb..8ec7354 100644 --- a/dspl/src/randomgen/randn_cmplx.c +++ b/dspl/src/randomgen/randn_cmplx.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. diff --git a/dspl/src/randomgen/random_init.c b/dspl/src/randomgen/random_init.c index cb3a181..2025451 100644 --- a/dspl/src/randomgen/random_init.c +++ b/dspl/src/randomgen/random_init.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -31,7 +31,7 @@ #ifdef DOXYGEN_ENGLISH /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int random_init(random_t* prnd, int type, void* seed) + \brief Pseudorandom numbers generators initialization. \param[in,out] prnd @@ -75,7 +75,7 @@ pseudorandom numbers each restart. #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int random_init(random_t* prnd, int type, void* seed) + \brief Инициализация датчиков псевдослучайных чисел. \param[in,out] prnd diff --git a/dspl/src/randomgen/randu.c b/dspl/src/randomgen/randu.c index aecee4f..31b9843 100644 --- a/dspl/src/randomgen/randu.c +++ b/dspl/src/randomgen/randu.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -39,7 +39,7 @@ #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup SPEC_MATH_RAND_GEN_GROUP -\fn int randu(double* x, int n, random_t* prnd) + \brief Генерация вектора равномерно-распределенных в интервале от 0 до 1 псевдослучайных чисел. diff --git a/dspl/src/randomgen/randu_mrg32k3a.c b/dspl/src/randomgen/randu_mrg32k3a.c index b15bbef..1821e64 100644 --- a/dspl/src/randomgen/randu_mrg32k3a.c +++ b/dspl/src/randomgen/randu_mrg32k3a.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. diff --git a/dspl/src/resampling/farrow_lagrange.c b/dspl/src/resampling/farrow_lagrange.c index 1516b8d..8622fd7 100644 --- a/dspl/src/resampling/farrow_lagrange.c +++ b/dspl/src/resampling/farrow_lagrange.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -33,9 +33,8 @@ #endif #ifdef DOXYGEN_RUSSIAN /*!***************************************************************************** -\ingroup RESAMPLING_GROUP -\fn int farrow_lagrange(double *s, int n, double p, double q, - double frd, double **y, int *ny) +\ingroup RESAMPLING_GROUP + \brief Передискретизация вещественного сигнала на основе полиномиальной Лагранжевой интерполяции. diff --git a/dspl/src/resampling/farrow_spline.c b/dspl/src/resampling/farrow_spline.c index a95667b..3e3e695 100644 --- a/dspl/src/resampling/farrow_spline.c +++ b/dspl/src/resampling/farrow_spline.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. @@ -34,8 +34,7 @@ #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup RESAMPLING_GROUP -\fn int int farrow_spline(double *s, int n, double p, double q, double frd, - double **y, int *ny) + \brief Передискретизация вещественного сигнала на основе сплайн интерполяции. Данная функция осуществляет передискретизацию diff --git a/dspl/src/signals/signal_pimp.c b/dspl/src/signals/signal_pimp.c index cfaeafa..3d10b2c 100644 --- a/dspl/src/signals/signal_pimp.c +++ b/dspl/src/signals/signal_pimp.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. diff --git a/dspl/src/signals/signal_saw.c b/dspl/src/signals/signal_saw.c index 2a88892..c9baf9c 100644 --- a/dspl/src/signals/signal_saw.c +++ b/dspl/src/signals/signal_saw.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of libdspl-2.0. diff --git a/dspl/src/types/cmplx2re.c b/dspl/src/types/cmplx2re.c index a039ee1..e8531e5 100644 --- a/dspl/src/types/cmplx2re.c +++ b/dspl/src/types/cmplx2re.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of DSPL. @@ -27,7 +27,7 @@ #ifdef DOXYGEN_ENGLISH /*! **************************************************************************** \ingroup TYPES_GROUP -\fn int cmplx2re(complex_t* x, int n, double* re, double* im) + \brief Separate complex vector to the real and image vectors Function fills `re` and `im` vectors corresponds to real and image @@ -78,7 +78,7 @@ re[2] = 5.0; im[2] = 6.0; #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup TYPES_GROUP -\fn int cmplx2re(complex_t* x, int n, double* re, double* im) + \brief Преобразование массива комплексных данных в два массива вещественных данных, содержащих реальную и мнимую части исходного массива diff --git a/dspl/src/types/re2cmplx.c b/dspl/src/types/re2cmplx.c index 2829516..0663619 100644 --- a/dspl/src/types/re2cmplx.c +++ b/dspl/src/types/re2cmplx.c @@ -1,5 +1,5 @@ /* -* Copyright (c) 2015-2022 Sergey Bakhurin +* Copyright (c) 2015-2024 Sergey Bakhurin * Digital Signal Processing Library [http://dsplib.org] * * This file is part of DSPL. @@ -28,7 +28,7 @@ #ifdef DOXYGEN_ENGLISH /*! ***************************************************************************** \ingroup TYPES_GROUP -\fn int re2cmplx(double* x, int n, complex_t *y) + \brief Convert real array to the complex array. Function copies the vector `x` to the real part of vector `y`. @@ -74,7 +74,7 @@ Vector `y` will keep: #ifdef DOXYGEN_RUSSIAN /*! **************************************************************************** \ingroup TYPES_GROUP -\fn int re2cmplx(double* x, int n, complex_t *y) + \brief Преобразование массива вещественных данных в массив комплексных данных. Функция заполняет реальные части массива `y` данных соответсвующими значениями