Skip to content

About

A simple student Data and record management using terminal mode with predictive model

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📊 Student Performance Analytics Dashboard

GitHub: issu321/Data-Visualize-Py

A futuristic, menu-driven data science visualization tool built with Python. This project generates realistic student performance data and provides interactive charts with a sleek dark theme — perfect for educational analytics, portfolio showcases, or data science beginners learning matplotlib and pandas.

Dashboard Preview


🚀 Quick Start

# 1. Clone the repository
git clone https://github.com/issu321/Data-Visualize-Py.git
cd Data-Visualize-Py

# 2. Install dependencies
./install.sh

# 3. Run the program
./run.sh

📁 Project Structure

Data-Visualize-Py/
│
├── src/
│   └── student_analytics.py    # Main program file
├── output/                      # Generated charts & reports
├── requirements.txt              # Python dependencies
├── install.sh                   # One-command installer
├── run.sh                       # Launch script
└── README.md                    # This file

🎮 Menu Options

Once running, you will see an interactive menu:

==================================================
   STUDENT ANALYTICS MENU
==================================================
  A. Individual Performance Scores
  B. Age vs Score Analysis
  C. Grade Distribution
  D. Correlation Matrix
  E. Full Dashboard (All Charts)
  F. Show Data Summary (Terminal)
  G. Export Data to Excel (.xlsx)
  Q. Quit
==================================================
Option Output Saved As
A Horizontal bar chart of all student scores with grade labels output/individual_performance.png
B Bubble scatter plot (Age vs Score, bubble size = Study Hours) output/age_vs_score.png
C Pie chart showing grade distribution (A/B/C/D) output/grade_distribution.png
D Heatmap showing correlations between all metrics output/correlation_matrix.png
E Combined 4-panel dashboard with all charts output/full_dashboard.png
F Prints raw data table and statistics in terminal —
G Exports data to Excel with 4 sheets (Data, Stats, Grades, Correlations) output/student_performance_data.xlsx
Q Exit the program —

📦 Dependencies

# Core
matplotlib>=3.5.0
pandas>=1.3.0
numpy>=1.21.0

# Excel export
openpyxl>=3.0.0

Install all at once:

pip3 install -r requirements.txt

Or use the installer:

./install.sh

🛠️ Installation

Option 1: Using install.sh (Recommended)

chmod +x install.sh
./install.sh

Option 2: Manual Install

pip3 install matplotlib pandas numpy openpyxl

🖥️ Running the Program

Option 1: Using run.sh

chmod +x run.sh
./run.sh

Option 2: Direct Python

python3 src/student_analytics.py

📊 Sample Data

The program generates realistic correlated data for 15 students:

Name Age Score Grade Attendance Study_Hours
Alice 19 95.5 A 74.1 20.0
Sarah 21 94.2 A 78.9 20.0
Mike 24 68.5 D 60.0 8.5
... ... ... ... ... ...

Key Insights from the data:

  • Strong positive correlation (0.91) between Study Hours and Score
  • Strong positive correlation (0.86) between Attendance and Score
  • Grade distribution: 33.3% A, 40.0% B, 20.0% C, 6.7% D

🎨 Theme

Futuristic Dark Theme:

  • Background: #0f172a (Deep slate)
  • Accent: #06b6d4 (Cyan neon)
  • Success: #10b981 (Emerald)
  • Warning: #f59e0b (Amber)
  • Danger: #ef4444 (Red)

🎯 Customization

You can easily modify the data in the script:

  1. Open src/student_analytics.py
  2. Find the STEP 1: GENERATE REAL-WORLD STUDENT DATA section
  3. Edit the students, base_scores, and ages arrays
  4. Re-run the program
# Example: Add more students
students = ['John', 'Mary', 'Jane', ... , 'YourName']
base_scores = np.array([78, 92, 85, ... , 88])
ages = np.array([20, 22, 21, ... , 23])

🔧 Requirements

  • Python 3.8 or higher
  • Linux / macOS / Windows (tested on Kali Linux)
  • 50 MB free disk space (for generated images)

🛠️ Troubleshooting

Issue Solution
Permission denied chmod +x install.sh run.sh
Module not found Run ./install.sh or pip3 install -r requirements.txt
Charts not showing Check DISPLAY env var, use export DISPLAY=:1
openpyxl not installed pip3 install openpyxl

📜 License

This project is open-source and available under the MIT License.


👤 Author

GitHub: issu321

Created with passion for data science and clean visualization.

If you found this helpful, consider giving it a star! ⭐


Repository: https://github.com/issu321/Data-Visualize-Py.git

About

A simple student Data and record management using terminal mode with predictive model

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages