THE AUDITORY MODELING TOOLBOX

This documentation page applies to an outdated major AMT version. We show it for archival purposes only.
Click here for the documentation menu and here to download the latest AMT (1.6.0).

View the code

Go to function

BAUMGARTNER2017 - Model for sound externalization

Usage

[E,lat] = baumgartner2017( target,template )

Input parameters

target binaural impulse response(s) referring to the directional transfer function(s) (DFTs) of the target sound(s). Option 1: given in SOFA format -> sagittal plane DTFs will be extracted internally. Option 2: binaural impulse responses of all available listener-specific DTFs of the sagittal plane formated according to the following matrix dimensions: time x direction x channel/ear
template binaural impulse responses of all available listener-specific DTFs of the sagittal plane referring to the perceived lateral angle of the target sound. Options 1 & 2 equivalent to target.

Output parameters

E predicted degree of externalization
lat lateral angle as predicted by wierstorf2013 model

baumgartner2017(...) is a model for sound externalization. It bases on the comparison of the intra-aural internal representation of the incoming sound with a template and results in a probabilistic prediction of polar angle response.

baumgartner2017 accepts the following optional parameters:

'fs',fs Define the sampling rate of the impulse responses. Default value is 48000 Hz.
'S',S Set the listener-specific sensitivity threshold (threshold of the sigmoid link function representing the psychometric link between transformation from the distance metric and similarity index) to S. Default value is 1.
'lat',lat Set the apparent lateral angle of the target sound to lat. Default value is 0 degree (median SP).
'stim',stim Define the stimulus (source signal without directional features). As default an impulse is used.
'fsstim',fss Define the sampling rate of the stimulus. Default value is 48000 Hz.
'flow',flow Set the lowest frequency in the filterbank to flow. Default value is 700 Hz.
'fhigh',fhigh Set the highest frequency in the filterbank to fhigh. Default value is 18000 Hz.
'space',sp Set spacing of auditory filter bands (i.e., distance between neighbouring bands) to sp in number of equivalent rectangular bandwidths (ERBs). Default value is 1 ERB.
'do',do Set the differential order of the spectral gradient extraction to do. Default value is 1 and includes restriction to positive gradients inspired by cat DCN functionality.
'bwcoef',bwc Set the binaural weighting coefficient bwc. Default value is 13 degrees.

Requirements:

  1. SOFA API from http://sourceforge.net/projects/sofacoustics for Matlab (in e.g. thirdparty/SOFA)
  2. Data in hrtf/baumgartner2017
  3. Circular Statistics Toolbox from http://www.mathworks.com/matlabcentral/fileexchange/10676-circular-statistics-toolbox--directional-statistics-

Build with Bootstrap