BAUMGARTNER2014PMV2PPP - - Performance predictions from PMVs of baumgartner2014

Usage

[ qe,pe,eb ] = baumgartner2014pmv2ppp( p,tang,rang );
[ qe,pe,eb ] = baumgartner2014pmv2ppp( p,tang,rang,exptang );
[ qe,pe,eb ] = baumgartner2014pmv2ppp( pred );

Input parameters

`p`	prediction matrix (response PMVs)
`tang`	possible polar target angles. As default, ARI's MSP polar angles in the median SP is used.
`rang`	polar angles of possible response angles. As default regular 5 deg.-sampling is used (-90:5:265).
`pred`	structure including all input parameters above.

Output parameters

`qe`	quadrant error rate
`pe`	local polar RMS error in degrees
`eb`	elevation bias in degrees; QEs and up-rear quadrant excluded

Description

baumgartner2014pmv2ppp(...) retrieves commonly used PPPs (Psychoacoustic performance parameters) for sagittal-plane (SP) localization like quadrant error (QE), local polar RMS error (PE), and elevation bias (EB) from response PMVs (probability mass vectors) predicted by a localization model. PPPs are retreived either for a specific polar target angle or as an average across all available target angles. The latter is the default.

baumgartner2014pmv2ppp needs the following optional parameter in order to retrieve the PPPs for a specific (set of) target angles:

'exptang= exptang experimental polar target angles'

baumgartner2014pmv2ppp accepts the following flag:

`'print'`	Display the outcomes.
`'QE_PE_EB'`	Compute QE, PE, and EB. This is the default.
`'QE'`	Compute QE.
`'PE'`	Compute PE.
`'EB'`	Compute EB.
`'absPE'`	Compute absolute polar error.
`'chance'`	Compute chance performance for QE and PE.

Example:

To evaluate chance performance of QE and PE use

[qe,pe] = baumgartner2014pmv2ppp('chance');

References:

R. Baumgartner, P. Majdak, and B. Laback. Modeling sound-source localization in sagittal planes for human listeners. The Journal of the Acoustical Society of America, 136(2):791-802, 2014. [ DOI ]