Hugging Face's logo

GencoDiv
/
ramadan-demand-forecaster

Tabular Regression
Scikit-learn
Joblib
GradientBoostingRegressor
demand-forecasting
retail
xgboost
gcc
agentic-commerce
ocg-dubai
gulf-retail
e-commerce
Model card Files
xet
Community
GencoDiv commited on
Commit
6873db5
·
verified ·
1 Parent(s): 8abef47

Upload folder using huggingface_hub

Browse files
Files changed (5) hide show
  1. config.json +34 -40
  2. encoders.joblib +2 -2
  3. feature_importances.json +15 -13
  4. model.joblib +2 -2
  5. model.json +0 -0
config.json CHANGED
@@ -1,19 +1,36 @@
1
  {
2
- "model_type": "GradientBoostingRegressor",
3
- "feature_columns": [
 
 
 
 
 
 
 
4
  "is_ramadan",
5
  "ramadan_week",
6
- "days_to_eid",
7
  "is_eid_fitr",
8
  "is_eid_adha",
9
- "is_hajj_season",
10
- "country_encoded",
11
- "category_encoded",
12
- "temperature",
13
- "day_of_week",
14
- "month",
15
- "hijri_month",
16
- "hijri_day"
 
 
 
 
 
 
 
 
 
 
 
17
  ],
18
  "countries": [
19
  "Bahrain",
@@ -23,35 +40,12 @@
23
  "Qatar",
24
  "UAE"
25
  ],
26
- "categories": [
27
- "dates_sweets",
28
- "electronics",
29
- "fashion_abayas",
30
- "gifts",
31
- "groceries",
32
- "perfumes_oud"
33
- ],
34
  "metrics": {
35
- "mse": 24.44782802085175,
36
- "rmse": 4.944474493902436,
37
- "mae": 3.8228789470187383,
38
- "r2_score": 0.905699037541998
39
- },
40
- "description": "GCC Ramadan Retail Demand Forecasting Model",
41
- "input_features": {
42
- "is_ramadan": "Boolean (0/1) - Whether it is Ramadan",
43
- "ramadan_week": "Integer (0-5) - Week of Ramadan (0 if not Ramadan)",
44
- "days_to_eid": "Integer (-1 to 30) - Days until Eid (-1 if not applicable)",
45
- "is_eid_fitr": "Boolean (0/1) - Whether it is Eid al-Fitr",
46
- "is_eid_adha": "Boolean (0/1) - Whether it is Eid al-Adha",
47
- "is_hajj_season": "Boolean (0/1) - Whether it is Hajj season",
48
- "country": "String - One of: UAE, KSA, Qatar, Kuwait, Bahrain, Oman",
49
- "category": "String - Product category",
50
- "temperature": "Float - Temperature in Celsius",
51
- "day_of_week": "Integer (0-6) - Day of week",
52
- "month": "Integer (1-12) - Gregorian month",
53
- "hijri_month": "Integer (1-12) - Hijri month",
54
- "hijri_day": "Integer (1-30) - Hijri day"
55
  },
56
- "output": "demand_index - Predicted retail demand index"
 
 
57
  }
 
1
  {
2
+ "model_type": "xgboost_regressor",
3
+ "version": "2.0.0",
4
+ "features": [
5
+ "month",
6
+ "day_of_week",
7
+ "is_weekend",
8
+ "country_encoded",
9
+ "category_encoded",
10
+ "temperature",
11
  "is_ramadan",
12
  "ramadan_week",
 
13
  "is_eid_fitr",
14
  "is_eid_adha",
15
+ "is_shopping_festival",
16
+ "is_white_friday",
17
+ "is_national_day",
18
+ "is_back_to_school",
19
+ "year"
20
+ ],
21
+ "categories": [
22
+ "beauty_cosmetics",
23
+ "electronics_media",
24
+ "fashion_apparel",
25
+ "food_dining",
26
+ "groceries_fmcg",
27
+ "health_wellness",
28
+ "home_furniture",
29
+ "jewelry_watches",
30
+ "luxury_goods",
31
+ "sports_outdoor",
32
+ "toys_kids",
33
+ "travel_entertainment"
34
  ],
35
  "countries": [
36
  "Bahrain",
 
40
  "Qatar",
41
  "UAE"
42
  ],
 
 
 
 
 
 
 
 
43
  "metrics": {
44
+ "r2": 0.9922,
45
+ "rmse": 2.94,
46
+ "mae": 2.28
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
47
  },
48
+ "training_samples": 168307,
49
+ "test_samples": 42077,
50
+ "dataset": "gcc_retail_dataset_v2"
51
  }
encoders.joblib CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:da84e6211fe94a186197f3850a18bf6c3aae1f58360000a75f8590b8c5a2cc0a
3
- size 850
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:43d3c9ab03b0bbc5b75de9d90b843cfdcf4470c1853bf55dfd6c084206dba25b
3
+ size 977
feature_importances.json CHANGED
@@ -1,15 +1,17 @@
1
  {
2
- "is_ramadan": 3.69275253834204e-05,
3
- "ramadan_week": 0.003525943796247472,
4
- "days_to_eid": 0.29290416306240935,
5
- "is_eid_fitr": 0.0010144082359060686,
6
- "is_eid_adha": 0.0012917867230512092,
7
- "is_hajj_season": 0.10161264627734466,
8
- "country_encoded": 0.11934693744055763,
9
- "category_encoded": 0.3920205132356218,
10
- "temperature": 0.022141510058809637,
11
- "day_of_week": 0.0418962978935297,
12
- "month": 0.02049986667570955,
13
- "hijri_month": 0.00037238780289487874,
14
- "hijri_day": 0.0033366112725345945
 
 
15
  }
 
1
  {
2
+ "category_encoded": 0.8011219501495361,
3
+ "is_shopping_festival": 0.04841116815805435,
4
+ "is_eid_fitr": 0.03318003565073013,
5
+ "is_white_friday": 0.025203166529536247,
6
+ "ramadan_week": 0.021611016243696213,
7
+ "is_ramadan": 0.017199140042066574,
8
+ "is_eid_adha": 0.014950236305594444,
9
+ "country_encoded": 0.011384394951164722,
10
+ "is_back_to_school": 0.00958470068871975,
11
+ "is_weekend": 0.005489070899784565,
12
+ "year": 0.005111344624310732,
13
+ "is_national_day": 0.0038269669748842716,
14
+ "temperature": 0.0012196919415146112,
15
+ "month": 0.001135660451836884,
16
+ "day_of_week": 0.0005715535953640938
17
  }
model.joblib CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:69bef2bf5c0f86a0819e3a66afcf5a196fa3335ba8e17d87e3b6e31a7c69401a
3
- size 1760473
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:85392f1b97e62a9a963c3c3cddfd0173d5890ae6f7b73256ab0e843a4773671e
3
+ size 4680231
model.json CHANGED
The diff for this file is too large to render. See raw diff