razr_cfg_default.m

function cfg = razr_cfg_default
% RAZR_CFG_DEFAULT - Returns RAZR's default configuration.
%
% DO NOT EDIT THIS FILE!
%
% To change the configuration or to add fields, edit the file RAZR_CFG_USER.M.
% (It is automatically created when you run razr for the first time.)
% Internally, RAZR_CFG_USER overloads RAZR_CFG_DEFAULT.
% You can also create your own copy of RAZR_CFG_USER.M, e.g., a file called
% MY_RAZR_CFG.M. By editing the file SELECT_RAZR_CFG.M it can then be specified
% that your created MY_RAZR_CFG overloads RAZR_CFG_DEFAULT.
%
% Usage:
%   cfg = RAZR_CFG_DEFAULT
%
% See also: RAZR_CFG_USER, SELECT_RAZR_CFG

%------------------------------------------------------------------------------
% RAZR engine for Mathwork's MATLAB
%
% Version 0.93
%
% Author(s): Torben Wendt
%
% Copyright (c) 2014-2017, Torben Wendt, Steven van de Par, Stephan Ewert,
% University Oldenburg, Germany.
%
% This work is licensed under the
% Creative Commons Attribution-NonCommercial-NoDerivs 4.0 International
% License (CC BY-NC-ND 4.0).
% To view a copy of this license, visit
% http://creativecommons.org/licenses/by-nc-nd/4.0/ or send a letter to
% Creative Commons, 444 Castro Street, Suite 900, Mountain View, California,
% 94041, USA.
%------------------------------------------------------------------------------


s = filesep;

%% Paths to HRTF databases and SOFA API

% Replace 'path_to' by the path to the directory where you have stored the SOFA
% API for Matlab/Octave. You can download the API from:
% https://www.sofaconventions.org/mediawiki/index.php/Software_and_APIs
cfg.sofa_api_path = ['path_to', s, 'API_MO'];

% Replace 'path_to_database' below by the paths to the HRTF-database locations
% on your harddrive. Fields have the format "hrtf_path__<shortcut>", where
% <shortcut> is the key associated with a certain database, e.g. cipic. It is
% used by setting the option op.hrtf_database = '<shortcut>'.
% See also EXAMPLES/EXAMPLE_HRTF.M

% Templates for some SOFA-file [0] shortcuts:
cfg.sofa_file__fabian     = fullfile('path_to_database', 'FABIAN_HRIR_measured_HATO_0.sofa'); % [1]
cfg.sofa_file__cipic      = fullfile('path_to_database', 'subject_021.sofa');                 % [2]
cfg.sofa_file__mitkemar   = fullfile('path_to_database', 'mit_kemar_normal_pinna.sofa');      % [3]
cfg.sofa_file__mitkemar_l = fullfile('path_to_database', 'mit_kemar_large_pinna.sofa');       % [3]
cfg.sofa_file__kayser     = fullfile('path_to_database', 'Kayser2009_Anechoic.sofa');         % [4]

% Templates for some non-SOFA database shortcuts:
cfg.hrtf_path__cipic  = ['path_to_database', s, 'CIPIC_hrtf_database', s, 'standard_hrir_database'];        % [2]
cfg.hrtf_path__kayser = ['path_to_database', s, 'Kayser_HRIR_Database', s, 'HRIR_database_mat', s, 'hrir']; % [4]
cfg.hrtf_path__thiem  = ['path_to_database', s, 'HRTF_thiemann'];                                           % [5]
cfg.hrtf_path__mk2    = ['path_to_database', s, 'TASP_MK2_Results', s 'ImpulseResponses', s, 'HRIR'];       % [6]

% References:
% [0] https://www.sofaconventions.org/
% [1] Brinkmann, F., Lindau, A., Weinzierl, S., Geissler, G., & van de Par, S.
%     (2013). A high resolution head-related transfer function database including
%     different orientations of head above the torso. In Proceedings of the
%     AIA-DAGA 2013 Conference on Acoustics.
% [2] Algazi, V. R., et al. (2001), The CIPIC HRTF Database, Proc. 2001 IEEE
%     Workshop on Applications of Signal Processing to Audio and Electroacoustics
% [3] Gardner, B. and Martin, K. (2000): HRTF Measurements of a KEMAR Dummy-Head
%     Microphone. http://sound.media.mit.edu/resources/KEMAR.html
% [4] Kayser, H., et al. (2009): Database of multichannel in-ear and behind-the-
%     ear head-related and binaural room impulse responses, EURASIP Journal on
%     Advances in Signal Processing
% [5] Thiemann, J., et al. (2015): Multiple Model High-Spatial Resolution HRTF
%     Measurements, DAGA 2015
% [6] Cortex MK2 dummy head, database measured at Uni Oldenburg, not published yet

%% Filenames (inlcuding path and extension) for sound samples used by APPLY_RIR

samples_path = [get_razr_path, s, 'base', s, 'external', s, 'samples'];
cfg.sample__olsa1 = fullfile(samples_path, '40938.wav');
cfg.sample__olsa2 = fullfile(samples_path, '84616.wav');
cfg.sample__olsa3 = fullfile(samples_path, '06044.wav');

%% Headphone equalization files
% Fieldnames must have the following format:
% hp_eq__<headphone_key>_<samplingrate>

cfg.hp_eq__hd650_44100 = fullfile(get_razr_path, 'analysis_tools', 'headphone_eq', 'hd650_44k.mat');
cfg.hp_eq__hd650_48000 = fullfile(get_razr_path, 'analysis_tools', 'headphone_eq', 'hd650_48k.mat');

% Key string for default headphone equalization (used by APPLY_RIR):
cfg.default_headphone = 'none';  % supported up to now: 'none', 'hd650'