fers_signal::CwSignal Class Reference

Continuous-wave signal implementation. More...

#include "radar_signal.h"

Inheritance diagram for fers_signal::CwSignal:

Collaboration diagram for fers_signal::CwSignal:

Public Member Functions
	CwSignal ()=default
	~CwSignal () override=default
	CwSignal (const CwSignal &) noexcept=delete
CwSignal &	operator= (const CwSignal &) noexcept=delete
	CwSignal (CwSignal &&) noexcept=delete
CwSignal &	operator= (CwSignal &&) noexcept=delete
std::vector< ComplexType >	render (const std::vector< interp::InterpPoint > &points, unsigned &size, RealType fracWinDelay) const override
	Renders the signal data.
void	clear () noexcept
	Clears the internal signal data.
void	load (std::span< const ComplexType > inData, unsigned samples, RealType sampleRate)
	Loads complex radar waveform data.
RealType	getRate () const noexcept
	Gets the sample rate of the signal.
unsigned	getSampleCount () const noexcept
	Gets the number of native samples held by this signal.
virtual std::vector< ComplexType >	renderSlice (const std::vector< interp::InterpPoint > &points, RealType outputStartTime, RealType outputSampleRate, std::size_t sampleCount, RealType fracWinDelay) const
	Renders a bounded absolute-time slice on the requested output grid.
virtual bool	isFmcwFamily () const noexcept
	Returns true when this signal belongs to the FMCW waveform family.

Detailed Description

Continuous-wave signal implementation.

Definition at line 283 of file radar_signal.h.

Constructor & Destructor Documentation

CwSignal() [1/3]

fers_signal::CwSignal::CwSignal ( )

default

~CwSignal()

fers_signal::CwSignal::~CwSignal ( )

overridedefault

CwSignal() [2/3]

fers_signal::CwSignal::CwSignal ( const CwSignal &  )

deletenoexcept

CwSignal() [3/3]

fers_signal::CwSignal::CwSignal ( CwSignal &&  )

deletenoexcept

Member Function Documentation

clear()

void fers_signal::Signal::clear ( )

noexceptinherited

Clears the internal signal data.

Definition at line 232 of file radar_signal.cpp.

    {
        _size = 0;
        _rate = 0;
    }

Referenced by fers_signal::Signal::load().

Here is the caller graph for this function:

getRate()

RealType fers_signal::Signal::getRate ( ) const

noexceptinherited

Gets the sample rate of the signal.

Returns

The sample rate of the signal.

Definition at line 86 of file radar_signal.h.

{ return _rate; }

getSampleCount()

unsigned fers_signal::Signal::getSampleCount ( ) const

noexceptinherited

Gets the number of native samples held by this signal.

Definition at line 89 of file radar_signal.h.

{ return _size; }

isFmcwFamily()

virtual bool fers_signal::Signal::isFmcwFamily ( ) const

virtualnoexceptinherited

Returns true when this signal belongs to the FMCW waveform family.

Reimplemented in fers_signal::FmcwChirpSignal, and fers_signal::FmcwTriangleSignal.

Definition at line 109 of file radar_signal.h.

{ return false; }

load()

void fers_signal::Signal::load ( std::span< const ComplexType >  inData, unsigned  samples, RealType  sampleRate  )

inherited

Loads complex radar waveform data.

Parameters

inData	The input span of complex signal data.
samples	The number of samples in the input data.
sampleRate	The sample rate of the input data.

Definition at line 238 of file radar_signal.cpp.

    {
        clear();
        const unsigned ratio = params::oversampleRatio();
        const auto oversampled_samples = static_cast<std::size_t>(samples) * static_cast<std::size_t>(ratio);
        if (oversampled_samples > std::numeric_limits<unsigned>::max())
        {
            throw std::overflow_error("Oversampled signal sample count exceeds unsigned range");
        }
        _data.resize(oversampled_samples);
        _size = static_cast<unsigned>(oversampled_samples);
        _rate = sampleRate * static_cast<RealType>(ratio);
 
        if (ratio == 1)
        {
            std::ranges::copy(inData, _data.begin());
        }
        else
        {
            upsample(inData, samples, _data);
        }
    }

References fers_signal::Signal::clear(), max, params::oversampleRatio(), and fers_signal::upsample().

Here is the call graph for this function:

operator=() [1/2]

CwSignal & fers_signal::CwSignal::operator= ( const CwSignal &  )

deletenoexcept

operator=() [2/2]

CwSignal & fers_signal::CwSignal::operator= ( CwSignal &&  )

deletenoexcept

render()

std::vector< ComplexType > fers_signal::CwSignal::render ( const std::vector< interp::InterpPoint > &  points, unsigned &  size, RealType  fracWinDelay  ) const

overridevirtual

Renders the signal data.

For CW signals, this is a no-op.

Returns

An empty vector of complex signal data.

Reimplemented from fers_signal::Signal.

Definition at line 48 of file radar_signal.cpp.

    {
        size = 0;
        return {};
    }

References max.

renderSlice()

std::vector< ComplexType > fers_signal::Signal::renderSlice ( const std::vector< interp::InterpPoint > &  points, RealType  outputStartTime, RealType  outputSampleRate, std::size_t  sampleCount, RealType  fracWinDelay  ) const

virtualinherited

Renders a bounded absolute-time slice on the requested output grid.

Definition at line 272 of file radar_signal.cpp.

    {
        auto out = std::vector<ComplexType>(sampleCount);
        if (_size == 0 || _rate <= 0.0 || outputSampleRate <= 0.0 || points.empty())
        {
            return out;
        }
 
        const RealType timestep = 1.0 / outputSampleRate;
        const int filt_length = static_cast<int>(params::renderFilterLength());
        const auto& interp = interp::InterpFilter::getInstance();
 
        auto iter = points.begin();
        auto next = points.size() > 1 ? std::next(iter) : iter;
        const RealType idelay = std::round(_rate * iter->delay);
        RealType sample_time = outputStartTime;
 
        for (std::size_t i = 0; i < sampleCount; ++i)
        {
            while (sample_time > next->time && next != iter)
            {
                iter = next;
                if (std::next(next) != points.end())
                {
                    ++next;
                }
                else
                {
                    break;
                }
            }
 
            auto [amplitude, phase, fdelay, i_sample_unwrap] =
                calculateWeightsAndDelays(iter, next, sample_time, idelay, fracWinDelay);
            const RealType native_position = (sample_time - points.front().time) * _rate;
            const auto source_index = static_cast<int>(std::floor(native_position));
            RealType source_fraction = native_position - static_cast<RealType>(source_index);
            if (source_fraction < 0.0 && source_fraction > -1.0e-12)
            {
                source_fraction = 0.0;
            }
 
            const RealType combined_delay = fdelay + source_fraction;
            const auto delay_unwrap = static_cast<int>(std::floor(combined_delay));
            fdelay = combined_delay - static_cast<RealType>(delay_unwrap);
            i_sample_unwrap += delay_unwrap;
 
            const auto& filt = interp.getFilter(fdelay);
            const ComplexType accum =
                performConvolution(source_index, filt.data(), filt_length, amplitude, i_sample_unwrap);
            out[i] = std::exp(ComplexType(0.0, 1.0) * phase) * accum;
 
            sample_time += timestep;
        }
 
        return out;
    }

References interp::InterpFilter::getInstance(), max, and params::renderFilterLength().

Referenced by fers_signal::Signal::render().

Here is the call graph for this function:

Here is the caller graph for this function:

---

The documentation for this class was generated from the following files:

• packages/libfers/src/signal/radar_signal.h
• packages/libfers/src/signal/radar_signal.cpp