Grading Analysis Tool

This tool was created by Mario Marku with advisement from Dr. Gary Weiss and Dr. Daniel Leeds to simplify grading data analysis for educators without requiring programming or data analytics skills. Its intuitive interface streamlines the process of exploring student and course performance data.

The Tools offical Manual can be found [here] alongisde an extensive Data Dictionary found [here] detailing how this tool is used.

This GitHub also contains our offical paper showcasing the tool with real data from a large university. Administrators and faculty from universities are encouraged to give it a read if they are curious of the tools capabilities and how it might help them.

---

Prerequisites

1. Install Python 3

   • Windows: https://www.python.org/downloads/windows/
   • macOS: https://www.python.org/downloads/macos/
   • Linux: Use your distro’s package manager or download from https://www.python.org/downloads/

2. (Recommended) Create a Virtual Environment

   • This prevents conflicts with system-wide packages:

     python3 -m venv venv
     # On Windows:
     venv\Scripts\activate
     # On macOS/Linux:
     source venv/bin/activate

---

Simplest Installation

You can either locally download all the source code and run the tool, or the simpler method which is a direct install from PyPi.

To Install from PyPi, ensure you are in the correct python enviorment (or no enviorment, not recommended) and run

   pip install grade-analysis

Or, if you are not using an enviorment (not recommended)

   pip install grade-analysis --break-system-packages

After which, you can then run the GUI with the command

   grade-analysis

Local Installation

1. Clone or Download this Repository

   git clone https://github.com/Fordham-EDM-Lab/Grading-Analysis-Tool

2. Install Dependencies (Inside the Virtual Environment, if created)

   pip install -e .

• If you choose not to use a virtual environment (not recommended), you can install system-wide. If pip refuses to install due to potential conflicts, add:

  pip install -e . --break-system-packages

  This overrides pip’s default protections, and may affect system packages.

After Installation

Simply run:

grade-analysis

Or

python3 -m src.gradeAnalysisGUI