PAUSCH2022
ITD prediction in the horizontal plane for listeners with hearing aids

Usage:

[itd, itd_max, itd_arg_max_phi, coef, fig] = pausch2022(feat_xd, varargin);
[itd, ..] = pausch2022(feat_xd,   'hartf_rear', varargin);
[itd, ..] = pausch2022(feat_hrtf, 'hrtf', varargin);

Input parameters:

feat_xd

Vector containing the following features in columns:

1: Head width (in mm). Corresponds to x1 in Pausch et al. (2022).
2: Head height (in mm). Corresponds to x2.
3: Head depth (in mm). Corresponds to x3.
4: HA-microphone up offset (in mm). Corresponds to d13.
5: HA-microphone back offset (in mm). Corresponds to d14.

feat_hrtf

Vector containing the following features in columns:

1: Head width (in mm). Corresponds to x1 in Pausch et al. (2022).
2: Head height (in mm). Corresponds to x2.
3: Head depth (in mm). Corresponds to x3.
4: Pinna down offset (in mm). Corresponds to x4.
5: Pinna back offset (in mm). Corresponds to x5.

Output parameters:

`itd`	Predicted ITDs (in s) per STFs and model.
`itd_max`	Maximum of the ITD (in s).
`itd_arg_max_phi`	Argument of the interaural-time-difference maximum (in s).
`coef`	Model coefficients as estimated after applying the polynomial regression weights to the subset of individual features.
`fig`	Figure handle.

Description:

pausch2022() contains a hybrid model to predict the interaural time differences (ITDs) in the horizontal plane based on spatial transfer function (STFs), which can be for normal-hearing subjects the head-related transfer functions (HRTFs), or for hearing-impaired subject fitted with behind-the-ear hearing aids the hearing-aid-related transfer functions (HARTFs).

It also implements three analytical ITD models: Kuhn (1977), Woodworth and Schlosberg (1954), and Aaronson and Hartmann (2014). The ITD predictions in all models are based on invividual anthropometric features or features describing the individual placement of the HAs.

The following ITD models can be selected for the ITD predictions:

`'pausch2022'`	Default. Hybrid ITD model by Pausch et al. (2022).
`'kuhn1977'`	Analytic ITD model by Kuhn (1977).
`'woodworth1954'`	Analytic ITD model by Woodworth and Schlosberg (1954).
`'aaronson2014'`	Analytic ITD model by Woodworth and Schlosberg (1954) extended by Aaronson and Hartmann (2014) (far-field assumption). Note that for this model, if 'hartf_front' or 'hartf_rear specified the features x5, d9, d10, and Theta3 have to be provided.

The following spatial transfer functions (STFs) can be used specified:

`'hartf_front'`	Load invidual front HARTF datasets. Default. Opossite of `'hartf_rear'` and `'hrtf'`.
`'hartf_rear'`	Load invidual rear HARTF datasets. Opposite of `'hartf_front'` and `'hrtf'`.
`'hrtf'`	Load individual HRTF datasets. Opposite of `'hartf_front'` and `'hartf_rear'`.
`'no_plot'`	Do no plot. Default.
`'plot'`	Plot predicted ITDs over `azi_min:azi_res:azi_max`. Opposite of `'plot'`.

Additional key/value pairs include:

`'d9'`	HA-microphones-to-ear-canal offset (in mm). Default is empty.
`'d10'`	HA-microphones-to-scalp offset (in mm). Default is empty.
`'Theta3'`	Frontal HA-microphones angle (in deg). Default is empty.
`'azi_min'`	Minimum evaluation angle of azimuth range (in deg). Default: 0 deg.
`'azi_max'`	Maximum evaluation angle of azimuth range (in deg). Default: 180 deg.
`'azi_res'`	Angular resolution of the evaluated azimuth range (in deg). Default: 2.5 deg.
`'c'`	Speed of sound (in m/s). Default: 343 m/s.

References:

F. Pausch, S. Doma, and J. Fels. Hybrid multi-harmonic model for the prediction of interaural time differences in individual behind-the-ear hearing-aid-related transfer functions. Acta Acust., 6:34, 2022. [ DOI ]

G. F. Kuhn. Model for the interaural time differences in the azimuthal plane. The Journal of the Acoustical Society of America, 62(1):157--167, 1977. [ DOI ]

R. S. Woodworth and H. Schlosberg. Experimental psychology, Rev. ed. Holt, Oxford, England, 1954.

N. L. Aaronson and W. M. Hartmann. Testing, correcting, and extending the Woodworth model for interaural time difference. The Journal of the Acoustical Society of America, 135(2):817--823, 2014. [ DOI ]