moodle-exam-miner

Architecture

Steps:

1. Teacher creates the exam in Moodle.
2. Students complete the exam on Moodle.
3. Teacher downloads the exam data generated by Moodle (4 files).
4. Teacher upload the 4 files to Moodle Exam Miner.
   1. exam_answers.json
   2. exam_califications.json
   3. exam_logs.json
   4. exam_questions_set.xml
5. Moodle Exam Miner analyses the exam data and generates insights.
6. Teacher receives the final report incluiding interactive graphs and printable PDF.

This is a beta version of the project. It is currently in development with regular updates. Once it is completed we will let you know and release the official version!

The technology used is pandas to deal with data and plotly to make interactive graphs of the results.

Installation

First of all, we highly recommend you to install packages using pip and virtual enviroments and upgrade basic packages as follows:

python3 -m pip install --upgrade pip setuptools wheel

python3 -m pip install --user virtualenv
python3 -m venv my_venv
source my_venv/bin/activate

python -m pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

In the actual mooodle-exam-miner version, we are using Python 3.8.12

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.