THE AUDITORY MODELING TOOLBOX

Applies to version: 1.0.0

View the code

Go to function

Changes - throughout the release history of the AMT

Description

Version 1.0.0 (May 2021)

Core functionality:
  • core functions (amt_*.m) moved to the directory 'core'
  • all auxdata, cache, and hrtf moved from sofaacoustics.org to amtoolbox.org
  • NEW: automated toolbox download, new banner, new display style, availability check for matlab toolboxes and octave packages
  • NEW: amt_stop: removes paths associated to current AMT session and deletes persistent variables in the AMT core functions
  • NEW: amt_subdir: performs recursive search in subdirectories
  • NEW: amt_extern: interface to external environments such as Python
  • NEW: amt_configuration: provides configuration of the current AMT session, sets amt_cache, amt_auxdatapath, amt_auxdataurl, and amt_flags
  • NEW: amt_info: information on the authorship, license, and technical requirements of a model
  • emuexp renamed to amt_emuexp
  • NEW: incremental version search in amt_cache and amt_load: search in older AMT versions for files if not found in current AMT version
  • amt_disp: debug flag included, progress flag removed.
  • amt version: module display removed
  • lock of persistent variables added to the core functions
Signal-processing functionality:
  • signal level convention switched to SI with \(20 \mu Pa\) as reference for SPL calculation, i.e., RMS of corresponds to the SPL of 94 dB
  • first dimension is time when calling a model
Common functions (was 'general' previously):
  • siiweightings renamed to f2siiweightings
  • setdbspl renamed to scaletodbspl
  • bmdistance and greenwood integrated in f2bmdistance
  • NEW: erb2fc
  • NEW: f2erb
  • NEW: fc2erb
  • NEW: phon2sone
  • NEW: sone2phon
  • NEW: gammachirp
  • NEW: erbest
  • NEW: fade
  • NEW: infamplitudeclip
  • NEW: interpolation
Data:
  • NEW: data_lyon2011
  • NEW: data_li2020
Plot:
  • NEW: plot_bruce2018
  • NEW: plot_mckenzie2021
  • NEW: plot_moore2016
  • NEW: demo_lyon2011
  • NEW: demo_lyon2011_compressivefunction
  • NEW: demo_lyon2011_impulseresponses
  • NEW: demo_bruce2018
  • NEW: demo_bruce2018_auditorynerveresponse
  • NEW: demo_carney2015
  • NEW: demo_ewert2000
  • NEW: demo_king2019
  • NEW: demo_verhulst2015
  • NEW: demo_verhulst2018
  • NEW: demo_hauth2020
  • NEW: demo_chen2011
  • NEW: demo_mckenzie2021
  • NEW: demo_baumgartner2021
  • NEW: demo_mclachlan2021
Experiments:
  • bug fix: exp_gammatone
  • NEW: exp_engel2021
  • NEW: exp_bruce2018
  • NEW: exp_osses2022
  • NEW: exp_relanoiborra2019
  • NEW: exp_verhulst2018
  • NEW: exp_chen2011
  • NEW: exp_mckenzie2021
  • NEW: exp_osses2021
  • NEW: exp_barumerli2021
  • NEW: exp_baumgartner2021
  • NEW: exp_li2020
Models and Modelstages:
  • NEW: lyon2011
  • NEW: verhulst2015
  • NEW: verhulst2018
  • NEW: bruce2018
  • NEW: carney2015
  • NEW: king2019
  • NEW: relanoiborra2019
  • NEW: hauth2020
  • NEW: osses2021
  • NEW: mckenzie2021
  • NEW: chen2011
  • NEW: moore2016
  • NEW: baumgartner2021
  • NEW: li2020
  • NEW: barumerli2021

Version 0.10.0 (May 2020)

  • baumgartner2020: sound-externalization model provided
  • reijnier2014: ideal-observer spherical sound-localization model based on Bayesian statistics provided
  • exp_reijniers2014: figures from conference proceedings Barumerli et al. (2020, AES and FA) evaluating reijniers2014 added.

Version 0.9.9 (September 2017)

  • data_baumgartner2017 provided
  • data_baumgartner2017looming provided)
  • kelavas2015 improved (appears in the code and documentation now)
  • bug #78 fixed: hohmann2002_process did not work for multiband input signals.

Version 0.9.8 (12.7.2017)

Compatibility breaks:
  • amt* --> amt_*
    • Use amt_start to start the AMT
    • Legacy files provided but will be removed in the future.
    • amthelp --> amt_version
  • gfb --> hohmann2002. Legacy files provided. See note #11 for more details.
  • zilany2007humanized --> zilany2007. Legacy file provided.
  • drnl --> lopezpoveda2001. Legacy file provided.
  • modfilterbankepsm --> ewert2000. No legacy file.
  • HRTFs: only SOFA files allowed now.
  • Functions creating/modifying signals have the prefix sig_ now:
    • Legacy files provided but will be removed in the future. - irns --> sig_yost1996 - whitenoiseburst --> sig_whitenoiseburst - transposedtone --> sig_transposedtone - perfectsweep --> sig_linsweep - notchednoise --> sig_notchednoise - bmsin --> sig_lindemann1986 - simulatedimpulseresponse --> sig_joergensen2011 - itdsin --> sig_itdsin - ildsin --> sig_ildsin - itdildsin --> sig_itdildsin - competingtalkers -> sig_competingtalkers - breebaart2001siggen --> sig_breebaart2001 - bincorrnoise --> sig_bincorrnoise - bandpassnoisefreq --> sig_bandpassnoise
  • Model stages in modelstages have the format modelXX_stageYY now:
    • modelXXstageYY --> modelXX_stageYY
    • ffGn --> zilany2014_ffGn
    • breebaart2001preproc --> breebaart2001_preproc
    • No legacy files provided. Adapt your code if directly calling model stages from your code.
