Add algorithm for Residual Echo Detector.

webrtc/modules/audio_processing/echo_detector/echo_detector.h

 /*
  *  Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
 #ifndef WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_DETECTOR_ECHO_DETECTOR_H_
 #define WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_DETECTOR_ECHO_DETECTOR_H_
 
-#include <stddef.h>
+#include <vector>
+
 #include "webrtc/base/array_view.h"
+#include "webrtc/modules/audio_processing/echo_detector/circular_buffer.h"
+#include "webrtc/modules/audio_processing/echo_detector/mean_variance_estimator.h"
+#include "webrtc/modules/audio_processing/echo_detector/normalized_covariance_estimator.h"
+#include "webrtc/modules/audio_processing/echo_detector/sliding_window_minimum.h"
 
 namespace webrtc {
 
 class EchoDetector {
  public:
-  EchoDetector() {}
-  ~EchoDetector() {}
+  EchoDetector();
+  ~EchoDetector();
 
-  void BufferFarend(const rtc::ArrayView<const float>& farend);
+  void BufferRender(rtc::ArrayView<const float> render);
 
-  void Process(const rtc::ArrayView<const float>& nearend);
+  void Process(rtc::ArrayView<const float> nearend);
 
-  void Initialize(int sample_rate_hz);
+  void Initialize();
+
+  float echo_likelihood() const { return echo_likelihood_; }
+
+ private:
+  static constexpr size_t kLookbackFrames = 650;
+  // TODO(ivoc): Verify the size of this buffer.
+  static constexpr size_t kRenderBufferSize = 30;
+
+  // Buffer for storing the power of incoming farend buffers. This is needed for
+  // cases where calls to BufferFarend and Process are jittery.
+  CircularBuffer render_buffer_ = CircularBuffer(kRenderBufferSize);
+  // Keep track of the minimum of the size of the render buffer during the
+  // previous kRenderBufferSize updates, if this is larger than 0, it indicates
+  // clock drift and should be corrected.
+  SlidingWindowMinimum minimum_render_buffer_size_ =
+      SlidingWindowMinimum(kRenderBufferSize);

[peah-webrtc, 2016/10/19 14:45:26]

Call constructor immediately to avoid the copy.

[ivoc, 2016/10/20 14:04:36]

Done.

+
+  // Circular buffers containing delayed versions of the power, mean and
+  // standard deviation, for calculating the delayed covariance values.
+  std::vector<float> render_power_ = std::vector<float>(kLookbackFrames);
+  std::vector<float> render_power_mean_ = std::vector<float>(kLookbackFrames);
+  std::vector<float> render_power_std_dev_ =
+      std::vector<float>(kLookbackFrames);
+  // Covariance estimates for different delay values.
+  std::vector<NormalizedCovarianceEstimator> covariance_ =

[peah-webrtc, 2016/10/19 14:45:26]

Since the vector store several covariance estimates, what about naming it
covariances_ ?

[ivoc, 2016/10/20 14:04:36]

Done.

+      std::vector<NormalizedCovarianceEstimator>(kLookbackFrames);
+  // Index where next element should be inserted in all of the above circular
+  // buffers.
+  size_t next_insertion_index_ = 0;
+
+  MeanVarianceEstimator render_variance_;
+  MeanVarianceEstimator capture_variance_;
+  // Current echo likelihood.
+  float echo_likelihood_ = 0.f;
 };
 
 }  // namespace webrtc
 
 #endif  // WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_DETECTOR_ECHO_DETECTOR_H_