Skip to content

Releases: Kaos599/VIT-GPA-Calculator

Version 3

14 Feb 03:30
@Kaos599 Kaos599
V3-adv
24398f3
Compare
Choose a tag to compare
Version 3 Latest
Latest

Added Graph visualizations and Future course predictions

Assets 2
Loading

Public Release V2

13 Feb 19:55
@Kaos599 Kaos599
V2-adv
946c064
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
Public Release V2

Release v2.0 - VIT-GPA-Calculator

Description

The VIT-GPA-Calculator is a Python application designed to extract course grade data from PDF files, calculate the current CGPA, and simulate potential grade improvements. This tool is particularly useful for students looking to analyze their academic performance and explore ways to enhance their grades.

Features

  • Extracts table data from PDF files using Camelot.
  • Cleans and processes data to extract course codes, titles, credits, grades, and dates.
  • Calculates current CGPA excluding courses with grade 'P'.
  • Displays detailed analysis of grade distribution and courses by grade.
  • Simulates grade improvements and calculates potential new CGPA.
  • Enhanced user interface using the Rich library for better visualization.

Installation

To get started with the VIT-GPA-Calculator, follow these steps:

  1. Clone the repository:

    git clone https://github.com/yourusername/VIT-GPA-Calculator.git
cd VIT-GPA-Calculator

  2. Set up a virtual environment:

    python -m venv venv
source venv/bin/activate   # On Windows use: venv\Scripts\activate

  3. Install dependencies:

    pip install -r requirements.txt

  4. Install Ghostscript:
    Camelot requires Ghostscript. Please install it from Ghostscript Downloads.

Usage

  • Download your Grade History PDF from VTOP.
  • Run the application:
    • For the basic version: 
      python main.py
    • For the advanced version: 
      python main_advanced.py
  • When prompted, enter the full path to your PDF grade history file.
  • Follow the on-screen instructions to view your current grade analysis or simulate grade improvements.

Included Files

  • main.py: Basic version of the GPA calculator with console output.
  • main_advanced.py: Advanced version with a richer user interface using the Rich library.
  • requirements.txt: Lists the required Python packages for the application.
  • README.md: Documentation for the project, including setup and usage instructions.
  • .gitignore: Specifies files and directories to ignore in the repository.

License

This project is licensed under the MIT License.

Loading