sus-analysis-toolkit
A web-based analysis toolkit for the System Usability Scale providing calculation, plotting, interpretation and contextualization utility.
Science Score: 67.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 4 DOI reference(s) in README -
✓Academic publication links
Links to: scholar.google -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.1%) to scientific vocabulary
Keywords
Repository
A web-based analysis toolkit for the System Usability Scale providing calculation, plotting, interpretation and contextualization utility.
Basic Info
- Host: GitHub
- Owner: jblattgerste
- License: mit
- Language: Python
- Default Branch: main
- Homepage: http://sus.tools/
- Size: 18 MB
Statistics
- Stars: 21
- Watchers: 2
- Forks: 6
- Open Issues: 2
- Releases: 0
Topics
Metadata Files
README.md
System Usability Scale Analysis Toolkit
The System Usability Scale (SUS) Analysis Toolkit is a web-based python application that provides a compilation of useful insights and contextualisation approaches based on findings from the scientific literature for the System Usability Scale questionnaire that was originally developed by John Brooke. It allows researchers and practisionaires to calculate comparative, iterative and benchmarking SUS usability study datasets. Furthermore, it provides utility to contextualize the meaning of calculated scores, compare them against scores gathered in meta-analyses, calculate SUS scores conclusiveness and analysing the contribution of specific questions of the 10-item questionnaire to the SUS study scores.
An in-depth explanation of the toolkits features and their scientific basis can be found in our conference publication about the initial release and preliminary evaluation of the toolkit. It is also included in the repository: "A Web-Based Analysis Toolkit for the System Usability Scale" - Blattgerste et al. (2022). More exemplary use cases and visualizations are shown on the Mixality Lab homepage of the University of Applied Sciences Emden/Leer, where the tool was originally developed. Since then, the tool has developed into a more comprehensive solution, which can be found at https://sus.tools/.
Preview: Multi-Variable SUS Analysis

Preview: Single-Variable Usability Benchmarking

Using the SUS Analysis Toolkit
Online versions of the toolkit are hosted at: https://sus.mixality.de/ and https://analysis.sus.tools/

Quickstart - Running the SUS Analysis Toolkit locally
Run it locally using python
- Install Python 3.9. On Windows, make sure to check "Add Pythong 3.9 to PATH" during installation
- Clone this repository, or manually download it as a zip file and extract it
- Open the sus-analysis-toolkit folder
- Open the terminal (E.g. Windows Terminal) in the sus-analysis-toolkit folder
- Run the following commands to automatically install all dependencies:
python -m pip install --upgrade pip setuptoolspython -m pip install -r requirements.txt - Alternatively, install the requirements manually by installing all packages specified in the
requirements.txt:plotly==5.3.1 dash==2.0.0 numpy==1.19.5 pandas==1.3.1 kaleido==0.2.1 - After successful installation, run the toolkit locally with the command:
python dashApp.py - Copy the displayed address the toolkit is running on into the web browser to access the toolkit:

