blob: f7e5db2b60ec52034dd4f5f059a83c9fa3041b72 [file] [log] [blame]
alessiob3ec96df2017-05-22 06:57:06 -07001/*
2 * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Jonas Olssona4d87372019-07-05 19:08:33 +020011#include "modules/audio_processing/gain_controller2.h"
12
Alessio Bazzica270f7b52017-10-13 11:05:17 +020013#include <algorithm>
Alessio Bazzica980c4602021-04-14 19:09:17 +020014#include <cmath>
Mirko Bonadei317a1f02019-09-17 17:06:18 +020015#include <memory>
Alessio Bazzica6ee97342021-09-27 17:06:40 +020016#include <numeric>
Alessio Bazzica38901042021-10-14 12:14:21 +020017#include <tuple>
alessiob3ec96df2017-05-22 06:57:06 -070018
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020019#include "api/array_view.h"
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010020#include "modules/audio_processing/agc2/agc2_testing_common.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "modules/audio_processing/audio_buffer.h"
Alex Loiko5e784612018-11-01 14:51:56 +010022#include "modules/audio_processing/test/audio_buffer_tools.h"
23#include "modules/audio_processing/test/bitexactness_tools.h"
Alessio Bazzica270f7b52017-10-13 11:05:17 +020024#include "rtc_base/checks.h"
Hanna Silend7cfbe32022-11-02 19:12:20 +010025#include "test/gmock.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020026#include "test/gtest.h"
alessiob3ec96df2017-05-22 06:57:06 -070027
28namespace webrtc {
29namespace test {
alessiob3ec96df2017-05-22 06:57:06 -070030namespace {
31
Hanna Silend7cfbe32022-11-02 19:12:20 +010032using ::testing::Eq;
33using ::testing::Optional;
34
Alessio Bazzica38901042021-10-14 12:14:21 +020035using Agc2Config = AudioProcessing::Config::GainController2;
Hanna Silena6574902022-11-30 16:59:05 +010036using InputVolumeControllerConfig = InputVolumeController::Config;
Alessio Bazzica38901042021-10-14 12:14:21 +020037
Alessio Bazzica6ee97342021-09-27 17:06:40 +020038// Sets all the samples in `ab` to `value`.
39void SetAudioBufferSamples(float value, AudioBuffer& ab) {
40 for (size_t k = 0; k < ab.num_channels(); ++k) {
41 std::fill(ab.channels()[k], ab.channels()[k] + ab.num_frames(), value);
alessiob3ec96df2017-05-22 06:57:06 -070042 }
43}
44
Alessio Bazzica6ee97342021-09-27 17:06:40 +020045float RunAgc2WithConstantInput(GainController2& agc2,
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010046 float input_level,
Alessio Bazzica6ee97342021-09-27 17:06:40 +020047 int num_frames,
Hanna Silend7cfbe32022-11-02 19:12:20 +010048 int sample_rate_hz,
49 int num_channels = 1,
50 int applied_initial_volume = 0) {
Alessio Bazzica6ee97342021-09-27 17:06:40 +020051 const int num_samples = rtc::CheckedDivExact(sample_rate_hz, 100);
Hanna Silend7cfbe32022-11-02 19:12:20 +010052 AudioBuffer ab(sample_rate_hz, num_channels, sample_rate_hz, num_channels,
53 sample_rate_hz, num_channels);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010054
55 // Give time to the level estimator to converge.
Alessio Bazzica6ee97342021-09-27 17:06:40 +020056 for (int i = 0; i < num_frames + 1; ++i) {
57 SetAudioBufferSamples(input_level, ab);
Hanna Silend7cfbe32022-11-02 19:12:20 +010058 const auto applied_volume = agc2.GetRecommendedInputVolume();
59 agc2.Analyze(i > 0 && applied_volume.has_value() ? *applied_volume
60 : applied_initial_volume,
61 ab);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +020062 agc2.Process(/*speech_probability=*/absl::nullopt,
63 /*input_volume_changed=*/false, &ab);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010064 }
65
66 // Return the last sample from the last processed frame.
Per Ã…hgrend47941e2019-08-22 11:51:13 +020067 return ab.channels()[0][num_samples - 1];
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010068}
69
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010070std::unique_ptr<GainController2> CreateAgc2FixedDigitalMode(
71 float fixed_gain_db,
Alessio Bazzica6ee97342021-09-27 17:06:40 +020072 int sample_rate_hz) {
Alessio Bazzica38901042021-10-14 12:14:21 +020073 Agc2Config config;
74 config.adaptive_digital.enabled = false;
75 config.fixed_digital.gain_db = fixed_gain_db;
76 EXPECT_TRUE(GainController2::Validate(config));
Hanna Silena6574902022-11-30 16:59:05 +010077 return std::make_unique<GainController2>(
78 config, InputVolumeControllerConfig{}, sample_rate_hz,
79 /*num_channels=*/1,
80 /*use_internal_vad=*/true);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +010081}
82
Hanna Silena6574902022-11-30 16:59:05 +010083constexpr InputVolumeControllerConfig kTestInputVolumeControllerConfig{
84 .clipped_level_min = 20,
85 .clipped_level_step = 30,
86 .clipped_ratio_threshold = 0.4,
87 .clipped_wait_frames = 50,
88 .enable_clipping_predictor = true,
89 .target_range_max_dbfs = -6,
90 .target_range_min_dbfs = -70,
91 .update_input_volume_wait_frames = 100,
92 .speech_probability_threshold = 0.9,
93 .speech_ratio_threshold = 1,
94};
95
alessiob3ec96df2017-05-22 06:57:06 -070096} // namespace
97
Alessio Bazzica0c83e152020-10-14 12:49:54 +020098TEST(GainController2, CheckDefaultConfig) {
Alessio Bazzica38901042021-10-14 12:14:21 +020099 Agc2Config config;
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200100 EXPECT_TRUE(GainController2::Validate(config));
alessiob3ec96df2017-05-22 06:57:06 -0700101}
102
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200103TEST(GainController2, CheckFixedDigitalConfig) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200104 Agc2Config config;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200105 // Attenuation is not allowed.
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200106 config.fixed_digital.gain_db = -5.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200107 EXPECT_FALSE(GainController2::Validate(config));
108 // No gain is allowed.
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200109 config.fixed_digital.gain_db = 0.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200110 EXPECT_TRUE(GainController2::Validate(config));
111 // Positive gain is allowed.
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200112 config.fixed_digital.gain_db = 15.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200113 EXPECT_TRUE(GainController2::Validate(config));
114}
alessiob3ec96df2017-05-22 06:57:06 -0700115
Alessio Bazzicaa850e6c2021-10-04 13:35:55 +0200116TEST(GainController2, CheckHeadroomDb) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200117 Agc2Config config;
Alessio Bazzicaa850e6c2021-10-04 13:35:55 +0200118 config.adaptive_digital.headroom_db = -1.0f;
119 EXPECT_FALSE(GainController2::Validate(config));
120 config.adaptive_digital.headroom_db = 0.0f;
121 EXPECT_TRUE(GainController2::Validate(config));
122 config.adaptive_digital.headroom_db = 5.0f;
123 EXPECT_TRUE(GainController2::Validate(config));
124}
125
126TEST(GainController2, CheckMaxGainDb) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200127 Agc2Config config;
Alessio Bazzicaa850e6c2021-10-04 13:35:55 +0200128 config.adaptive_digital.max_gain_db = -1.0f;
129 EXPECT_FALSE(GainController2::Validate(config));
130 config.adaptive_digital.max_gain_db = 0.0f;
131 EXPECT_FALSE(GainController2::Validate(config));
132 config.adaptive_digital.max_gain_db = 5.0f;
133 EXPECT_TRUE(GainController2::Validate(config));
134}
135
136TEST(GainController2, CheckInitialGainDb) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200137 Agc2Config config;
Alessio Bazzicaa850e6c2021-10-04 13:35:55 +0200138 config.adaptive_digital.initial_gain_db = -1.0f;
139 EXPECT_FALSE(GainController2::Validate(config));
140 config.adaptive_digital.initial_gain_db = 0.0f;
141 EXPECT_TRUE(GainController2::Validate(config));
142 config.adaptive_digital.initial_gain_db = 5.0f;
143 EXPECT_TRUE(GainController2::Validate(config));
144}
145
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200146TEST(GainController2, CheckAdaptiveDigitalMaxGainChangeSpeedConfig) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200147 Agc2Config config;
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200148 config.adaptive_digital.max_gain_change_db_per_second = -1.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200149 EXPECT_FALSE(GainController2::Validate(config));
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200150 config.adaptive_digital.max_gain_change_db_per_second = 0.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200151 EXPECT_FALSE(GainController2::Validate(config));
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200152 config.adaptive_digital.max_gain_change_db_per_second = 5.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200153 EXPECT_TRUE(GainController2::Validate(config));
154}
155
156TEST(GainController2, CheckAdaptiveDigitalMaxOutputNoiseLevelConfig) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200157 Agc2Config config;
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200158 config.adaptive_digital.max_output_noise_level_dbfs = 5.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200159 EXPECT_FALSE(GainController2::Validate(config));
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200160 config.adaptive_digital.max_output_noise_level_dbfs = 0.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200161 EXPECT_TRUE(GainController2::Validate(config));
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200162 config.adaptive_digital.max_output_noise_level_dbfs = -5.0f;
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200163 EXPECT_TRUE(GainController2::Validate(config));
164}
165
Hanna Silend7cfbe32022-11-02 19:12:20 +0100166TEST(GainController2,
167 CheckGetRecommendedInputVolumeWhenInputVolumeControllerNotEnabled) {
168 constexpr float kHighInputLevel = 32767.0f;
169 constexpr float kLowInputLevel = 1000.0f;
170 constexpr int kInitialInputVolume = 100;
171 constexpr int kNumChannels = 2;
172 constexpr int kNumFrames = 5;
173 constexpr int kSampleRateHz = 16000;
174
175 Agc2Config config;
176 config.input_volume_controller.enabled = false;
Hanna Silen27fed452022-11-22 15:00:58 +0100177
Hanna Silena6574902022-11-30 16:59:05 +0100178 auto gain_controller = std::make_unique<GainController2>(
179 config, InputVolumeControllerConfig{}, kSampleRateHz, kNumChannels,
180 /*use_internal_vad=*/true);
181
182 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
183
184 // Run AGC for a signal with no clipping or detected speech.
185 RunAgc2WithConstantInput(*gain_controller, kLowInputLevel, kNumFrames,
186 kSampleRateHz, kNumChannels, kInitialInputVolume);
187
188 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
189
190 // Run AGC for a signal with clipping.
191 RunAgc2WithConstantInput(*gain_controller, kHighInputLevel, kNumFrames,
192 kSampleRateHz, kNumChannels, kInitialInputVolume);
193
194 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
195}
196
197TEST(
198 GainController2,
199 CheckGetRecommendedInputVolumeWhenInputVolumeControllerNotEnabledAndSpecificConfigUsed) {
200 constexpr float kHighInputLevel = 32767.0f;
201 constexpr float kLowInputLevel = 1000.0f;
202 constexpr int kInitialInputVolume = 100;
203 constexpr int kNumChannels = 2;
204 constexpr int kNumFrames = 5;
205 constexpr int kSampleRateHz = 16000;
206
207 Agc2Config config;
208 config.input_volume_controller.enabled = false;
209
210 auto gain_controller = std::make_unique<GainController2>(
211 config, kTestInputVolumeControllerConfig, kSampleRateHz, kNumChannels,
212 /*use_internal_vad=*/true);
Hanna Silend7cfbe32022-11-02 19:12:20 +0100213
214 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
215
216 // Run AGC for a signal with no clipping or detected speech.
217 RunAgc2WithConstantInput(*gain_controller, kLowInputLevel, kNumFrames,
218 kSampleRateHz, kNumChannels, kInitialInputVolume);
219
220 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
221
222 // Run AGC for a signal with clipping.
223 RunAgc2WithConstantInput(*gain_controller, kHighInputLevel, kNumFrames,
224 kSampleRateHz, kNumChannels, kInitialInputVolume);
225
226 EXPECT_FALSE(gain_controller->GetRecommendedInputVolume().has_value());
227}
228
229TEST(GainController2,
230 CheckGetRecommendedInputVolumeWhenInputVolumeControllerEnabled) {
231 constexpr float kHighInputLevel = 32767.0f;
232 constexpr float kLowInputLevel = 1000.0f;
233 constexpr int kInitialInputVolume = 100;
234 constexpr int kNumChannels = 2;
235 constexpr int kNumFrames = 5;
236 constexpr int kSampleRateHz = 16000;
237
238 Agc2Config config;
239 config.input_volume_controller.enabled = true;
Hanna Silen27fed452022-11-22 15:00:58 +0100240 config.adaptive_digital.enabled = true;
241
Hanna Silena6574902022-11-30 16:59:05 +0100242 auto gain_controller = std::make_unique<GainController2>(
243 config, InputVolumeControllerConfig{}, kSampleRateHz, kNumChannels,
244 /*use_internal_vad=*/true);
245
246 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
247
248 // Run AGC for a signal with no clipping or detected speech.
249 RunAgc2WithConstantInput(*gain_controller, kLowInputLevel, kNumFrames,
250 kSampleRateHz, kNumChannels, kInitialInputVolume);
251
252 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
253
254 // Run AGC for a signal with clipping.
255 RunAgc2WithConstantInput(*gain_controller, kHighInputLevel, kNumFrames,
256 kSampleRateHz, kNumChannels, kInitialInputVolume);
257
258 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
259}
260
261TEST(
262 GainController2,
263 CheckGetRecommendedInputVolumeWhenInputVolumeControllerEnabledAndSpecificConfigUsed) {
264 constexpr float kHighInputLevel = 32767.0f;
265 constexpr float kLowInputLevel = 1000.0f;
266 constexpr int kInitialInputVolume = 100;
267 constexpr int kNumChannels = 2;
268 constexpr int kNumFrames = 5;
269 constexpr int kSampleRateHz = 16000;
270
271 Agc2Config config;
272 config.input_volume_controller.enabled = true;
273 config.adaptive_digital.enabled = true;
274
275 auto gain_controller = std::make_unique<GainController2>(
276 config, kTestInputVolumeControllerConfig, kSampleRateHz, kNumChannels,
277 /*use_internal_vad=*/true);
Hanna Silend7cfbe32022-11-02 19:12:20 +0100278
279 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
280
281 // Run AGC for a signal with no clipping or detected speech.
282 RunAgc2WithConstantInput(*gain_controller, kLowInputLevel, kNumFrames,
283 kSampleRateHz, kNumChannels, kInitialInputVolume);
284
285 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
286
287 // Run AGC for a signal with clipping.
288 RunAgc2WithConstantInput(*gain_controller, kHighInputLevel, kNumFrames,
289 kSampleRateHz, kNumChannels, kInitialInputVolume);
290
291 EXPECT_TRUE(gain_controller->GetRecommendedInputVolume().has_value());
292}
293
Alessio Bazzica0c83e152020-10-14 12:49:54 +0200294// Checks that the default config is applied.
295TEST(GainController2, ApplyDefaultConfig) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200296 auto gain_controller2 = std::make_unique<GainController2>(
Hanna Silena6574902022-11-30 16:59:05 +0100297 Agc2Config{}, InputVolumeControllerConfig{},
298 /*sample_rate_hz=*/16000, /*num_channels=*/2,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200299 /*use_internal_vad=*/true);
Alessio Bazzica38901042021-10-14 12:14:21 +0200300 EXPECT_TRUE(gain_controller2.get());
alessiob3ec96df2017-05-22 06:57:06 -0700301}
302
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100303TEST(GainController2FixedDigital, GainShouldChangeOnSetGain) {
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200304 constexpr float kInputLevel = 1000.0f;
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100305 constexpr size_t kNumFrames = 5;
306 constexpr size_t kSampleRateHz = 8000;
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200307 constexpr float kGain0Db = 0.0f;
308 constexpr float kGain20Db = 20.0f;
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200309
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100310 auto agc2_fixed = CreateAgc2FixedDigitalMode(kGain0Db, kSampleRateHz);
311
312 // Signal level is unchanged with 0 db gain.
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200313 EXPECT_FLOAT_EQ(RunAgc2WithConstantInput(*agc2_fixed, kInputLevel, kNumFrames,
314 kSampleRateHz),
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100315 kInputLevel);
316
317 // +20 db should increase signal by a factor of 10.
Alessio Bazzica38901042021-10-14 12:14:21 +0200318 agc2_fixed->SetFixedGainDb(kGain20Db);
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200319 EXPECT_FLOAT_EQ(RunAgc2WithConstantInput(*agc2_fixed, kInputLevel, kNumFrames,
320 kSampleRateHz),
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100321 kInputLevel * 10);
alessiob3ec96df2017-05-22 06:57:06 -0700322}
323
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100324TEST(GainController2FixedDigital, ChangeFixedGainShouldBeFastAndTimeInvariant) {
325 // Number of frames required for the fixed gain controller to adapt on the
326 // input signal when the gain changes.
327 constexpr size_t kNumFrames = 5;
Alex Loiko5e784612018-11-01 14:51:56 +0100328
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200329 constexpr float kInputLevel = 1000.0f;
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100330 constexpr size_t kSampleRateHz = 8000;
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200331 constexpr float kGainDbLow = 0.0f;
332 constexpr float kGainDbHigh = 25.0f;
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100333 static_assert(kGainDbLow < kGainDbHigh, "");
Alex Loiko5e784612018-11-01 14:51:56 +0100334
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100335 auto agc2_fixed = CreateAgc2FixedDigitalMode(kGainDbLow, kSampleRateHz);
336
337 // Start with a lower gain.
338 const float output_level_pre = RunAgc2WithConstantInput(
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200339 *agc2_fixed, kInputLevel, kNumFrames, kSampleRateHz);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100340
341 // Increase gain.
Alessio Bazzica38901042021-10-14 12:14:21 +0200342 agc2_fixed->SetFixedGainDb(kGainDbHigh);
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200343 static_cast<void>(RunAgc2WithConstantInput(*agc2_fixed, kInputLevel,
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100344 kNumFrames, kSampleRateHz));
345
346 // Back to the lower gain.
Alessio Bazzica38901042021-10-14 12:14:21 +0200347 agc2_fixed->SetFixedGainDb(kGainDbLow);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100348 const float output_level_post = RunAgc2WithConstantInput(
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200349 *agc2_fixed, kInputLevel, kNumFrames, kSampleRateHz);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100350
351 EXPECT_EQ(output_level_pre, output_level_post);
352}
353
Alessio Bazzica38901042021-10-14 12:14:21 +0200354class FixedDigitalTest
355 : public ::testing::TestWithParam<std::tuple<float, float, int, bool>> {
356 protected:
357 float gain_db_min() const { return std::get<0>(GetParam()); }
358 float gain_db_max() const { return std::get<1>(GetParam()); }
359 int sample_rate_hz() const { return std::get<2>(GetParam()); }
360 bool saturation_expected() const { return std::get<3>(GetParam()); }
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100361};
362
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100363TEST_P(FixedDigitalTest, CheckSaturationBehaviorWithLimiter) {
Alessio Bazzica38901042021-10-14 12:14:21 +0200364 for (const float gain_db : test::LinSpace(gain_db_min(), gain_db_max(), 10)) {
365 SCOPED_TRACE(gain_db);
366 auto agc2_fixed = CreateAgc2FixedDigitalMode(gain_db, sample_rate_hz());
367 const float processed_sample =
368 RunAgc2WithConstantInput(*agc2_fixed, /*input_level=*/32767.0f,
369 /*num_frames=*/5, sample_rate_hz());
370 if (saturation_expected()) {
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200371 EXPECT_FLOAT_EQ(processed_sample, 32767.0f);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100372 } else {
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200373 EXPECT_LT(processed_sample, 32767.0f);
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100374 }
Alex Loiko5e784612018-11-01 14:51:56 +0100375 }
Alex Loiko5e784612018-11-01 14:51:56 +0100376}
377
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100378static_assert(test::kLimiterMaxInputLevelDbFs < 10, "");
Mirko Bonadeic84f6612019-01-31 12:20:57 +0100379INSTANTIATE_TEST_SUITE_P(
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100380 GainController2,
381 FixedDigitalTest,
382 ::testing::Values(
Artem Titovcfea2182021-08-10 01:22:31 +0200383 // When gain < `test::kLimiterMaxInputLevelDbFs`, the limiter will not
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100384 // saturate the signal (at any sample rate).
Alessio Bazzica38901042021-10-14 12:14:21 +0200385 std::make_tuple(0.1f,
386 test::kLimiterMaxInputLevelDbFs - 0.01f,
387 8000,
388 false),
389 std::make_tuple(0.1,
390 test::kLimiterMaxInputLevelDbFs - 0.01f,
391 48000,
392 false),
Artem Titovcfea2182021-08-10 01:22:31 +0200393 // When gain > `test::kLimiterMaxInputLevelDbFs`, the limiter will
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100394 // saturate the signal (at any sample rate).
Alessio Bazzica38901042021-10-14 12:14:21 +0200395 std::make_tuple(test::kLimiterMaxInputLevelDbFs + 0.01f,
396 10.0f,
397 8000,
398 true),
399 std::make_tuple(test::kLimiterMaxInputLevelDbFs + 0.01f,
400 10.0f,
401 48000,
402 true)));
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100403
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200404// Processes a test audio file and checks that the gain applied at the end of
405// the recording is close to the expected value.
406TEST(GainController2, CheckFinalGainWithAdaptiveDigitalController) {
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200407 constexpr int kSampleRateHz = AudioProcessing::kSampleRate48kHz;
408 constexpr int kStereo = 2;
Alessio Bazzica38901042021-10-14 12:14:21 +0200409
410 // Create AGC2 enabling only the adaptive digital controller.
411 Agc2Config config;
412 config.fixed_digital.gain_db = 0.0f;
413 config.adaptive_digital.enabled = true;
Hanna Silena6574902022-11-30 16:59:05 +0100414 GainController2 agc2(config, /*input_volume_controller_config=*/{},
415 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200416 /*use_internal_vad=*/true);
Alessio Bazzica38901042021-10-14 12:14:21 +0200417
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200418 test::InputAudioFile input_file(
419 test::GetApmCaptureTestVectorFileName(kSampleRateHz),
420 /*loop_at_end=*/true);
Henrik Lundin64253a92022-02-04 09:02:48 +0000421 const StreamConfig stream_config(kSampleRateHz, kStereo);
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200422
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200423 // Init buffers.
424 constexpr int kFrameDurationMs = 10;
425 std::vector<float> frame(kStereo * stream_config.num_frames());
426 AudioBuffer audio_buffer(kSampleRateHz, kStereo, kSampleRateHz, kStereo,
427 kSampleRateHz, kStereo);
428
429 // Simulate.
430 constexpr float kGainDb = -6.0f;
431 const float gain = std::pow(10.0f, kGainDb / 20.0f);
432 constexpr int kDurationMs = 10000;
433 constexpr int kNumFramesToProcess = kDurationMs / kFrameDurationMs;
434 for (int i = 0; i < kNumFramesToProcess; ++i) {
435 ReadFloatSamplesFromStereoFile(stream_config.num_frames(),
436 stream_config.num_channels(), &input_file,
437 frame);
438 // Apply a fixed gain to the input audio.
Hanna Silen0c1ad292022-06-16 16:35:45 +0200439 for (float& x : frame) {
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200440 x *= gain;
Hanna Silen0c1ad292022-06-16 16:35:45 +0200441 }
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200442 test::CopyVectorToAudioBuffer(stream_config, frame, &audio_buffer);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200443 agc2.Process(/*speech_probability=*/absl::nullopt,
444 /*input_volume_changed=*/false, &audio_buffer);
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200445 }
446
447 // Estimate the applied gain by processing a probing frame.
448 SetAudioBufferSamples(/*value=*/1.0f, audio_buffer);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200449 agc2.Process(/*speech_probability=*/absl::nullopt,
450 /*input_volume_changed=*/false, &audio_buffer);
Alessio Bazzica6ee97342021-09-27 17:06:40 +0200451 const float applied_gain_db =
452 20.0f * std::log10(audio_buffer.channels_const()[0][0]);
453
454 constexpr float kExpectedGainDb = 5.6f;
455 constexpr float kToleranceDb = 0.3f;
456 EXPECT_NEAR(applied_gain_db, kExpectedGainDb, kToleranceDb);
Alex Loiko5e784612018-11-01 14:51:56 +0100457}
Alessio Bazzica3e4c77f2018-11-01 21:31:38 +0100458
Hanna Silen0c1ad292022-06-16 16:35:45 +0200459// Processes a test audio file and checks that the injected speech probability
460// is ignored when the internal VAD is used.
461TEST(GainController2,
462 CheckInjectedVadProbabilityNotUsedWithAdaptiveDigitalController) {
463 constexpr int kSampleRateHz = AudioProcessing::kSampleRate48kHz;
464 constexpr int kStereo = 2;
465
466 // Create AGC2 enabling only the adaptive digital controller.
467 Agc2Config config;
468 config.fixed_digital.gain_db = 0.0f;
469 config.adaptive_digital.enabled = true;
Hanna Silena6574902022-11-30 16:59:05 +0100470 GainController2 agc2(config, /*input_volume_controller_config=*/{},
471 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200472 /*use_internal_vad=*/true);
Hanna Silena6574902022-11-30 16:59:05 +0100473 GainController2 agc2_reference(config, /*input_volume_controller_config=*/{},
474 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200475 /*use_internal_vad=*/true);
476
477 test::InputAudioFile input_file(
478 test::GetApmCaptureTestVectorFileName(kSampleRateHz),
479 /*loop_at_end=*/true);
480 const StreamConfig stream_config(kSampleRateHz, kStereo);
481
482 // Init buffers.
483 constexpr int kFrameDurationMs = 10;
484 std::vector<float> frame(kStereo * stream_config.num_frames());
485 AudioBuffer audio_buffer(kSampleRateHz, kStereo, kSampleRateHz, kStereo,
486 kSampleRateHz, kStereo);
487 AudioBuffer audio_buffer_reference(kSampleRateHz, kStereo, kSampleRateHz,
488 kStereo, kSampleRateHz, kStereo);
489
490 // Simulate.
491 constexpr float kGainDb = -6.0f;
492 const float gain = std::pow(10.0f, kGainDb / 20.0f);
493 constexpr int kDurationMs = 10000;
494 constexpr int kNumFramesToProcess = kDurationMs / kFrameDurationMs;
495 constexpr float kSpeechProbabilities[] = {1.0f, 0.3f};
496 constexpr float kEpsilon = 0.0001f;
497 bool all_samples_zero = true;
498 for (int i = 0, j = 0; i < kNumFramesToProcess; ++i, j = 1 - j) {
499 ReadFloatSamplesFromStereoFile(stream_config.num_frames(),
500 stream_config.num_channels(), &input_file,
501 frame);
502 // Apply a fixed gain to the input audio.
503 for (float& x : frame) {
504 x *= gain;
505 }
506 test::CopyVectorToAudioBuffer(stream_config, frame, &audio_buffer);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200507 agc2.Process(kSpeechProbabilities[j], /*input_volume_changed=*/false,
508 &audio_buffer);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200509 test::CopyVectorToAudioBuffer(stream_config, frame,
510 &audio_buffer_reference);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200511 agc2_reference.Process(/*speech_probability=*/absl::nullopt,
512 /*input_volume_changed=*/false,
513 &audio_buffer_reference);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200514
515 // Check the output buffers.
516 for (int i = 0; i < kStereo; ++i) {
517 for (int j = 0; j < static_cast<int>(audio_buffer.num_frames()); ++j) {
518 all_samples_zero &=
519 fabs(audio_buffer.channels_const()[i][j]) < kEpsilon;
520 EXPECT_FLOAT_EQ(audio_buffer.channels_const()[i][j],
521 audio_buffer_reference.channels_const()[i][j]);
522 }
523 }
524 }
525 EXPECT_FALSE(all_samples_zero);
526}
527
528// Processes a test audio file and checks that the injected speech probability
529// is not ignored when the internal VAD is not used.
530TEST(GainController2,
531 CheckInjectedVadProbabilityUsedWithAdaptiveDigitalController) {
532 constexpr int kSampleRateHz = AudioProcessing::kSampleRate48kHz;
533 constexpr int kStereo = 2;
534
535 // Create AGC2 enabling only the adaptive digital controller.
536 Agc2Config config;
537 config.fixed_digital.gain_db = 0.0f;
538 config.adaptive_digital.enabled = true;
Hanna Silena6574902022-11-30 16:59:05 +0100539 GainController2 agc2(config, /*input_volume_controller_config=*/{},
540 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200541 /*use_internal_vad=*/false);
Hanna Silena6574902022-11-30 16:59:05 +0100542 GainController2 agc2_reference(config, /*input_volume_controller_config=*/{},
543 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200544 /*use_internal_vad=*/true);
545
546 test::InputAudioFile input_file(
547 test::GetApmCaptureTestVectorFileName(kSampleRateHz),
548 /*loop_at_end=*/true);
549 const StreamConfig stream_config(kSampleRateHz, kStereo);
550
551 // Init buffers.
552 constexpr int kFrameDurationMs = 10;
553 std::vector<float> frame(kStereo * stream_config.num_frames());
554 AudioBuffer audio_buffer(kSampleRateHz, kStereo, kSampleRateHz, kStereo,
555 kSampleRateHz, kStereo);
556 AudioBuffer audio_buffer_reference(kSampleRateHz, kStereo, kSampleRateHz,
557 kStereo, kSampleRateHz, kStereo);
558 // Simulate.
559 constexpr float kGainDb = -6.0f;
560 const float gain = std::pow(10.0f, kGainDb / 20.0f);
561 constexpr int kDurationMs = 10000;
562 constexpr int kNumFramesToProcess = kDurationMs / kFrameDurationMs;
563 constexpr float kSpeechProbabilities[] = {1.0f, 0.3f};
564 constexpr float kEpsilon = 0.0001f;
565 bool all_samples_zero = true;
566 bool all_samples_equal = true;
567 for (int i = 0, j = 0; i < kNumFramesToProcess; ++i, j = 1 - j) {
568 ReadFloatSamplesFromStereoFile(stream_config.num_frames(),
569 stream_config.num_channels(), &input_file,
570 frame);
571 // Apply a fixed gain to the input audio.
572 for (float& x : frame) {
573 x *= gain;
574 }
575 test::CopyVectorToAudioBuffer(stream_config, frame, &audio_buffer);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200576 agc2.Process(kSpeechProbabilities[j], /*input_volume_changed=*/false,
577 &audio_buffer);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200578 test::CopyVectorToAudioBuffer(stream_config, frame,
579 &audio_buffer_reference);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200580 agc2_reference.Process(/*speech_probability=*/absl::nullopt,
581 /*input_volume_changed=*/false,
582 &audio_buffer_reference);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200583 // Check the output buffers.
584 for (int i = 0; i < kStereo; ++i) {
585 for (int j = 0; j < static_cast<int>(audio_buffer.num_frames()); ++j) {
586 all_samples_zero &=
587 fabs(audio_buffer.channels_const()[i][j]) < kEpsilon;
588 all_samples_equal &=
589 fabs(audio_buffer.channels_const()[i][j] -
590 audio_buffer_reference.channels_const()[i][j]) < kEpsilon;
591 }
592 }
593 }
594 EXPECT_FALSE(all_samples_zero);
595 EXPECT_FALSE(all_samples_equal);
596}
597
598// Processes a test audio file and checks that the output is equal when
599// an injected speech probability from `VoiceActivityDetectorWrapper` and
600// the speech probability computed by the internal VAD are the same.
601TEST(GainController2,
602 CheckEqualResultFromInjectedVadProbabilityWithAdaptiveDigitalController) {
603 constexpr int kSampleRateHz = AudioProcessing::kSampleRate48kHz;
604 constexpr int kStereo = 2;
605
606 // Create AGC2 enabling only the adaptive digital controller.
607 Agc2Config config;
608 config.fixed_digital.gain_db = 0.0f;
609 config.adaptive_digital.enabled = true;
Hanna Silena6574902022-11-30 16:59:05 +0100610 GainController2 agc2(config, /*input_volume_controller_config=*/{},
611 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200612 /*use_internal_vad=*/false);
Hanna Silena6574902022-11-30 16:59:05 +0100613 GainController2 agc2_reference(config, /*input_volume_controller_config=*/{},
614 kSampleRateHz, kStereo,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200615 /*use_internal_vad=*/true);
616 VoiceActivityDetectorWrapper vad(config.adaptive_digital.vad_reset_period_ms,
617 GetAvailableCpuFeatures(), kSampleRateHz);
618 test::InputAudioFile input_file(
619 test::GetApmCaptureTestVectorFileName(kSampleRateHz),
620 /*loop_at_end=*/true);
621 const StreamConfig stream_config(kSampleRateHz, kStereo);
622
623 // Init buffers.
624 constexpr int kFrameDurationMs = 10;
625 std::vector<float> frame(kStereo * stream_config.num_frames());
626 AudioBuffer audio_buffer(kSampleRateHz, kStereo, kSampleRateHz, kStereo,
627 kSampleRateHz, kStereo);
628 AudioBuffer audio_buffer_reference(kSampleRateHz, kStereo, kSampleRateHz,
629 kStereo, kSampleRateHz, kStereo);
630
631 // Simulate.
632 constexpr float kGainDb = -6.0f;
633 const float gain = std::pow(10.0f, kGainDb / 20.0f);
634 constexpr int kDurationMs = 10000;
635 constexpr int kNumFramesToProcess = kDurationMs / kFrameDurationMs;
636 for (int i = 0; i < kNumFramesToProcess; ++i) {
637 ReadFloatSamplesFromStereoFile(stream_config.num_frames(),
638 stream_config.num_channels(), &input_file,
639 frame);
640 // Apply a fixed gain to the input audio.
641 for (float& x : frame) {
642 x *= gain;
643 }
644 test::CopyVectorToAudioBuffer(stream_config, frame,
645 &audio_buffer_reference);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200646 agc2_reference.Process(absl::nullopt, /*input_volume_changed=*/false,
647 &audio_buffer_reference);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200648 test::CopyVectorToAudioBuffer(stream_config, frame, &audio_buffer);
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200649 float speech_probability = vad.Analyze(AudioFrameView<const float>(
650 audio_buffer.channels(), audio_buffer.num_channels(),
651 audio_buffer.num_frames()));
652 agc2.Process(speech_probability, /*input_volume_changed=*/false,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200653 &audio_buffer);
654 // Check the output buffer.
655 for (int i = 0; i < kStereo; ++i) {
656 for (int j = 0; j < static_cast<int>(audio_buffer.num_frames()); ++j) {
657 EXPECT_FLOAT_EQ(audio_buffer.channels_const()[i][j],
658 audio_buffer_reference.channels_const()[i][j]);
659 }
660 }
661 }
662}
663
alessiob3ec96df2017-05-22 06:57:06 -0700664} // namespace test
665} // namespace webrtc