ZiadSheriif / Sa7a7LY

A Grades-autoFiller app which converts either a tabular sheet of grades or a bubble sheet to an excel file with corresponding input mapped to answers.

📝 Table of Contents

• 📝 Table of Contents
• 📙 About
• 💡 Explanation
  • For the grades sheet:
    • For the student ID and hand-written numbers
• 🏁 Getting Started
  • Prerequisites
  • Installation
  • Running
• 💻 Built Using
• 📷 Demo Screenshots
• 🎥 Demo Videos
• 🕴 Contributors
• 📃 License

📙 About

• A Grades-autoFiller which converts either a tabular sheet of grades or a bubble sheet to an excel file with corresponding input mapped to answers.

💡 Explanation

For the grades sheet:

• Check marks are translated to 5
• Question marks give a red background in its excel cell
• A box is mapped to 0 score
• Stacked vertical lines are written by their count
• Stacked horizontal lines are written by 5 - their count

For the student ID and hand-written numbers

• Two approaches are implemented:
  1. Already-made OCR
  2. Features + classifier
• The user chooses which method to convert them by selecting an option from two below uploading the image.

🏁 Getting Started

This is a list of needed instructions to set up your project locally, to get a local copy up and run the below commands.

Prerequisites

1. python 3.9.2
2. pytesseract
3. OpenCv
4. matplotlib
5. numpy
6. PTL
7. ReactJs
8. NodeJs

Installation

1. Clone the repository

 git clone https://github.com/ZiadSheriif/Sa7a7LY

2. Navigate to Sa7a7LY Folder

cd Sa7a7LY

Running

Running program

1. Install modules

npm install

2. Run back-end

npm start

3. Run front-end

npm start gui/src

💻 Built Using

• Python
• NodeJs
• ReactJs

📷 Demo Screenshots

Main Screen

Input Auto-Filler

Output Auto-Filler

---

🎥 Demo Videos

Grades Sheet

Bubble Sheet

---

🕴 Contributors

Ziad Sherif

Abdelrahman Hamdy

Abdelrahman Hamza

Ahmed Sabry

📃 License

This software is licensed under MIT License, See License for more information @SA7A7LY.