The Singing Ability Assessment (SAA
; Silas, Müllensiefen, & Kopiez, 2023) is a test of singing ability which can be launched in R/Shiny via the psychTestR
package.
Seb Silas, sebsilas@gmail.com
Short SAA
with feedback: https://adaptiveeartraining.com/SAA-demo
Prototype adaptive-SAA
(aSAA) with feedback: https://adaptiveeartraining.com/aSAA
Install nodeJS: https://nodejs.org/en/download/
Install R: https://cloud.r-project.org/
Install RStudio: https://posit.co/downloads/
Launch RStudio
Install the devtools
R package by pasting the following command into the RStudio terminal:
install.packages('devtools')
SAA
package:devtools::install_github('sebsilas/SAA')
Once you have completed the above steps, you can run the SAA
test by doing the following:
Create a folder which will contain your app. The name of this folder will become the app_name
argument when you run the SAA
or SAA_standalone
functions later.
In the folder, create an R file called app.R
. In this file, paste your code to run the SAA
there, like below:
# Load the SAA package
library(SAA)
# Run a short test with feedback:
SAA_standalone(app_name = "my_SAA_app",
num_items = list(long_tones = 2L, arrhythmic = 2L, rhythmic = 2L),
feedback = TRUE,
SNR_test = FALSE,
get_range = FALSE,
examples = 0)
Remember that the app_name
argument should match the name of your folder.
Make sure that your current directory is the app folder you created. You can check the current directory by using getwd()
. You may need to set the app directory by placing setwd('/Users/musicassessr/my_project/my_SAA_app')
at the beginning of your app file.
Run the app. To do this in RStudio, use the shortcut Command + Shift + Enter
on Mac (Ctrl + Shift + Enter
on Windows).
If the above steps were successful, the SAA
test should load in your web browser, and as you progress through the test, you should receive feedback after each trial. Recorded audio should appear in the /app_name/www/audio/ directory.
If not, go to our [Troubleshooting]() page or raise an issue on Github.
This has not yet been comprehensively tested on Windows. Please get in touch if you have any issues.
The test requires internet connectivity.
The SAA runs in your web browser. It is only recommended to run the test in Google Chrome or Opera. You will need to set one of these to be your default browser for RStudio to launch the test there (restart RStudio after doing this).
We advise mentioning the software versions you used,
in particular the versions of the SAA
, musicassessr
, psychTestR
, and psychTestRCAT
packages.
You can find these version numbers from R by running the following commands:
library(SAA)
library(psychTestR)
library(psychTestRCAT)
if (!require(devtools)) install.packages("devtools")
x <- devtools::session_info()
x$packages[x$packages$package %in% c("SAA", "psychTestR", "psychTestRCAT"), ]
Silas, S., Müllensiefen, D., & Kopiez, R. (2023). Singing Ability Assessment: Development and validation of a singing test based on item response theory and a general open-source software environment for singing data. Behaviour Research Methods. https://doi.org/10.3758/s13428-023-02188-0