Add README + requirements
parent
3d416f3682
commit
a68d9b71c2
@ -0,0 +1,43 @@
|
|||||||
|
## MoodleBulkGrader
|
||||||
|
|
||||||
|
This tool makes it easier to grade Moodle submissions that contain
|
||||||
|
multiple individual image/pdf files.
|
||||||
|
|
||||||
|
It will merge the individual files into a single PDF per student.
|
||||||
|
That PDF can then be annotated with general comments or with `grading` comments,
|
||||||
|
which tell how many marks the student got in each section of the assignment.
|
||||||
|
Grading comments start with a specific first line (`GRADE` or `NOTA` by default),
|
||||||
|
and they are followed by a new line per section.
|
||||||
|
|
||||||
|
For instance, consider this annotation:
|
||||||
|
|
||||||
|
GRADE
|
||||||
|
1.1 0.5
|
||||||
|
1.2 1.0
|
||||||
|
2 8.5
|
||||||
|
|
||||||
|
This will result in the user getting 10 marks.
|
||||||
|
The results are stored per section (1.1, 1.2 and 2).
|
||||||
|
The bulk grading feature will show how many submissions have a grade for
|
||||||
|
each specific section, so you can keep track of your progress.
|
||||||
|
|
||||||
|
You may add more than one `grading` annotation per document.
|
||||||
|
If the same section is graded more than once, `bulkgrader` will raise an
|
||||||
|
exception.
|
||||||
|
|
||||||
|
You may specify the sections in advance.
|
||||||
|
When a student has grades for all the sections specified, that student counts
|
||||||
|
as fully graded.
|
||||||
|
|
||||||
|
Other text annotations can later be extracted as comments for the submission,
|
||||||
|
but they are not used in this version.
|
||||||
|
|
||||||
|
## Instructions
|
||||||
|
- Download all submissions to an assignment as a zip file
|
||||||
|
- Extract all submissions
|
||||||
|
- Run `python bulkgrader.py --copy` to copy all files
|
||||||
|
- Run `python bulkgrader.py --merge` to merge all files. You might need
|
||||||
|
to manually add file extensions (`.jpg` or `.pdf`)
|
||||||
|
- Run `python bulkgrader.py` to start autograding with your program of choice
|
||||||
|
|
||||||
|
For every PDF, you'll want to add
|
@ -0,0 +1,2 @@
|
|||||||
|
PyPDF2==1.26.0
|
||||||
|
Pillow==8.2.0
|
Loading…
Reference in New Issue