# aurelienggt/ghouls-goblins-and-ghosts-boo architecture

> Architecture diagram of the GitHub repository aurelienggt/ghouls-goblins-and-ghosts-boo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aurelienggt/ghouls-goblins-and-ghosts-boo
- Repository: https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo

## Overview

##### Main Components
- Data Input Layer:
- Data folder containing zipped CSV files (train.csv, test.csv, sample_submission.csv) as the “Dataset” component.
- Data Preprocessing & Exploratory Data Analysis (EDA):
- Initial processing stage that would be managed within the Jupyter notebook (ghouls-goblins-and-ghosts-boo_Kaggle.ipynb). This stage typically involves data cleaning, visualization, and possibly transformation.
- Model Training:
- Model training process. From the notebook or an associated script, the training would use classification algorithms (like Neural Networks). Include a component for “Model Training & Hyperparameter Tuning.”
- Use of possible engineered features (feature engineering) from the data.
- Model Artifacts & Serialization:
- That the trained model is saved in two formats: the serialized Pickle file (Pickles/best_model_std.pkl) and the TensorFlow/Keras model saved in the “model” folder (which includes fingerprint, keras metadata, saved_model, and variables files).
- “model.log” which tracks training progress or evaluation metrics.
- Prediction/Output Generation:

##### Out Relationships & Data Flow
- After training, indicate the model serialization step leading into two parallel “model storage” artifacts (Pickle and TensorFlow/Keras formats).

##### Architectural Patterns and Important Technologies
- That the system is modular – data handling, EDA, training, and prediction are conceptually separated.
- If applicable, note that the workflow follows a typical end-to-end ML pipeline.
- Frameworks like Pandas, Matplotlib/Seaborn (for EDA), and TensorFlow/Keras (for modeling) and Python’s Pickle for model serialization.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Dataset["Dataset Source"]:::data
    EDA["Data Preprocessing & EDA"]:::eda
    TrainCode["Training Code"]:::training
    TrainLog["Training Log"]:::training
    Pickle["Pickle Model"]:::serialization
    TFModel["TF/Keras Model"]:::serialization
    Prediction["Prediction & Submission Generation"]:::prediction

    Dataset -->|"processes"| EDA
    EDA -->|"triggers"| TrainCode
    TrainCode -->|"logs"| TrainLog
    TrainLog -->|"serializes"| Pickle
    TrainLog -->|"serializes"| TFModel
    Pickle -->|"feeds"| Prediction
    TFModel -->|"feeds"| Prediction

    click Dataset "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/tree/main/Data/"
    click EDA "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/blob/main/ghouls-goblins-and-ghosts-boo_Kaggle.ipynb"
    click TrainCode "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/blob/main/ghouls-goblins-and-ghosts-boo_Kaggle.ipynb"
    click TrainLog "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/blob/main/model.log"
    click Pickle "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/blob/main/Pickles/best_model_std.pkl"
    click TFModel "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/tree/main/model/"
    click Prediction "https://github.com/aurelienggt/ghouls-goblins-and-ghosts-boo/blob/main/Data/sample_submission.csv.zip"

    classDef data fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef eda fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef training fill:#FFD700,stroke:#000,stroke-width:2px;
    classDef serialization fill:#9370DB,stroke:#000,stroke-width:2px;
    classDef prediction fill:#FFA500,stroke:#000,stroke-width:2px;
```
