cannam@154: /***********************************************************************
cannam@154: Copyright (c) 2006-2011, Skype Limited. All rights reserved.
cannam@154: Redistribution and use in source and binary forms, with or without
cannam@154: modification, are permitted provided that the following conditions
cannam@154: are met:
cannam@154: - Redistributions of source code must retain the above copyright notice,
cannam@154: this list of conditions and the following disclaimer.
cannam@154: - Redistributions in binary form must reproduce the above copyright
cannam@154: notice, this list of conditions and the following disclaimer in the
cannam@154: documentation and/or other materials provided with the distribution.
cannam@154: - Neither the name of Internet Society, IETF or IETF Trust, nor the
cannam@154: names of specific contributors, may be used to endorse or promote
cannam@154: products derived from this software without specific prior written
cannam@154: permission.
cannam@154: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cannam@154: AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cannam@154: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
cannam@154: ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
cannam@154: LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
cannam@154: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
cannam@154: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
cannam@154: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
cannam@154: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
cannam@154: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
cannam@154: POSSIBILITY OF SUCH DAMAGE.
cannam@154: ***********************************************************************/
cannam@154: 
cannam@154: #ifndef SILK_TUNING_PARAMETERS_H
cannam@154: #define SILK_TUNING_PARAMETERS_H
cannam@154: 
cannam@154: #ifdef __cplusplus
cannam@154: extern "C"
cannam@154: {
cannam@154: #endif
cannam@154: 
cannam@154: /* Decay time for bitreservoir */
cannam@154: #define BITRESERVOIR_DECAY_TIME_MS                      500
cannam@154: 
cannam@154: /*******************/
cannam@154: /* Pitch estimator */
cannam@154: /*******************/
cannam@154: 
cannam@154: /* Level of noise floor for whitening filter LPC analysis in pitch analysis */
cannam@154: #define FIND_PITCH_WHITE_NOISE_FRACTION                 1e-3f
cannam@154: 
cannam@154: /* Bandwidth expansion for whitening filter in pitch analysis */
cannam@154: #define FIND_PITCH_BANDWIDTH_EXPANSION                  0.99f
cannam@154: 
cannam@154: /*********************/
cannam@154: /* Linear prediction */
cannam@154: /*********************/
cannam@154: 
cannam@154: /* LPC analysis regularization */
cannam@154: #define FIND_LPC_COND_FAC                               1e-5f
cannam@154: 
cannam@154: /* Max cumulative LTP gain */
cannam@154: #define MAX_SUM_LOG_GAIN_DB                             250.0f
cannam@154: 
cannam@154: /* LTP analysis defines */
cannam@154: #define LTP_CORR_INV_MAX                                0.03f
cannam@154: 
cannam@154: /***********************/
cannam@154: /* High pass filtering */
cannam@154: /***********************/
cannam@154: 
cannam@154: /* Smoothing parameters for low end of pitch frequency range estimation */
cannam@154: #define VARIABLE_HP_SMTH_COEF1                          0.1f
cannam@154: #define VARIABLE_HP_SMTH_COEF2                          0.015f
cannam@154: #define VARIABLE_HP_MAX_DELTA_FREQ                      0.4f
cannam@154: 
cannam@154: /* Min and max cut-off frequency values (-3 dB points) */
cannam@154: #define VARIABLE_HP_MIN_CUTOFF_HZ                       60
cannam@154: #define VARIABLE_HP_MAX_CUTOFF_HZ                       100
cannam@154: 
cannam@154: /***********/
cannam@154: /* Various */
cannam@154: /***********/
cannam@154: 
cannam@154: /* VAD threshold */
cannam@154: #define SPEECH_ACTIVITY_DTX_THRES                       0.05f
cannam@154: 
cannam@154: /* Speech Activity LBRR enable threshold */
cannam@154: #define LBRR_SPEECH_ACTIVITY_THRES                      0.3f
cannam@154: 
cannam@154: /*************************/
cannam@154: /* Perceptual parameters */
cannam@154: /*************************/
cannam@154: 
cannam@154: /* reduction in coding SNR during low speech activity */
cannam@154: #define BG_SNR_DECR_dB                                  2.0f
cannam@154: 
cannam@154: /* factor for reducing quantization noise during voiced speech */
cannam@154: #define HARM_SNR_INCR_dB                                2.0f
cannam@154: 
cannam@154: /* factor for reducing quantization noise for unvoiced sparse signals */
cannam@154: #define SPARSE_SNR_INCR_dB                              2.0f
cannam@154: 
cannam@154: /* threshold for sparseness measure above which to use lower quantization offset during unvoiced */
cannam@154: #define ENERGY_VARIATION_THRESHOLD_QNT_OFFSET           0.6f
cannam@154: 
cannam@154: /* warping control */
cannam@154: #define WARPING_MULTIPLIER                              0.015f
cannam@154: 
cannam@154: /* fraction added to first autocorrelation value */
cannam@154: #define SHAPE_WHITE_NOISE_FRACTION                      3e-5f
cannam@154: 
cannam@154: /* noise shaping filter chirp factor */
cannam@154: #define BANDWIDTH_EXPANSION                             0.94f
cannam@154: 
cannam@154: /* harmonic noise shaping */
cannam@154: #define HARMONIC_SHAPING                                0.3f
cannam@154: 
cannam@154: /* extra harmonic noise shaping for high bitrates or noisy input */
cannam@154: #define HIGH_RATE_OR_LOW_QUALITY_HARMONIC_SHAPING       0.2f
cannam@154: 
cannam@154: /* parameter for shaping noise towards higher frequencies */
cannam@154: #define HP_NOISE_COEF                                   0.25f
cannam@154: 
cannam@154: /* parameter for shaping noise even more towards higher frequencies during voiced speech */
cannam@154: #define HARM_HP_NOISE_COEF                              0.35f
cannam@154: 
cannam@154: /* parameter for applying a high-pass tilt to the input signal */
cannam@154: #define INPUT_TILT                                      0.05f
cannam@154: 
cannam@154: /* parameter for extra high-pass tilt to the input signal at high rates */
cannam@154: #define HIGH_RATE_INPUT_TILT                            0.1f
cannam@154: 
cannam@154: /* parameter for reducing noise at the very low frequencies */
cannam@154: #define LOW_FREQ_SHAPING                                4.0f
cannam@154: 
cannam@154: /* less reduction of noise at the very low frequencies for signals with low SNR at low frequencies */
cannam@154: #define LOW_QUALITY_LOW_FREQ_SHAPING_DECR               0.5f
cannam@154: 
cannam@154: /* subframe smoothing coefficient for HarmBoost, HarmShapeGain, Tilt (lower -> more smoothing) */
cannam@154: #define SUBFR_SMTH_COEF                                 0.4f
cannam@154: 
cannam@154: /* parameters defining the R/D tradeoff in the residual quantizer */
cannam@154: #define LAMBDA_OFFSET                                   1.2f
cannam@154: #define LAMBDA_SPEECH_ACT                               -0.2f
cannam@154: #define LAMBDA_DELAYED_DECISIONS                        -0.05f
cannam@154: #define LAMBDA_INPUT_QUALITY                            -0.1f
cannam@154: #define LAMBDA_CODING_QUALITY                           -0.2f
cannam@154: #define LAMBDA_QUANT_OFFSET                             0.8f
cannam@154: 
cannam@154: /* Compensation in bitrate calculations for 10 ms modes */
cannam@154: #define REDUCE_BITRATE_10_MS_BPS                        2200
cannam@154: 
cannam@154: /* Maximum time before allowing a bandwidth transition */
cannam@154: #define MAX_BANDWIDTH_SWITCH_DELAY_MS                   5000
cannam@154: 
cannam@154: #ifdef __cplusplus
cannam@154: }
cannam@154: #endif
cannam@154: 
cannam@154: #endif /* SILK_TUNING_PARAMETERS_H */