File tonemeas_core.h¶

#ifndef DP_TONEMEAS_CORE_H
#define DP_TONEMEAS_CORE_H

#include "doppler/clib_common.h"
#include "doppler/jm_perf.h"
#include "doppler/measure/measure_core.h"
#include "doppler/psd/psd_core.h"
#include "doppler/dp_complex.h"
#include "doppler/fft/fft_core.h"
#include "doppler/spectral/spectral_core.h"
#include "doppler/acc_trace/acc_trace_core.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    dp_psd_state_t *psd;     /* shared averaging PSD core (window+FFT+avg)   */
    float         *pwr;     /* metric working buffer, length nfft          */
    unsigned char *excl;    /* DC/fundamental/harmonic exclusion mask      */
    double enbw;            
    double beta;            /* auto-selected Kaiser shape (from DR target)  */
    size_t lobe_bins;       
    size_t spur_guard_bins; /* fundamental keep-out for spur search (>= L)  */
    size_t n;               
    size_t nfft;            
    size_t n_harm;          /* harmonics tracked (k = 2..n_harm)           */
    double fs;              
    size_t dc_guard;        /* extra bins excluded beyond L around DC      */
} dp_tonemeas_state_t;

dp_tonemeas_state_t *dp_tonemeas_create(size_t n, double fs, size_t n_harmonics,
                                  double full_scale, size_t bits,
                                  double dynamic_range_db, size_t dc_guard);

void dp_tonemeas_destroy(dp_tonemeas_state_t *state);

void dp_tonemeas_reset(dp_tonemeas_state_t *state);

tone_meas_t dp_tonemeas_analyze(dp_tonemeas_state_t *state, const float *x,
                             size_t n_in);

tone_meas_t dp_tonemeas_analyze_complex(dp_tonemeas_state_t *state,
                                     const float _Complex *x, size_t n_in);

time_stats_t dp_tonemeas_time_stats(dp_tonemeas_state_t *state, const float *x,
                                 size_t n_in);

size_t dp_tonemeas_spectrum_dbfs_max_out(dp_tonemeas_state_t *state);

size_t dp_tonemeas_spectrum_dbfs(dp_tonemeas_state_t *state, const float *x,
                              size_t x_len, float *out, size_t max_out);

#ifdef __cplusplus
}
#endif

#endif /* TONEMEAS_CORE_H */