[accL, precL, accP, precP, querr] = localizationerror(m) [res, meta, par] = localizationerror(m,errorflag)

m |
item list from a localization experiment. |

The columns of 'm' comprise:

'1:4 ... azi_target,ele_target,azi_response,ele_response'

'5:8 ... lat_target,pol_target,lat_response,pol_response'

'9' |
... F/B-C resolved pol_response |

The errorflag may be one of:

'accL' |
accuracy (average) in the lateral dimension | ||

'precL' |
precision (std. dev.) in the lateral dimension | ||

'precLcentral' |
meridian (+-30 deg elevation) | ||

'accP' |
accuracy (average) in the polar dimension | ||

'precP' |
precision (circular std. dev.) in the polar dimension | ||

'querr' |
percentage of weighted polar errors > 45deg: [querr number_of_corrects total_number] = CalcAccPrec... | ||

'accE' |
accuracy in the elevation | ||

'absaccE' |
absolute accuracy in the elevation | ||

'absaccL' |
absolute lateral accuracy | ||

'accabsL' |
mean absolute lateral error | ||

'accabsP' |
mean absolute polar error | ||

'accPnoquerr' |
accP with quadrant errors removed | ||

'precE' |
precision in the elevation | ||

'querr90' |
precentage of weighted polar errors > 90deg | ||

'precPmedian' |
unweighted polar precision error considering targets around the median plane only (+/-30deg lateral) | ||

'precPmedianlocal' |
basing on precPmedian, quadrant errors (polar error >90 deg) are excluded. Similar to RMS local polar error (Middlebrooks, 1999) | ||

'precPnoquerr' |
precP with quadrant errors removed | ||

'rmsL' |
lateral RMS error according to Middlebrooks (1999) | ||

'rmsPmedianlocal' |
unweighted polar RMS considering targets around the median plane only (+/-30deg lateral) and excluding quadrant errors (polar error > 90deg). Identical to RMS local polar error in Middlebrooks (1999). | ||

'rmsPmedian' |
unweighted polar RMS considering targets around the median plane only (+/-30deg lateral). Includes quadrant errors. | ||

'querrMiddlebrooks' |
quadrant errors as in Middlebrooks (1999). Use central positions within +/-30deg, querr is when polar error is >90deg [querr number_of_corrects total_number] = CalcAccPrec... | ||

'corrcoefL' |
lateral correlation coeffficient. Output parameter: [cc, p] | ||

'corrcoefP' |
polar correlation coeffficient, Only data within lateral +/-30deg are considered. Output parameter: [corr_coeff, p_of_significant_corr] | ||

'SCC' |
spherical/spatial correlation coefficient (Carlile et al., 1997) | ||

'gainLstats' |
performs linear regression to obtain lateral gain.
See help of regress for a detailed description of
the structure fields. | ||

'gainL' |
lateral gain only | ||

'pVeridicalL' |
Proportion of quasi-verdical responses in lateral dimension | ||

'precLregress' |
lateral scatter around linear regression line (only quasi-veridical responses included). | ||

'sirpMacpherson2000' |
|||

performs an ad-hoc selective, iterative regression procedure (SIRP) as proposed in Macpherson & Middlebrooks (2000 JASA) in order to exclude outliers and reversals and isolate the main concentration of responses in the computation of the linear fits. As the original procedure does not necessarily converge, the implementation here runs up to 100 iterations and selects the iteration that includes the most responses / excludes the least outliers. Outlier distance criterion: 40deg. |

'=results for frontal and rear hemisphere, '= respectively - se
results for frontal and rear hemisphere, respectively - see
'=help of'''`regress` for a detailed description of th
help of `regress` for a detailed description of the
'=structure fields
structure fields.'

frontal polar gain only

rear polar gain only

polar gain averaged between front and back

slope in degrees of regression line (frontal only)

slope in degrees of regression line (rear only)

slope in degrees of regression line (front and back)

Proportion of quasi-verdical polar responses in '=the fron the front'

Proportion of quasi-verdical polar responses in '=the bac the back'

Proportion of quasi-verdical polar responses in '=tota total'

polar scatter around linear regression line for '=the front (only quasi-veridical responses included the front (only quasi-veridical responses included)'

same as *precPregressFront* but for the back

average between *precPregressFront* and *precPregressRear*

polar error rate used in Macpherson & Middlebrooks
'=(2003). They measured the deviation of responses from th
(2003). They measured the deviation of responses from the
'=linear predictors obtained by an ad-hoc SIRP. Polar error
linear predictors obtained by an ad-hoc SIRP. Polar errors
'=are defined by showing a deviation of >45de
are defined by showing a deviation of >45deg
'=(i.e., '= not being quasi-veridical) with respec
(i.e., not being quasi-veridical) with respect
'=to the linear flat stimulus prediction. Note that for thi
to the linear flat stimulus prediction. Note that for this
'=analysis the results from'''''''`sirpMacpherson2000` ar
analysis the results from `sirpMacpherson2000` are
'=required and handled as'`localizationerror(m, '=f,' '=r,' '='perMacpherson2003')'
required and handled as `localizationerror(m,f,r,'perMacpherson2003')`

If no errorflag is provided, the function returns: accL, precL, precP, and querr

`localizationerror(m,errorflag)` returns psychoacoustic performance
parameters for experimental response patterns.
*m* is a matrix. In each row of *m*, the information about the target
and response in the columns must be provided.

`[res, meta, par] = localizationerror(m,errorflag)` calculates error
metric *res* given by the string *errorflag*. *meta* contains additional
metadata, *par* contains additional calculation results.