jsquest-plus

A JavaScript library to use the QUEST+ method in online experiments.

https://github.com/kurokida/jsquestplus

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.1%) to scientific vocabulary
Last synced: 9 months ago · JSON representation ·

Repository

A JavaScript library to use the QUEST+ method in online experiments.

Basic Info
  • Host: GitHub
  • Owner: kurokida
  • License: mit
  • Language: JavaScript
  • Default Branch: main
  • Size: 2.62 MB
Statistics
  • Stars: 10
  • Watchers: 2
  • Forks: 3
  • Open Issues: 1
  • Releases: 1
Created over 4 years ago · Last pushed 12 months ago
Metadata Files
Readme License Citation

README.md

QUEST+

QUEST+ (Watson, 2017) is an extension of QUEST (Watson & Pelli, 1983) that can deal with multiple stimulus parameters, multiple psychometric parameters, and more than two responses options. The jsQuestPlus JavaScript library allows researchers to use the QUEST+ method in online experiments.

Installation

The package is available on npm.

npm install jsquest-plus

Many thanks to @tpronk and @mieubrisse for their help.

How to cite

We prefer to cite the paper, but either citation is acceptable.

Paper citation

Kuroki, D., & Pronk, T. (2022). jsQuestPlus: A JavaScript implementation of the QUEST+ method for estimating psychometric function parameters in online experiments. Behavior Research Methods. https://doi.org/10.3758/s13428-022-01948-8

Software citation (for version 2.0.0)

Kuroki, D., & Pronk, T. (2022). jsQuestPlus: A JavaScript library to use the QUEST+ method in online experiments. (Version 2.0.0) [Computer software]. https://github.com/kurokida/jsQuestPlus

How to use

See the GitHub page and Customization of Psychometric function

Demonstrations

The demos folder contains some sample code.

Example1stim1psy2respWatson(2017).html

This is the sample code for Watson's first example: "Estimation of contrast threshold {1, 1, 2}". The threshold is estimated using the stimulus parameter (contrast) and responses described in Watson's paper.

Simulation1stim1psy2respWatson(2017).html

This file is the same as Example_1stim_1psy_2resp_Watson(2017).html, except that it simulates the observer's response. The final estimate will change slightly each time you run the program.

Example2stim3psy2respWatson(2017).html

This is the sample code for Watson's forth example: "Contrast sensitivity function {2, 3, 2}". The psychometric parameters are estimated using the stimulus parameters and responses described in Watson's paper.

Simulation2stim3psy2respWatson(2017).html

This file is the same as Example_2stim_3psy_2resp_Watson(2017).html, except that it simulates the observer's response. The final estimates will change slightly each time you run the program.

jsPsychDemo/jsQuestPlus_jsPsychDemo.html

This is the sample code for jsPsych users. This simulates Watson's second example: "Estimation of contrast threshold, slope, and lapse {1, 3, 2}".

Convenience functions

  • The numeric.js library developed by Sébastien Loisel under the MIT licence performs matrix/array calculations at high speeds. This library is included in jsQuestPlus, with some of its functions available by prefixing them with jsQuestPlus.: abs, add, cos, dim, div, dot, exp, floor, isFinite, isNaN, linspace, log, mod, mul, pow, round, sin, sqrt, sub, sum, transpose.

Information for developers

Installation

Install node, then clone the repo to your hard drive. Next, you can install jsQuestPlus and its dependencies by running:

npm install

Building jsQuestPlus

To package jsQuestPlus and it's dependencies, and export those as UMD bundle, run the command below. Your bundle will be available in the dist/ directory:

npx rollup -c

Notes

jsQuestPlus depends on a fork of the numeric library, which turns this library into an ES6 module.

Owner

  • Name: Daiichiro Kuroki
  • Login: kurokida
  • Kind: user
  • Company: Kyushu University

I am a technical staff at Kyushu University in Japan. I am working at psychological laboratory in Faculty of Letters.

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: >-
  jsQuestPlus: A JavaScript library to use the QUEST+ method in online experiments.
message: >-
  Please cite the software itself and the journal article from 'preferred-citation'.
type: software
url: https://github.com/kurokida/jsQuestPlus
version: 2.0.0
date-released: "2022-03-11"
authors:
  - given-names: Daiichiro
    family-names: Kuroki
    email: kurokid@kyudai.jp
    affiliation: Kyushu Univeristy
    orcid: 'https://orcid.org/0000-0002-3547-7082'
  - given-names: Thomas
    family-names: Pronk
    email: pronkthomas@gmail.com
    affiliation: University of Amsterdam
    orcid: 'https://orcid.org/0000-0001-9334-7190'
references:
  - authors:
      - given-names: Daiichiro
        family-names: Kuroki
      - given-names: Thomas
        family-names: Pronk
    doi: 10.3758/s13428-022-01948-8
    journal: "Behavior Research Methods"
    title: "jsQuestPlus: A JavaScript implementation of the QUEST+ method for estimating psychometric function parameters in online experiments"
    type: article
    year: 2022

GitHub Events

Total
  • Issues event: 1
  • Watch event: 1
  • Issue comment event: 4
  • Push event: 5
  • Pull request event: 4
  • Fork event: 1
Last Year
  • Issues event: 1
  • Watch event: 1
  • Issue comment event: 4
  • Push event: 5
  • Pull request event: 4
  • Fork event: 1

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 2
  • Total pull requests: 5
  • Average time to close issues: 14 days
  • Average time to close pull requests: about 21 hours
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 4.5
  • Average comments per pull request: 0.4
  • Merged pull requests: 5
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 4
  • Average time to close issues: 14 days
  • Average time to close pull requests: about 22 hours
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 4.5
  • Average comments per pull request: 0.25
  • Merged pull requests: 4
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • mieubrisse (2)
Pull Request Authors
  • tpronk (3)
  • mieubrisse (2)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • npm 6 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 1
  • Total maintainers: 1
npmjs.org: jsquest-plus

A JavaScript implementation of the QUEST+ staircase algorithm (Watson, 2017).

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 6 Last month
Rankings
Dependent repos count: 24.3%
Average: 29.6%
Dependent packages count: 35.0%
Maintainers (1)
Last synced: 10 months ago

Dependencies

package-lock.json npm
  • 110 dependencies
package.json npm
  • @rollup/plugin-node-resolve ^13.0.0 development
  • eslint ^8.0.1 development
  • rollup ^2.50.1 development
  • rollup-plugin-sourcemaps ^0.6.3 development
  • numeric_es6 github:tpronk/numeric