Skip to content

jfbercher/quiz_dash

Repository files navigation

PyPI version Python versions License

Real-time monitoring and correction dashboard for LabQuiz (and HTML exam export).

quiz_dash is a Streamlit-based instructor dashboard that connects to a LabQuiz backend (Google Sheets) and provides live tracking, integrity verification, and automated correction.

It is designed for lab sessions, continuous assessment, and secure evaluation.


Why quiz_dash?

When using LabQuiz in connected mode, all student interactions are logged.

Based on the Google Sheet URL specification, the associated read password, and the YAML file containing the answers, quiz_dash allows instructors to:

  • track over time, with an adjustable refresh rate, the submissions made by each participant, with the labels of the relevant quizzes,
  • check integrity, i.e., verify that the parameters (number of attempts allowed, mode, etc.) have not been modified, verify the hash of the sources, the object in memory, and its dependencies,
  • view, over time, the progress of each participant (filterable) and of the entire group,
  • correct and retrieve the results table,
  • with the possibility of adjusting the weight matrix (for multiple-choice questions) and the scoring scale per question,
  • export structured results.

Installation

From PyPI

pip install quiz-dash

From source

pip install git+https://github.com/jfbercher/quiz_dash.git

Launch

An entry-point is provided that allows to simply use

quiz_dash

at the command line.

Or use the hosted version:

👉 https://jfb-quizdash.streamlit.app/


Main Features

📈 Live Monitoring

  • Track submissions over time
  • View student-by-student activity
  • Monitor class progress
  • Adjustable refresh rate

🔐 Integrity Verification

Detect:

  • Mode changes (exam/test/learning)
  • Modified retry limits
  • Source hash changes
  • Machine sharing
  • Kernel restarts

Designed to support controlled exam conditions.


⚖ Flexible Correction

  • Automatic correction
  • Adjustable weight matrix
  • Per-question grading scale
  • Recalculation on demand
  • Threshold control (negative scores allowed or not)

📥 Export

  • Download corrected results as CSV
  • Recompute scores with updated parameters

Some screenshots of actual monitoring:

dash_parameters

quiz_dash -- Dash parameters

Monitoring_integrity

quiz_dash -- Integrity monitoring

Monitoring_activity

quiz_dash -- Monitoring of quizzes taken by students and the group. Automatic refresh possible and adjustable (student names have been hidden)

Monitoring_marks image

quiz_dash -- Automated correction, with the option to adjust the scoring system (automatic recalculation); (student names have been hidden). Of course, the results table can be downloaded.

Typical Workflow

  1. Students run quizzes in Jupyter notebooks (LabQuiz)
  2. Results are logged to Google Sheets
  3. Instructor opens quiz_dash
  4. Monitor activity in real time
  5. Run correction
  6. Export final grades

Integration

quiz_dash works with:

  • labquiz — quiz engine
  • quiz_editor — question preparation tool

Intended Use Cases

  • Lab session monitoring
  • Continuous assessment
  • Exam supervision
  • Integrity auditing
  • Post-session grade recalculation

📜 License

GNU GPL-3.0 license


About

Dashboard for monitoring and correcting labquiz quizzes

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors