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.
# 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.shData-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
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 | — |
# Core
matplotlib>=3.5.0
pandas>=1.3.0
numpy>=1.21.0
# Excel export
openpyxl>=3.0.0Install all at once:
pip3 install -r requirements.txtOr use the installer:
./install.shchmod +x install.sh
./install.shpip3 install matplotlib pandas numpy openpyxlchmod +x run.sh
./run.shpython3 src/student_analytics.pyThe 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
Futuristic Dark Theme:
- Background:
#0f172a(Deep slate) - Accent:
#06b6d4(Cyan neon) - Success:
#10b981(Emerald) - Warning:
#f59e0b(Amber) - Danger:
#ef4444(Red)
You can easily modify the data in the script:
- Open
src/student_analytics.py - Find the STEP 1: GENERATE REAL-WORLD STUDENT DATA section
- Edit the
students,base_scores, andagesarrays - 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])- Python 3.8 or higher
- Linux / macOS / Windows (tested on Kali Linux)
- 50 MB free disk space (for generated images)
| 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 |
This project is open-source and available under the MIT License.
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
