# dreamywarrior/comparative-study-of-stellar-classification architecture

> Architecture diagram of the GitHub repository dreamywarrior/comparative-study-of-stellar-classification, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dreamywarrior/comparative-study-of-stellar-classification
- Repository: https://github.com/dreamywarrior/comparative-study-of-stellar-classification

## Overview

##### Project type and purpose
- This is a research-oriented machine-learning classification project implemented as Jupyter notebooks. It focuses on classifying celestial objects (stars, galaxies, quasars) using Sloan Digital Sky Survey (SDSS) DR-16 and DR-17 data.
- The goal is to compare five self-sufficient ML algorithms, evaluate their accuracies on each dataset, and identify the top performer.

##### File structure
Top-level files:
- “CoSSC_DR16.ipynb” – notebook for DR-16 data
- “CoSSC_DR17.ipynb” – notebook for DR-17 data
- “CoSSC – Comparative Study of Stellar Classification (2)-2.pptx” – presentation of results
- “README.md” – project overview and data & methodology links

There are no separate “src”, “lib”, or “backend/frontend” directories. All processing, modeling, and visualization steps live inside the two notebooks.

##### README for additional insights
- Confirms use of SDSS DR-16 & DR-17 datasets
- Emphasizes a comparative study of five ML algorithms
- Describes end-goals: efficiency, accuracy, and trend analysis

##### Main components
a. Data Sources
- SDSS DR-16 (external dataset, raw FITS/CSV files)
- SDSS DR-17 (external dataset)
b. Data Ingestion & Preprocessing
- Notebook cells that load raw data, filter, clean, and transform into feature tables
c. Feature Engineering
- Steps in notebook that select or derive input features (e.g., magnitudes, redshifts)
d. Model Training
- Five parallel algorithm components (e.g., Random Forest, SVM, Neural Network, etc.)
e. Evaluation & Comparison
- Common evaluation module computing accuracy, precision, recall for each model
f. Result Aggregation & Visualization
- Generation of plots, tables, and summary statistics
g. Presentation Layer
- PowerPoint file capturing key findings

##### Relationships and interactions
- Preprocessing feeds into Feature Engineering
- Features split to the five Model Training components in parallel
- Each model outputs to the Evaluation & Comparison component
- Comparison flows into Result Aggregation & Visualization
- Final outputs link to the Presentation Layer

##### Architectural patterns & design principles
- Modular pipeline: clear separation between data acquisition, preprocessing, modeling, and reporting
- Parallel model training: five self-contained algorithm modules
- Reproducibility: notebooks capture each pipeline stage sequentially

##### Relevant technologies
- Python & Jupyter Notebooks
- pandas, NumPy for data handling
- scikit-learn (or equivalent) for ML algorithms
- Matplotlib/seaborn for visualization
- SDSS data formats (FITS/CSV)

##### Detail
- Logical step from raw data ingestion through final PPT outputs.
- Both DR-16 and DR-17 flows side by side, converging at the comparison stage.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "DR-16 Pipeline"
        DS16(("SDSS DR-16 Raw Data")):::data
        Pre16["Data Ingestion & Preprocessing"]:::processing
        FE16["Feature Engineering"]:::processing
        subgraph "Model Training (DR-16)"
            RF16["Random Forest"]:::model
            SVM16["SVM"]:::model
            NN16["Neural Network"]:::model
            KNN16["KNN"]:::model
            DT16["Decision Tree"]:::model
        end
        Eval16["Evaluation & Comparison"]:::eval
        Viz16["Result Aggregation & Visualization"]:::eval

        DS16 --> Pre16
        Pre16 --> FE16
        FE16 --> RF16
        FE16 --> SVM16
        FE16 --> NN16
        FE16 --> KNN16
        FE16 --> DT16
        RF16 --> Eval16
        SVM16 --> Eval16
        NN16 --> Eval16
        KNN16 --> Eval16
        DT16 --> Eval16
        Eval16 --> Viz16
    end

    subgraph "DR-17 Pipeline"
        DS17(("SDSS DR-17 Raw Data")):::data
        Pre17["Data Ingestion & Preprocessing"]:::processing
        FE17["Feature Engineering"]:::processing
        subgraph "Model Training (DR-17)"
            RF17["Random Forest"]:::model
            SVM17["SVM"]:::model
            NN17["Neural Network"]:::model
            KNN17["KNN"]:::model
            DT17["Decision Tree"]:::model
        end
        Eval17["Evaluation & Comparison"]:::eval
        Viz17["Result Aggregation & Visualization"]:::eval

        DS17 --> Pre17
        Pre17 --> FE17
        FE17 --> RF17
        FE17 --> SVM17
        FE17 --> NN17
        FE17 --> KNN17
        FE17 --> DT17
        RF17 --> Eval17
        SVM17 --> Eval17
        NN17 --> Eval17
        KNN17 --> Eval17
        DT17 --> Eval17
        Eval17 --> Viz17
    end

    Viz16 --> Comparison
    Viz17 --> Comparison
    Comparison["Comparison & Aggregation"]:::eval
    Comparison --> PPT["Presentation (PPTX)"]:::presentation
    Comparison --> README["Documentation (README)"]:::presentation

    click DS16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click Pre16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click FE16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click RF16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click SVM16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click NN16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click KNN16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click DT16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click Eval16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click Viz16 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR16.ipynb"
    click DS17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click Pre17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click FE17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click RF17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click SVM17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click NN17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click KNN17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click DT17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click Eval17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click Viz17 "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC_DR17.ipynb"
    click PPT "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/CoSSC - Comparative Study of  Stellar Classification (2)-2.pptx"
    click README "https://github.com/dreamywarrior/comparative-study-of-stellar-classification/blob/main/README.md"

    classDef data fill:#ADD8E6,stroke:#000
    classDef processing fill:#90EE90,stroke:#000
    classDef model fill:#FFA500,stroke:#000
    classDef eval fill:#9370DB,stroke:#000
    classDef presentation fill:#D3D3D3,stroke:#000,stroke-dasharray: 5 5
```
