utility to average gradescope csv output to final grades
Project description
Gradescope Mean
A utility which computes final grades (example: grade_full.csv) from gradescope outputs. It allows the instructor to ...
- weight assignments per category
- e.g. all HW assignments are 50% of grade
- waive lowest N assignments per category
- e.g. 2 lowest HW assignments, per student, are waived
- apply a late penalty (per day) that assignments are submitted beyond
deadline
- e.g. HW is penalized 15% of average assignment hw weight for every day late it is submitted
- also includes support for not penalizing the first N "late days" per assignment category (e.g. each student may use up to 3 "late days" across all HWs without penalty)
- waive assignments per individual student
- waive late penalties per individual student's assignment
- validate gradescope student list by passing an email list of active students
- e.g. one student has a low average grade, have they dropped the course?
- exclude assignments which shouldn't be included in final grade
- assignments automatically excluded if they don't have some minimum completion threshold
- substitute one assignment in place of another (where substitute has
higher percentage)
- e.g. to "merge" two versions of the quiz with their own unique gradescope assignment
- substitute
quiz_02
forquiz_01
- exclude
quiz_02
- substitute
- e.g. to "merge" two versions of the quiz with their own unique gradescope assignment
Installation
pip3 install gradescope-mean
Usage
Download all gradescope assignments to some local scope.csv
file
(Assignments > Download Grades > Download CSV
) and run:
python -m gradescope_mean scope.csv
to create output grade_full.csv using default configuartion.
This first run will have created a config.yaml
configuration file which you can modify to take advantage of the functionality listed above (details given in the configuration doc).
To re-run with your configuration options:
python -m gradescope_mean scope.csv --config config.yaml
Other outputs
-
Provide an output file via
--late_csv
to observe late days per student-assignment pair. -
Provide the
--per_student
flag to create a folder of student-specific csvs, helpful for emailing students the particulars of their grades. -
Pass the
--plot
flag above to view histograms (hist.html) per assignment category:
Exporting Grades
The interface above yields a "grade_full.csv" which can be processed so its ready to import into canvas or Northeastern's Banner, see links for detail.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gradescope_mean-0.0.8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9d0c952bcbeb111cffb4f7c97e54d46d6b480a0fefe3696fc1f529bef223b4c6 |
|
MD5 | 2add5f74a5d4d66a163c72b21e62c50e |
|
BLAKE2b-256 | 34a1ed1ef75543f1e7eee0131914eb5db48163d1f822ec09572438f074c48ba7 |