Gumball2k5 commited on
Commit
c48d808
·
verified ·
1 Parent(s): 47cc2b2

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +0 -52
README.md CHANGED
@@ -12,55 +12,3 @@ pinned: false
12
  short_description: Predict the weather of Saigon
13
  license: unknown
14
  ---
15
-
16
- # 🌦️ Saigon Temperature Forecasting Application
17
- **An Interactive Dual-Model Forecasting Web App**
18
-
19
- An interactive web application built with Streamlit to forecast the weather in Ho Chi Minh City (Saigon). This app provides both **5-day (daily) forecasts** using a Champion Stacking model and **24-hour (hourly) forecasts** using 24 specialized LightGBM models.
20
-
21
- ![ảnh](https*://i.imgur.com/your-screenshot-url.png)
22
- *(Gợi ý: Thay thế URL này bằng ảnh chụp màn hình ứng dụng của bạn)*
23
-
24
- ---
25
- ## 📋 Table of Contents
26
- - [Project Goal](#-project-goal)
27
- - [Features](#-features)
28
- - [Tech Stack](#-tech-stack)
29
- - [Project Structure](#-project-structure)
30
-
31
- ---
32
- ## 🎯 Project Goal
33
- The primary objective of this project is to build an end-to-end machine learning application that forecasts the temperature in Ho Chi Minh City. The project covers the complete ML lifecycle, from data collection and feature engineering to model training, evaluation, and deployment as an interactive web app with two distinct forecasting systems (daily and hourly).
34
-
35
- ---
36
- ## ✨ Features
37
- - **Dual Forecasting Modes**: Provides both 5-day (Daily) and 24-hour (Hourly) predictions.
38
- - **Interactive Visualizations**:
39
- - **Historical Context**: Displays actual temperatures for the 14 days (Daily) or 24 hours (Hourly) leading up to the forecast.
40
- - **Smart Forecast vs. Actual**: Compares the forecast against real temperatures, automatically hiding "Actual" data if it's not yet available (for future dates).
41
- - **Training Set Overview**: A full plot of the training data with an interactive range slider and fixed Y-axis for easy exploration.
42
- - **Model Explainability (XAI)**:
43
- - **Forecast Insights (Why?)**: Dynamically generated insights based on key input features (e.g., "Yesterday was very hot...").
44
- - **Feature Inspector**: An expandable section detailing the exact feature values the model used for its prediction (e.g., `temp_lag_1`, `humidity`, `day_of_year`).
45
- - **Performance Dashboard**:
46
- - **Performance Degradation**: Visualizes how model error (RMSE) and accuracy (R²) degrade over the 5-day or 24-hour horizon.
47
- - **Interactive Scatter Plot**: A slider allows users to dynamically inspect the "Forecast vs. Actual" performance for any specific horizon (Day 1-5 or Hour 1-24).
48
- - **Model Diagnostics**: An expandable "Deep Dive" section with residual plots to prove model stability.
49
-
50
- ---
51
- ## 🛠️ Tech Stack
52
- - **Backend & Modeling**:
53
- - **Python**: Core programming language.
54
- - **Pandas**: Data manipulation and analysis.
55
- - **Scikit-learn**: For Stacking Regressor and model evaluation.
56
- - **LightGBM**: The gradient boosting model used for hourly forecasting.
57
- - **Joblib**: For model persistence (loading `.pkl` files).
58
- - **Frontend & Visualization**:
59
- - **Streamlit**: For building the interactive web application.
60
- - **Plotly**: For creating interactive charts and visualizations.
61
-
62
- ---
63
- ## 📂 Project Structure
64
- | |-- data/ | |-- final_dataset_tree.csv # Daily features/targets | |-- final_hourly_feature_dataset.csv # Hourly features/targets | |-- final_5_day_results_df.csv # Daily model performance (RMSE/R2) | |-- hourly_120h_evaluation_results.csv # Hourly model performance (RMSE) | |-- results_df_all_tuned.csv # Model selection leaderboard | |-- models/ | |-- champion_stacking_day1.pkl # ... (5 daily models) | |-- lgbm_model_target_temp_next_1h.pkl # ... (24 hourly models) | |-- src/ | |-- benchmark_utils.py # Utility for loading the leaderboard | |-- diagnostic_plots.py # Utility for plotting performance graphs | |-- app.py # The main Streamlit application script |-- requirements.txt # A list of all required Python packages |-- README.md # This file
65
-
66
- ---
 
12
  short_description: Predict the weather of Saigon
13
  license: unknown
14
  ---