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