MCLACHLAN2021_METRICS
- extract localization metrics

Usage:

metric = mclachlan2021_metrics(doa)

Input parameters:

doa

Struct returned from the mclachlan2021 model with estimated and real directions of arrival

Output parameters:

metric

metrics for evaluation of localisation performance

Description:

mclachlan2021_metrics(...) returns psychoacoustic performance parameters for experimental response patterns. doa is a struct where actual and estimated directions of arrival must be provided.

The metrics struct contains the following fields:

`.reversal_fb`	Percentage of front-back reversals, omitting small errors occurring within 10 degrees of the plane dividing the hemifields
`.reversal_ud`	Percentage of up-down reversals, omitting small errors occurring within 10 degrees of the plane dividing the hemifields
`.rmsL`	Lateral root mean squared error
`.rmsP`	Polar root mean squared error, omitting reversals and restricted to directions within 35 degrees of the vertical midline

References:

D. Schonstein, L. Ferre, and B. F. G. Katz. Comparison of headphones and equalization for virtual auditory source localization. Proc. Euronoise, 2008.

J. Reijniers, D. Vanderleist, C. Jin, C. S., and H. Peremans. An ideal-observer model of human sound localization. Biological Cybernetics, 108:169--181, 2014.