📝 Table of Contents

• 📝 Table of Contents
• 📙 About
• 💡 Explanation
• 🏁 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. React JS
4. Node JS

Installation

Clone the repository

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

Running

Running program

1. Run back-end server

npm start

2. Run front-end server

npm start gui/src/

💻 Built Using

• Python

📷 Demo Screenshots

Main Screen

Auto-Filler

Bubble Sheet

Preview auto filler

Preview bubble sheet

---

🎥 Demo Videos

Grades Sheet

AutoFiller.mp4

Bubble Sheet

BubbleSheet.mp4

---

Contributors

Ziad Sherif

Abdelrahman Hamdy

Abdelrahman Hamza

Ahmed Sabry

License

This software is licensed under MIT License, See License for more information ©ZiadSheriif.