sus-analysis-toolkit

A web-based analysis toolkit for the System Usability Scale providing calculation, plotting, interpretation and contextualization utility.

https://github.com/jblattgerste/sus-analysis-toolkit

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

data-analysis data-visualization hci human-computer-interaction sus system-usability-scale usability usability-testing user-experience ux
Last synced: 6 months ago · JSON representation ·

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
data-analysis data-visualization hci human-computer-interaction sus system-usability-scale usability usability-testing user-experience ux
Created about 4 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

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 Example of the multi-variable SUS analysis

Preview: Single-Variable Usability Benchmarking

Preview Example of the single-variable SUS usability benchmarking dashboard

Using the SUS Analysis Toolkit

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

Example usage animation of the multi variable analysis

Quickstart - Running the SUS Analysis Toolkit locally

Run it locally using python

  1. Install Python 3.9. On Windows, make sure to check "Add Pythong 3.9 to PATH" during installation
  2. Clone this repository, or manually download it as a zip file and extract it
  3. Open the sus-analysis-toolkit folder
  4. Open the terminal (E.g. Windows Terminal) in the sus-analysis-toolkit folder
  5. Run the following commands to automatically install all dependencies: python -m pip install --upgrade pip setuptools python -m pip install -r requirements.txt
  6. 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
  7. After successful installation, run the toolkit locally with the command: python dashApp.py
  8. Copy the displayed address the toolkit is running on into the web browser to access the toolkit:

The dash app running the local SUS analysis toolkit

  1. 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

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

Dockerfile docker
  • python 3.8-slim-buster build
requirements.txt pypi
  • beautifulsoup4 *
  • dash ==2.5.1
  • kaleido ==0.2.1
  • numpy ==1.19.5
  • pandas ==1.3.1
  • plotly ==5.3.1
.github/workflows/docker-build.yml actions
  • actions/checkout v2 composite
  • docker/build-push-action v2 composite
  • docker/login-action v1 composite
  • docker/setup-buildx-action v1 composite