gapnet.psychoacoustics.psychometrics

module documentation

(source)

Undocumented

Function	`fit_psychometric_func`	Find the optimal fit of the psychometric function to the given data scipy.optimize.curve_fit
Function	`get_psychometric_point`	Return the point p, e.g. 50%/0.5 point or similar for the psychometric function centered in a with width b. This can be computed either analytically or solved using scipy.optimize.fsolve.
Function	`psychometric_func`	Computes the value of the psychometric function at x with parameters a (position) and b (width) with scaling factor and location/offset

def fit_psychometric_func(xdata, ydata, with_scale=True, with_loc=True, scale_bounds=None, loc_bounds=None, scale_p0=1.0, loc_p0=1.0): (source) ¶

Find the optimal fit of the psychometric function to the given data scipy.optimize.curve_fit

Parameters
xdata
ydata
with_scale	enable fitting with a scaling parameter
with_loc	enable fitting with an offset parameter
scale_bounds	boundary conditions for the scaling parameter
loc_bounds	boundary conditions for the location parameter
scale_p0	initial point for the scaling parameter
loc_p0	initial point for the location parameter
Returns
List of optimal parameters for the psychometric-function on the input data

def get_psychometric_point(p, a, b, x0=None, method='analytical'): (source) ¶

Return the point p, e.g. 50%/0.5 point or similar for the psychometric function centered in a with width b. This can be computed either analytically or solved using scipy.optimize.fsolve.

Scale and location are not used in this calculation

Parameters
p:`float`	point to retrieve
a:`float`	position-parameter of the psychometric function
b:`float`	width-parameter of the psychometric function
x0:`float`	if using fsolve, x0 is used as starting point
method:`str`	method used for retrieving x
Returns
`float`	the position for which the psychometric function equals p

def psychometric_func(x, a, b, scale=1.0, loc=0): (source) ¶

Computes the value of the psychometric function at x with parameters a (position) and b (width) with scaling factor and location/offset

Parameters
x	position to compute
a	position-parameter of the psychometric function
b	width-parameter of the psychometric function
scale	scale (default is 1)
loc	location (default is 0)
Returns
the value of the psychometric function at x