analysis.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
  uint64_t total_samples;     // Total samples processed
  float peak_level;           // Maximum sample value
  float rms_level;            // RMS (root mean square) level
  uint64_t clipping_count;    // Samples > 1.0 (clipping)
  uint64_t silent_samples;    // Samples < 0.001 (silence threshold)
  float dc_offset;            // DC bias in signal
  uint32_t packets_count;     // Number of packets
  uint32_t packets_dropped;   // Dropped packets
  int64_t timestamp_start_ns; // Start timestamp (nanoseconds)
  int64_t timestamp_end_ns;   // End timestamp (nanoseconds)
  // Quality indicators for "scratchy/distorted" detection
  uint64_t jitter_count;          // Rapid amplitude changes (jitter events)
  uint64_t discontinuity_count;   // Packet arrival gaps (sparse delivery)
  uint64_t avg_packet_spacing_ns; // Average time between packets (nanoseconds)
  uint64_t max_gap_ns;            // Largest gap between consecutive packets (nanoseconds)
  // Beep/tone artifact detection
  uint64_t beep_events;   // Short tonal bursts (codec artifacts, system beeps)
  uint64_t tonal_samples; // Samples in tonal/beep-like patterns
} audio_analysis_stats_t;

int audio_analysis_init(void);

void audio_analysis_track_sent_sample(float sample);

void audio_analysis_track_sent_packet(size_t size);

void audio_analysis_track_received_sample(float sample);

void audio_analysis_track_received_packet(size_t size);

const audio_analysis_stats_t *audio_analysis_get_sent_stats(void);

const audio_analysis_stats_t *audio_analysis_get_received_stats(void);

void audio_analysis_print_report(void);

void audio_analysis_set_aec3_metrics(double echo_return_loss, double echo_return_loss_enhancement, uint64_t delay_ns);

void audio_analysis_destroy(void);
 
#ifdef __cplusplus
} /* extern "C" */
#endif