bpf_2.h

Go to the documentation of this file.

 * @details
 * This file defines the @ref filter::band_pass::BPF_2 class, which
 * implements a discrete-time second-order band-pass filter.
 *
 * The filter allows frequency components within a specified frequency
 * band to pass while attenuating frequency components below and above
 * that band.
 *
 * The filter is parameterized by its center frequency, bandwidth, and
 * sampling time. The quality factor is derived from the center frequency
 * and bandwidth.
 *
 * The implementation maintains previous input and output samples as
 * internal filter state.
 *
 * The class is templated to support different numeric types such as
 * @c float and @c double.
 *
 * @tparam T Numeric data type used for the filter calculations.
 *
 * @author Abhinay Kumar
 * @version 1.0.0
 *
 * @copyright
 * Copyright (c) 2026 Abhinay Kumar
 */
 
#ifndef FILTER_BPF_2_H
#define FILTER_BPF_2_H
 
#include <cstdint>
 
namespace filter
{
 
    namespace band_pass
    {

         * The BPF_2 class implements a discrete-time second-order
         * band-pass filter.
         *
         * The filter passes frequency components around the specified
         * center frequency while attenuating frequencies outside the
         * passband.
         *
         * The filter is configured using the center frequency, bandwidth,
         * and sampling time. The quality factor is calculated from the
         * center frequency and bandwidth.
         *
         * @tparam T Numeric data type used for the filter.
         *
         * @par Example
         * @code{.cpp}
         * filter::band_pass::BPF_2<double> filter;
         *
         * filter.config(10.0, 2.0, 0.001);
         *
         * double output = filter.update(input);
         * @endcode
         */
        template <typename T>
        class BPF_2
        {
        public:
             */
            BPF_2();


             * @param[in] f0_ Center frequency of the filter in Hz.
             * @param[in] B_ Bandwidth of the filter in Hz.
             * @param[in] dt_ Sampling time of the filter in seconds.
             *
             * @details
             * Configures the filter using the specified center frequency,
             * bandwidth, and sampling time, and calculates the required
             * filter coefficients.
             */
            void config(T f0_, T B_, T dt_);

             * @brief Sets the filter parameters.
             *
             * @param[in] f0_ Center frequency of the filter in Hz.
             * @param[in] B_ Bandwidth of the filter in Hz.
             * @param[in] dt_ Sampling time of the filter in seconds.
             *
             * @details
             * Updates the center frequency, bandwidth, and sampling time
             * used by the filter.
             */
            void set_param(T f0_, T B_, T dt_);

            /**
             * @brief Processes a new input sample.
             *
             * @param[in] x_k Current input sample.
             *
             * @return Filtered output sample.
             *
             * @details
             * Processes the current input sample using the second-order
             * band-pass filter equation and updates the internal filter
             * state.
             */
            T update(T x_k);


             * Resets the previous input and output samples and the
             * startup counter.
             */
            void reset();

            void set_f0(T f0_);

            void set_B(T B_);

            void set_dt(T dt_);

            T get_f0();

            T get_B();

            T get_dt();

            T get_Q();

            T get_fs();
 
        private:
            T f0 = 0.0;

            T B = 0.0;

            T dt = 0.0;

            T Q = 0.0;

            T lambda_1 = 0.0;

            T lambda_2 = 0.0;

            T lambda_3 = 0.0;

            T lambda_4 = 0.0;

            T lambda_5 = 0.0;

            T y_k_1 = 0.0;

            T y_k_2 = 0.0;

            T x_k_1 = 0.0;

            T x_k_2 = 0.0;

            uint8_t start_counter = 0;

            T prewarp_freq(T wc_, T dt_);
        };
 
#include "../../src/band_pass/bpf_2.tpp"
 
    } // namespace band_pass
 
} // namespace filter
 
#endif // FILTER_BPF_2_H