- To stop the toolkits local server, close the terminal window
Run it locally using Docker
You can also download the latest Docker container and run it locally, using e.g. Docker Desktop.
Running the SUS Analysis Toolkit on a server
To run the SUS Analysis Toolkit on your own server, we recommend hosting the latest Docker container provided under Packages in our repository. You can also build a Docker Image and host the Docker Container yourself. The required Dockerfile is included in this repository.
Contributing to this project
As the SUS Analysis Toolkit is an ongoing project, we are happy to receive feedback, suggestions and bug reports through Email or GitHub Issues.
Additionally, we are planning to develop the tool further towards including: - item-Level benchmarks for each of the 10 questions of the SUS questionnaire according to Lewis & Sauro 2018. This would allow to compare the achieved average of individual items of the SUS study scores to item-level benchmarks calculted from linear regressions based on comparable SUS study scores, the average SUS study score of 68 or the industry benchmark of 80. - more statistical data analysis tools, ranging from simple t-test and variance analysis to more advanced statistical decision helpers - automated SUS data processing (E.g. feeding SUS questionnaire data through APIs or directly interpreting filled out questionnaires from the SUS PDF Generator) - improving its accessibility and usability.
Therefore, we are happy to collaborate with developers and experts in these areas. If you are interested in working on and contributing towards one of the topics, feel free to get in touch.
Acknowledgement
The tool is freely accesible for commercial and non-commercial use under the MIT license and does not require acknowledgement. Nonetheless, if you use our tool for scientific publications or presentations, we would appreciate an acknowledgement in form of a citation to our tool:
tex
@inproceedings{10.1145/3529190.3529216,
author = {Blattgerste, Jonas and Behrends, Jan and Pfeiffer, Thies},
title = {A Web-Based Analysis Toolkit for the System Usability Scale},
year = {2022},
isbn = {9781450396318},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3529190.3529216},
doi = {10.1145/3529190.3529216},
pages = {237–246},
numpages = {10},
location = {Corfu, Greece},
series = {PETRA '22}
}
Owner
- Name: Dr. Jonas Blattgerste
- Login: jblattgerste
- Kind: user
- Location: Bielefeld, Germany
- Company: University of Applied Sciences Emden/Leer
- Website: https://www.blattgerste.dev/
- Repositories: 7
- Profile: https://github.com/jblattgerste
PostDoc working on Educational Technology
Citation (CITATION.cff)
cff-version: 1.2.0
title: >-
A Web-Based Analysis Toolkit for the System
Usability Scale
message: >-
If you use the SUS Analysis Toolkit for your
research, please cite it as follows:
type: software
authors:
- given-names: Jonas
family-names: Blattgerste
email: jonas.blattgerste@hs-emden-leer.de
affiliation: University of Applied Sciences Emden/Leer
- given-names: Jan
family-names: Behrends
email: jan.behrends@stud.hs-emden-leer.de
affiliation: University of Applied Sciences Emden/Leer
- given-names: Thies
family-names: Pfeiffer
email: thies.pfeiffer@hs-emden-leer.de
affiliation: University of Applied Sciences Emden/leer
identifiers:
- type: doi
value: 10.1145/3529190.3529216
description: Accompanying peer-reviewed publication
repository-code: >-
https://github.com/jblattgerste/sus-analysis-toolkit
url: 'https://sus.mixality.de/'
abstract: >-
The System Usability Scale (SUS) questionnaire is a
broadly used usability measurement tool, which is
fast in its application and straight forward in its
interpretation. While the original SUS
questionnaire was envisioned as a one-dimensional
”quick and dirty” approach to measure usability,
research over the past 25 years revealed helpful
insights and dimensions to contextualize and
compare individual SUS scores on. In this paper, we
present an open source web-based analysis toolkit
for the SUS questionnaire, which calculates SUS
measurements, analyses them based on the insights
and contextualization scales suggested by previous
work, and provides versatile plotting facilities to
create appealing SUS graphs for scientific
publications and presentations.
license: MIT
date-released: '2022-01-01'
preferred-citation:
authors:
- given-names: Jonas
family-names: Blattgerste
- given-names: Jan
family-names: Behrends
- given-names: Thies
family-names: Pfeiffer
conference:
name: "Proceedings of the 15th International Conference on PErvasive Technologies Related to Assistive Environments"
doi: 10.1145/3529190.3529216
title: "A Web-Based Analysis Toolkit for the System Usability Scale"
type: proceedings
year: 2022
GitHub Events
Total
- Watch event: 11
- Fork event: 2
Last Year
- Watch event: 11
- Fork event: 2
Dependencies
- python 3.8-slim-buster build
- beautifulsoup4 *
- dash ==2.5.1
- kaleido ==0.2.1
- numpy ==1.19.5
- pandas ==1.3.1
- plotly ==5.3.1
- actions/checkout v2 composite
- docker/build-push-action v2 composite
- docker/login-action v1 composite
- docker/setup-buildx-action v1 composite