New
  • baumgartner2017: sound externalization model
  • baumgartner2016: level-dependent sagittal-plane sound localization model for NH and HI listeners
  • hohmann2002: the gfb_ framework of Gammatone filterbank integrated as hohmann2002 framework
  • kelvasa2015: sound localization in cochlear-implant listeners
  • emuexp: emulation of experiments using interative runs like 3-AFC
  • breebaart2001_centralproc: decision stage from Breebaart et al. (2001).
  • exp_breebaart2001: reproduces results from Breebaart et al. (2001) based on emuexp
  • model initiative: interface to the model initiative (Dietz et al. 2016)
Structural changes:
  • baumgartner2014 decomposed into model stages
  • exp_spille2013 merged into exp_dietz2011
  • directories re-structured:
    • main scripts of a model go to: model. They are called nameyear
    • scripts with model stages (model scripts other than the main one) go to: modelstages. They are called nameyear_postfix
    • scripts not being part of a specific model go to: general. They do not (!) start with model name.
    • scripts generating audio signals go to: signals. They are called sig_nameyear or sig_functionality
    • scripts returning measured data go to: data. They are called data_nameyear
    • scripts with default parameters of other scripts go to: defaults. They are called arg_callingfunction
    • files being compiled to mex files go to: mex. In order to be compiled, they must have the prefix comp_
    • files being compiled to oct files go to: oct
    • other files requiring compilation/installation go to: bin. Their compilation must be considered in make.bat (Windows) and Makefile (Linux/MacOS).
    • HRTFs go to hrtfs. They are in SOFA and will be downloaded on the fly.
    • Lagecy files providing backwards compatibility fo to: legacy
    • binaural, monaural, speech, filters removed
Other updates:
  • dietz2011: minor bug fixes
  • data_joergensen2011: completion of data
  • exp_baumgartner2014: new figures, compatibility improved
  • demo_hohmann2002: new figures
  • installation simplified (amt_mex does all the installation now)

Version 0.9.7 (10.6.2015)

New:
  • Caching of data: see amt_cache and the cache directory.
  • Automatic download of auxiliary data. See amt_load and the auxdata directory.
  • Control for messages output in the command line. See amt_disp.
  • SOFA files for HRTFs: requires SOFA API, see SOFAload.
  • Models: zilany2014, joergensen2011, joergensen2013, georganti2013
  • Signals: sig_joergensen2011
  • Clean documentation (no errors, no warnings).
  • makefile for Linux, compiling of cpp files
Structure changes:
  • arg_ functions moved to arg directory, comp_ functions moved to mex, directory comp removed
  • plot* functions renamed to plot_* and moved to plot directory
  • amt_start and amt_mex improved
  • readme file for sourceforge added
  • reference directory removed (it was a directory with original contributions to the AMT)
Other changes:
  • interpolation for various polar-angle samplings
  • added new experiment in exp_baumgartner2014: fig5_baumgartner2015aro
  • stability improvements in baumgartner2014
  • minor bugfix in demo_baumgartner2013 and doc update in baumgartner2014
  • exp_lindemann1986: fig 14b disabled: it takes ages and is wrong anyway...
  • added reference for verhulst2012
  • wierstorf2013: additional files for HRTF handling removed, load the itd-to-angle look-up table with data_wierstorf2013.m now.
  • hrtf/enzner2008 removed (enzner2008 data are in auxdata now)
  • langendijk2002: data and HRTFs removed from repository (are required data)
  • changed the order of announcements on amt_start
  • jelfs2011: removed dependency on read_hrir
  • plotjelfs2011 moved to demo_jelfs2011.m (plotjelfs2011 was actually a demo).
  • progress output supressed in the documentation
  • amt_disp introduced for displaying information depending on the start-up condition of the AMT.
  • enzner2008 and exp_enzner2008 split in the model and experiment part.
  • exp_georganti2013 works for me. Documentation is missing yet.
  • may2011 documentation integrated
  • 2014 version of may2011 added. demo_may2011 works but documentation invalid yet.
  • extractsp: stability improvement
  • minor documentation and stability updates, new function baumgartner2014parametrization and functionalities in localizationerror added.
  • Fixed imag ILD in dietz2011
  • Added function to load some simulated monaural room impulses responses.
  • documentation updates and use of SOFA's remote load functionality in data_baumgartner2014.
  • major style overhaul of the Joergsen 2011 and 2013 models. Experiments included etc. Does not yet pass mat2doc, and sound files are missing.
  • localizationerror: new performance measures added
  • data_majdak2010 and ...2013ctc: Angles forced to be real valued.

Version 0.9.6

New:
  • Gammatone validation provided, including exp_gammatone, demo_gammatone, exp_hohmann2002, and demo_hohmann2002
  • Wierstorf et al. (2013) provided, including wierstorf2013, exp_wierstorf2013, and integration with the SFS toolbox
Fixes:
  • data_goode1994: more details provided
  • jelfs2011 works now with SOFA HRTFs stored in hrtf/jelfs2011/, e.g., kemar.sofa
  • hohmann2007 naming resolved. hohmann2007 renamed to herzke2007, the primary model is called hohmann2002 now
  • localizationerror: missing error types added
  • exp_spille2013: uses lowpass f_inst
  • dietz2011 improved to better reflect the corresponding publications