Skip to content

sreelekshmiaa/Python-Dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“Š EduFlow Student Dashboard (Dash + Plotly)

A web-based interactive analytics dashboard built using Python, Dash, Plotly, and Pandas to analyze academic performance of BCA students. This dashboard allows faculty or administrators to upload student marks data and instantly visualize performance insights such as pass/fail status, gender-wise distribution, mark ranges, and KPIs.

๐Ÿš€ Features

โ€ข ๐Ÿ“‚ Upload CSV or Excel files (Drag & Drop supported)

โ€ข ๐ŸŽฏ Subject-wise performance analysis

โ€ข ๐Ÿ“ˆ Automatic calculation of Total Marks

โ€ข ๐Ÿงฎ Key Performance Indicators (KPIs):

โ—‹ Total Students

โ—‹ Boys Percentage (%)

โ—‹ Girls Percentage (%)

โ—‹ Average Marks

โ€ข ๐Ÿ“Š Interactive visualizations:

โ—‹ Gender distribution (Pie chart)

โ—‹ Marks distribution by range (Histogram)

โ—‹ Pass vs Fail comparison (Bar chart)

โ—‹ Gender-wise Pass & Fail analysis (Donut charts)

โ€ข ๐ŸŽจ Clean pastel UI suitable for academic dashboards


๐Ÿ› ๏ธ Tech Stack

โ€ข Python 3.9+

โ€ข Dash โ€“ Web framework

โ€ข Plotly Express โ€“ Interactive charts

โ€ข Pandas โ€“ Data processing

โ€ข Base64 / IO โ€“ File upload handling


๐Ÿ“ Project Structure

student-dashboard/ โ”‚ โ”œโ”€โ”€ app.py # Main Dash application โ”œโ”€โ”€ README.md # Project documentation โ”œโ”€โ”€ requirements.txt # Python dependencies โ””โ”€โ”€ sample_data.xlsx # (Optional) Sample dataset


๐Ÿ“Š Required Dataset Format

The uploaded file must contain the following columns:

Column Name Description

Course Course name (e.g., BCA)

Gender Boy / Girl

Subject Subject name

Internal_1 Internal exam 1 marks

Internal_2 Internal exam 2 marks

External External exam marks


โš™๏ธ Installation & Setup

1๏ธโƒฃ Clone the Repository

git clone https://github.com/your-username/bca-student-dashboard.git cd bca-student-dashboard

2๏ธโƒฃ Create Virtual Environment (Optional but Recommended)

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

3๏ธโƒฃ Install Dependencies

pip install dash plotly pandas

4๏ธโƒฃ Run the Application

python app.py

Open your browser and go to:

๐Ÿ‘‰ http://127.0.0.1:8050/


๐Ÿง  How It Works

  1. Upload student marks file (CSV / Excel)

  2. Dashboard filters data for BCA course only

  3. Select a subject from the dropdown

  4. Dashboard updates all KPIs and charts dynamically

  5. Pass/Fail is calculated using:

PASS_MARK = 50


๐ŸŽฏ Use Cases

โ€ข College internal assessment analysis

โ€ข Department level academic reviews

โ€ข Faculty performance tracking

โ€ข Student result visualization


๐Ÿ“Œ Customization Ideas

โ€ข Add semester-wise filters

โ€ข Export reports as PDF

โ€ข Role-based login (Admin / Faculty)

โ€ข Predict performance using ML

โ€ข Connect with database (MySQL / PostgreSQL)


๐Ÿ“ธ Screenshots image

image

๐Ÿง‘โ€๐Ÿ’ป Author

Sreelekshmi A A (https://github.com/sreelekshmiaa)

Theertha Sunil (https://github.com/theerthasunil066-boop)

Shivganga R T (https://github.com/shivgangart)

Course: BCA (Data Science & AI)

Institution: Asian School of Business


๐Ÿ“œ License

This project is for educational purposes. You are free to modify and use it for academic projects.

About

An interactive academic performance dashboard built using Python Dash and Plotly for visual analysis of student data.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages