function data = data_ziegelwanger2014(varargin)
%DATA_ZIEGELWANGER2014 Data from Ziegelwanger and Majdak (2014)
% Usage: data = data_ziegelwanger2014(flag)
%
% DATA_ZIEGELWANGER2014(flag) returns results for different HRTF
% databases from Ziegelwanger and Majdak (2014).
%
% The flag may be one of:
%
% 'ARI' ARI database. The output has the following
% fields: data.results and data.subjects.
%
% 'CIPIC' CIPIC database. The output has the following fields:
% data.results and data.subjects.
%
% 'LISTEN' LISTEN database. The output has the following fields.
% data.results and data.subjects.
%
% 'SPHERE_ROT' HRTF sets for a rigid sphere placed in the center of
% the measurement setup and varying rotation. The
% output has the following fields: data.results,
% data.subjects, data.phi, data.theta and data.radius.
%
% 'SPHERE_DIS' HRTF sets for a rigid sphere with various positions in
% the measurement setup. The output has the following fields:
% data.results, data.subjects, data.xM, data.yM,
% data.zM and data.radius.
%
% 'Sphere' HRTF set for a rigid sphere: The
% output has the following fields: data.hM,
% data.meta and data.stimPar.
%
% 'SAT' HRTF set for a rigid sphere combined with a neck and a
% torso: The output has the following fields: data.hM,
% data.meta and data.stimPar.
%
% 'STP' HRTF set for a rigid sphere combined with a neck, a
% torso and a pinna: The output has the following fields:
% data.hM,data.meta and data.stimPar.
%
% 'NH89' HRTF set of listener NH89 of the ARI database: The
% output has the following fields: data.hM,
% data.meta and data.stimPar.
%
% The fields are given by:
%
% 'results' Results for all HRTF sets
%
% 'subjects' IDs for HRTF sets
%
% 'phi' Azimuth of ear position
%
% 'theta' Elevation of ear position
%
% 'radius' sphere radius
%
% 'xM' x-coordinate of sphere center
%
% 'yM' y-coordinate of sphere center
%
% 'zM' z-coordinate of sphere center
%
% 'data' SOFA object
%
% Requirements:
% -------------
%
% 1) SOFA API from http://sourceforge.net/projects/sofacoustics for Matlab (in e.g. thirdparty/SOFA)
%
% 2) Optimization Toolbox for Matlab
%
% 3) Data in auxdata/ziegelwanger2014
%
% Examples:
% ---------
%
% To get results from the ARI database, use:
%
% data=data_ziegelwanger2014('ARI');
%
% See also: ziegelwanger2014, ziegelwanger2014_onaxis,
% ziegelwanger2014_offaxis, exp_ziegelwanger2014
%
% References:
% H. Ziegelwanger and P. Majdak. Modeling the direction-continuous
% time-of-arrival in head-related transfer functions. The Journal of the
% Acoustical Society of America, 135:1278--1293, 2014.
%
%
% Url: http://amtoolbox.org/amt-1.6.0/doc/data/data_ziegelwanger2014.php
% #Author: Harald Ziegelwanger, Acoustics Research Institute, Vienna, Austria
% This file is licensed unter the GNU General Public License (GPL) either
% version 3 of the license, or any later version as published by the Free Software
% Foundation. Details of the GPLv3 can be found in the AMT directory "licences" and
% at <https://www.gnu.org/licenses/gpl-3.0.html>.
% You can redistribute this file and/or modify it under the terms of the GPLv3.
% This file is distributed without any warranty; without even the implied warranty
% of merchantability or fitness for a particular purpose.
% TODO: describe Data in description
%% ------ Check input options --------------------------------------------
% Define input flags
definput.flags.type = {'missingflag','ARI','CIPIC','LISTEN','SPHERE_DIS','SPHERE_ROT','NH89','Sphere','SAT','STP'};
definput.import={'amt_cache'}; % get the flags of amt_cache
% Parse input options
[flags,~] = ltfatarghelper({},definput,varargin);
if flags.do_missingflag
flagnames=[sprintf('%s, ',definput.flags.type{2:end-2}),...
sprintf('%s or %s',definput.flags.type{end-1},definput.flags.type{end})];
error('%s: You must specify one of the following flags: %s.',upper(mfilename),flagnames);
end
%% ARI database
if flags.do_ARI
tmp=amt_load('ziegelwanger2014','info.mat');
data=tmp.info.ARI;
results=amt_cache('get','ARI',flags.cachemode);
if isempty(results)
for ii=1:length(data.subjects)
amt_disp(['Recalculate data for subject ' num2str(ii) '/' num2str(length(data.subjects)) ' (' data.subjects{ii} ') of ARI database']);
Obj=amt_load('ziegelwanger2014', [ 'ARI_' data.subjects{ii} '.sofa']);
[~,tmp]=ziegelwanger2014(Obj,4,0,0);
toaEst=tmp.toa;
[~,results(ii).MCM{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,results(ii).MCM{2}]=ziegelwanger2014(Obj,toaEst,[0.05 0.01],1e-8);
end
amt_cache('set','ARI',results);
end
data.results=results;
end
%% CIPIC database
if flags.do_CIPIC
tmp=amt_load('ziegelwanger2014','info.mat');
data=tmp.info.CIPIC;
results=amt_cache('get','CIPIC',flags.cachemode);
if isempty(results)
for ii=1:length(data.subjects)
amt_disp(['Recalculate data for subject ' num2str(ii) filesep num2str(length(data.subjects)) ' of CIPIC database']);
Obj=amt_load('ziegelwanger2014', [ 'CIPIC_' data.subjects{ii} '.sofa']);
[~,tmp]=ziegelwanger2014(Obj,4,0,0);
toaEst=tmp.toa;
[~,results(ii).MCM{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,results(ii).MCM{2}]=ziegelwanger2014(Obj,toaEst,[0.05 0.01],1e-8);
end
amt_cache('set','CIPIC',results);
end
data.results=results;
end
%% LISTEN database
if flags.do_LISTEN
tmp=amt_load('ziegelwanger2014','info.mat');
data=tmp.info.LISTEN;
results=amt_cache('get','LISTEN',flags.cachemode);
if isempty(results)
for ii=1:length(data.subjects)
if ~strcmp(data.subjects{ii},'34')
amt_disp(['Recalculate data for subject ' num2str(ii) filesep num2str(length(data.subjects)) ' of LISTEN database']);
Obj=amt_load('ziegelwanger2014', [ 'LISTEN_' data.subjects{ii} '.sofa']);
[~,tmp]=ziegelwanger2014(Obj,4,0,0);
toaEst=tmp.toa;
[~,results(ii).MCM{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,results(ii).MCM{2}]=ziegelwanger2014(Obj,toaEst,[0.05 0.01],1e-8);
end
end
amt_cache('set','LISTEN',results);
end
data.results=results;
end
%% SPHERE (Displacement) database
if flags.do_SPHERE_DIS
tmp=amt_load('ziegelwanger2014','info.mat');
data=tmp.info.Displacement;
results=amt_cache('get','SPHERE_DIS',flags.cachemode);
if isempty(results)
results.p_onaxis=zeros(4,2,length(data.subjects));
results.p_offaxis=zeros(7,2,length(data.subjects));
for ii=1:length(data.subjects)
amt_disp(['Recalculate data for subject ' num2str(ii) filesep num2str(length(data.subjects)) ' of SPHERE_DIS database']);
Obj=amt_load('ziegelwanger2014', [ 'Sphere_Displacement_' data.subjects{ii} '.sofa']);
[~,tmp]=ziegelwanger2014(Obj,4,0,0);
toaEst=tmp.toa;
[~,results(ii).MCM{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,results(ii).MCM{2}]=ziegelwanger2014(Obj,toaEst,[0.05 0.01],1e-8);
end
amt_cache('set','SPHERE_DIS',results);
end
data.results=results;
end
%% SPHERE (Rotation) database
if flags.do_SPHERE_ROT
tmp=amt_load('ziegelwanger2014','info.mat');
data=tmp.info.Rotation;
results=amt_cache('get','SPHERE_ROT',flags.cachemode);
if isempty(results)
results.p=zeros(4,2,length(data.phi));
for ii=1:length(data.subjects)
amt_disp(['Recalculate data for subject ' num2str(ii) filesep num2str(length(data.subjects)) ' of SPHERE_ROT database']);
Obj=amt_load('ziegelwanger2014', [ 'Sphere_Rotation_' data.subjects{ii} '.sofa']);
[~,tmp]=ziegelwanger2014(Obj,1,0,0);
toaEst=tmp.toa;
[~,results(ii).MAX{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,tmp]=ziegelwanger2014(Obj,2,0,0);
toaEst=tmp.toa;
[~,results(ii).CTD{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,tmp]=ziegelwanger2014(Obj,3,0,0);
toaEst=tmp.toa;
[~,results(ii).AGD{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,tmp]=ziegelwanger2014(Obj,4,0,0);
toaEst=tmp.toa;
[~,results(ii).MCM{1}]=ziegelwanger2014(Obj,toaEst,0,1e-8);
[~,results(ii).MCM{2}]=ziegelwanger2014(Obj,toaEst,[0.05 0.01],1e-8);
end
amt_cache('set','SPHERE_ROT',results);
end
data.results=results;
end
%% ARI database (NH89)
if flags.do_NH89
data=amt_load('ziegelwanger2014', 'ARI_NH89.sofa');
toaEst=amt_cache('get','NH89',flags.cachemode);
if isempty(toaEst)
[~,tmp]=ziegelwanger2014(data,1,0,0);
toaEst{1}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,2,0,0);
toaEst{2}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,3,0,0);
toaEst{3}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,4,0,0);
toaEst{4}=tmp.toa;
amt_cache('set','NH89',toaEst);
end
data.Data.toaEst=toaEst;
end
%% Sphere
if flags.do_Sphere
data=amt_load('ziegelwanger2014', 'Sphere.sofa');
toaEst=amt_cache('get','Sphere',flags.cachemode);
if isempty(toaEst)
[~,tmp]=ziegelwanger2014(data,1,0,0);
toaEst{1}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,2,0,0);
toaEst{2}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,3,0,0);
toaEst{3}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,4,0,0);
toaEst{4}=tmp.toa;
amt_cache('set','Sphere',toaEst);
end
data.Data.toaEst=toaEst;
end
%% Sphere and Torso
if flags.do_SAT
data=amt_load('ziegelwanger2014', 'SAT.sofa');
toaEst=amt_cache('get','SAT',flags.cachemode);
if isempty(toaEst)
[~,tmp]=ziegelwanger2014(data,1,0,0);
toaEst{1}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,2,0,0);
toaEst{2}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,3,0,0);
toaEst{3}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,4,0,0);
toaEst{4}=tmp.toa;
amt_cache('set','SAT',toaEst);
end
data.Data.toaEst=toaEst;
end
%% Sphere, Torso and Pinna
if flags.do_STP
data=amt_load('ziegelwanger2014', 'STP.sofa');
toaEst=amt_cache('get','STP',flags.cachemode);
if isempty(toaEst)
[~,tmp]=ziegelwanger2014(data,1,0,0);
toaEst{1}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,2,0,0);
toaEst{2}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,3,0,0);
toaEst{3}=tmp.toa;
[~,tmp]=ziegelwanger2014(data,4,0,0);
toaEst{4}=tmp.toa;
amt_cache('set','STP',toaEst);
end
data.Data.toaEst=toaEst;
end