# faizanzaheergit/studentperformanceprediction-ml architecture

> Architecture diagram of the GitHub repository faizanzaheergit/studentperformanceprediction-ml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/faizanzaheergit/studentperformanceprediction-ml
- Repository: https://github.com/faizanzaheergit/studentperformanceprediction-ml

## Overview

StudentPerformancePrediction-ML is a command-line exploratory ML application. It reads AI-Data.csv, visualizes student and grade relationships, prepares and encodes selected features, splits data, trains several classifiers, reports evaluation metrics, and optionally predicts a user-provided student profile. The sampled source confirms the main preprocessing, model-training, evaluation, and interactive-prediction flow; omitted portions limit certainty about some menu branches and model details.

Main entry points: [`Project.py`](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py) (CLI Orchestrator), [`AI-Data.csv`](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/AI-Data.csv) (Student Dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data_analysis["Data Analysis"]
  node_dataset[("Student Dataset<br/>[AI-Data.csv]")]
  node_visualization["Charts And Heatmaps<br/>[Project.py]"]
end

subgraph group_preprocessing["Preprocessing"]
  node_feature_prep["Feature Preparation<br/>[Project.py]"]
  node_encoding["Categorical Encoding<br/>[Project.py]"]
  node_split["Train Test Split<br/>[Project.py]"]
end

subgraph group_models["Model Training"]
  node_decision_tree["Decision Tree<br/>[Project.py]"]
  node_random_forest["Random Forest<br/>[Project.py]"]
  node_perceptron["Perceptron Model<br/>[Project.py]"]
  node_logistic["Logistic Regression<br/>[Project.py]"]
  node_mlp["Neural MLP<br/>[Project.py]"]
  node_evaluation["Metrics Reporting<br/>[Project.py]"]
end

subgraph group_interaction["Prediction Interface"]
  node_runtime["CLI Orchestrator<br/>[Project.py]"]
  node_input_form["Profile Input<br/>[Project.py]"]
  node_prediction["Prediction Display<br/>[Project.py]"]
end

node_user(("User"))

node_user -->|"starts"| node_runtime
node_runtime -->|"reads CSV"| node_dataset
node_runtime -->|"plots data"| node_visualization
node_runtime -->|"drops features"| node_feature_prep
node_feature_prep -->|"prepares columns"| node_encoding
node_encoding -->|"encodes data"| node_split
node_runtime -->|"fits model"| node_decision_tree
node_runtime -->|"fits model"| node_random_forest
node_runtime -->|"fits model"| node_perceptron
node_runtime -->|"fits model"| node_logistic
node_runtime -->|"fits model"| node_mlp
node_runtime -->|"reports metrics"| node_evaluation
node_user -->|"enters profile"| node_input_form
node_input_form -->|"supplies values"| node_runtime
node_runtime -->|"predicts profile"| node_decision_tree
node_runtime -->|"predicts profile"| node_random_forest
node_runtime -->|"predicts profile"| node_perceptron
node_runtime -->|"predicts profile"| node_logistic
node_runtime -->|"predicts profile"| node_mlp
node_runtime -->|"prints classes"| node_prediction

click node_dataset "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/AI-Data.csv"
click node_runtime "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_visualization "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_feature_prep "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_encoding "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_split "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_decision_tree "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_random_forest "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_perceptron "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_logistic "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_mlp "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_evaluation "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_input_form "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"
click node_prediction "https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dataset,node_visualization,node_user toneBlue
class node_feature_prep,node_encoding,node_split toneAmber
class node_decision_tree,node_random_forest,node_perceptron,node_logistic,node_mlp,node_evaluation toneMint
class node_runtime,node_input_form,node_prediction toneRose
```

## Components

### Data Analysis

- [Student Dataset](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/AI-Data.csv): `AI-Data.csv`
- [Charts And Heatmaps](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`

### Preprocessing

- [Feature Preparation](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Categorical Encoding](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Train Test Split](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`

### Model Training

- [Decision Tree](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Random Forest](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Perceptron Model](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Logistic Regression](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Neural MLP](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Metrics Reporting](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`

### Prediction Interface

- [CLI Orchestrator](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Profile Input](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`
- [Prediction Display](https://github.com/faizanzaheergit/studentperformanceprediction-ml/blob/main/Project.py): `Project.py`

### Other components

- **User**

## Connections

- User → CLI Orchestrator: starts
- CLI Orchestrator → Student Dataset: reads CSV
- CLI Orchestrator → Charts And Heatmaps: plots data
- CLI Orchestrator → Feature Preparation: drops features
- Feature Preparation → Categorical Encoding: prepares columns
- Categorical Encoding → Train Test Split: encodes data
- CLI Orchestrator → Decision Tree: fits model
- CLI Orchestrator → Random Forest: fits model
- CLI Orchestrator → Perceptron Model: fits model
- CLI Orchestrator → Logistic Regression: fits model
- CLI Orchestrator → Neural MLP: fits model
- CLI Orchestrator → Metrics Reporting: reports metrics
- User → Profile Input: enters profile
- Profile Input → CLI Orchestrator: supplies values
- CLI Orchestrator → Decision Tree: predicts profile
- CLI Orchestrator → Random Forest: predicts profile
- CLI Orchestrator → Perceptron Model: predicts profile
- CLI Orchestrator → Logistic Regression: predicts profile
- CLI Orchestrator → Neural MLP: predicts profile
- CLI Orchestrator → Prediction Display: prints classes
