# syt20/deep-learning-cryptocurrency-forecasting-engine architecture

> Architecture diagram of the GitHub repository syt20/deep-learning-cryptocurrency-forecasting-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/syt20/deep-learning-cryptocurrency-forecasting-engine
- Repository: https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine

## Overview

##### Project Type and Purpose
- This is a data-science / exploratory forecasting tool built around a Jupyter Notebook (`BitScry.ipynb`).

##### File Structure
- Top-level:
- BitScry.ipynb – the main orchestration and user interface for experiments.
- Data/bitcoin.csv – raw input data source.
- Experiments_Results/ – generated performance plots (MAE, MSE, etc.).
- Model_comparison_result/ – final comparison graph of different models.
- requirements.txt – pinned Python dependencies.
- No separate frontend/backend; the notebook drives everything.
- Results folders act as storage for outputs from various pipeline stages.

##### README for Insights
- Dependencies highlight major libraries: Pandas/Polars/Dask for data; TensorFlow/Keras/scikit-learn for modeling; Plotly/Folium/Matplotlib for visualization.
- Emphasis on interactive prototyping and consistent environment via `requirements.txt`.

##### Main Components and Their Interactions
1. Data Source (CSV)
- Reads `Data/bitcoin.csv` via Pandas/Polars/DuckDB
2. Data Processing
- Uses Dask or Polars, NumPy, SymPy for any transformations
3. Model Training
- Uses TensorFlow/Keras or scikit-learn to fit forecasting models
4. Experiment Evaluation
- Calculates metrics (MAE, MSE, RMSE, etc.), saves plots in `Experiments_Results`
5. Visualization & Reporting
- Renders comparison in the notebook and saves final graph under `Model_comparison_result`
6. Dependency Management
- `requirements.txt` ensures reproducibility; runs under pip environment

1 → 2 → 3 → 4 → 5

##### Architectural Patterns and Design Principles
- Pipeline pattern: sequential data transformations and model stages.
- Reproducibility: explicit dependency management.

## Diagram (Mermaid)

```mermaid
flowchart TD
    DM["6. Dependencies"]:::dependency
    BI1["1. Data Ingestion"]:::data
    DC["2. Data Cleaning"]:::data
    MT["3. Model Training"]:::model
    EE["4. Experiment Evaluation"]:::evaluation
    VR["5. Visualization"]:::visualization

    DM --> BI1
    DM --> DC
    DM --> MT
    DM --> EE
    DM --> VR

    BI1 --> DC
    DC --> MT
    MT --> EE
    EE --> VR

    click DM "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/blob/main/requirements.txt"
    click BI1 "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/blob/main/Data/bitcoin.csv"
    click DC "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/blob/main/BitScry.ipynb"
    click MT "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/blob/main/BitScry.ipynb"
    click EE "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/tree/main/Experiments_Results/"
    click VR "https://github.com/syt20/deep-learning-cryptocurrency-forecasting-engine/tree/main/Model_comparison_result/"

    classDef data fill:#cce5ff,stroke:#005cbf,color:#004085
    classDef model fill:#d4edda,stroke:#155724,color:#155724
    classDef evaluation fill:#fff3cd,stroke:#856404,color:#856404
    classDef visualization fill:#f3e5f5,stroke:#6a1b9a,color:#4a148c
    classDef dependency fill:#f0f0f0,stroke:#6c757d,color:#343a40
```
