Skip to content

lacerbi/psybayes

Repository files navigation

psybayes

Bayesian adaptive stimulus placement of psychometric function for MATLAB.

psybayes.m implements Kontsevich and Tyler's (1999) Bayesian adaptive Ψ method for estimation of parameters of the psychometric function via maximization of information gain (including lapse; see Prins 2012). It also supports the marginal-Ψ method by Prins (2013).

See psytest.m for documentation and a working usage example.

The output of Psybayes can be plotted with psybayes_plot.m:

alt text

Notes

This is a fairly bare implementation of Bayesian adaptive stimulus placement. For an array of adaptive procedures you could look at the Palamedes toolbox by Nicolaas Prins and Frederick Kingdom, which has some pretty neat demo.

If you use this code for your experiment, you can mention it as:

We used Luigi Acerbi's MATLAB implementation of the PSI method (https://github.com/lacerbi/psybayes) by Kontsevich and Tyler (1999), extended to include the lapse rate (Prins 2012).

If you use the PSI-marginal method, you should also cite Prins 2013.

References

Kontsevich, L. L., & Tyler, C. W. (1999). "Bayesian adaptive estimation of psychometric slope and threshold". Vision Research, 39(16), 2729-2737. (link)

Prins, N. (2012). "The adaptive psi method and the lapse rate". Journal of Vision, 12(9), 322-322. (link)

Prins, N. (2013). "The psi-marginal adaptive method: How to give nuisance parameters the attention they deserve (no more, no less)". Journal of Vision, 13(7), 3-3. (link)

License

This is free, open source software released under the GPL-3 License. See LICENSE.txt for details.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Use this software at your own risk.

About

Bayesian adaptive stimulus placement of psychometric function for MATLAB.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages