iotlabkit 1.0.0__py3-none-any.whl

iotlabkit/templates/program_17.py

@@ -0,0 +1,422 @@
+"""Template generator for Program 17: Random Forest Multi-Class Air Quality Classification."""
+
+import os
+from typing import Dict
+
+
+def generate(target_dir: str, mode: str = "learning") -> Dict[str, str]:
+    files = {}
+
+    files["requirements.txt"] = (
+        "pandas>=1.5.0\n"
+        "scikit-learn>=1.2.0\n"
+        "matplotlib>=3.6.0\n"
+        "joblib>=1.2.0\n"
+        "streamlit>=1.25.0\n"
+    )
+
+    files[".env.example"] = (
+        "# Random Forest Model Settings\n"
+        "MODEL_PATH=model/air_quality_rf.joblib\n"
+        "N_ESTIMATORS=100\n"
+    )
+
+    files[".gitignore"] = (
+        ".env\n"
+        "__pycache__/\n"
+        "*.py[cod]\n"
+        "model/*.joblib\n"
+        "output/*.png\n"
+    )
+
+    # Embed genuine balanced dataset
+    data_path = os.path.join(os.path.dirname(os.path.dirname(__file__)), "data", "india_air", "city_day_sample.csv")
+    if os.path.exists(data_path):
+        with open(data_path, "r", encoding="utf-8") as f:
+            files["data/city_day_sample.csv"] = f.read()
+
+    # data/download_dataset.py
+    files["data/download_dataset.py"] = (
+        '"""Dataset Downloader for Kaggle Indian Air Quality (Rohan Rao, CC0 Public Domain).\n\n'
+        "Supports downloading via authenticated Kaggle CLI or mirror URL without hardcoding credentials.\n"
+        '"""\n\n'
+        "import os\n"
+        "import sys\n"
+        "import requests\n\n"
+        "MIRROR_URL = 'https://raw.githubusercontent.com/vikramforsk2019/Streamlit/master/city_day.csv'\n"
+        "TARGET_FILE = os.path.join(os.path.dirname(__file__), 'city_day_sample.csv')\n\n"
+        "def main():\n"
+        "    print('Kaggle Air Quality Data in India (city_day.csv)')\n"
+        "    print('Dataset URL: https://www.kaggle.com/datasets/rohanrao/air-quality-data-in-india')\n"
+        "    print('-' * 60)\n"
+        "    print('Options to obtain full dataset:')\n"
+        "    print('  Option 1: Using Kaggle CLI (if configured):')\n"
+        "    print('    kaggle datasets download -d rohanrao/air-quality-data-in-india -f city_day.csv -p data/ --unzip')\n"
+        "    print('\\n  Option 2: Direct public mirror download...')\n\n"
+        "    try:\n"
+        "        print(f\"Fetching mirror from {MIRROR_URL}...\")\n"
+        "        resp = requests.get(MIRROR_URL, timeout=25)\n"
+        "        if resp.status_code == 200:\n"
+        "            with open(TARGET_FILE, 'w', encoding='utf-8') as f:\n"
+        "                f.write(resp.text)\n"
+        "            lines = resp.text.strip().split('\\n')\n"
+        "            print(f\"✓ Downloaded full dataset ({len(lines) - 1} rows) to '{TARGET_FILE}'.\")\n"
+        "        else:\n"
+        "            print(f\"✗ Server returned HTTP {resp.status_code}\")\n"
+        "    except Exception as e:\n"
+        "        print(f\"✗ Mirror download failed: {e}\")\n"
+        "        print(\"\\nPlease download 'city_day.csv' manually from Kaggle and place it in the 'data/' directory.\")\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # train.py
+    if mode == "learning":
+        train_doc = (
+            '"""Random Forest Air Quality Classifier Training - Program 17.\n\n'
+            "Trains an ensemble Random Forest model on Indian Air Quality data (`city_day.csv`).\n"
+            "Predicts the official CPCB Air Quality Index category (Good, Satisfactory, Moderate, Poor, Very Poor, Severe)\n"
+            "from 6 criteria pollutants: PM2.5, PM10, NO2, CO, SO2, and O3.\n"
+            '"""\n'
+        )
+    else:
+        train_doc = '"""Random Forest Air Quality Classifier - Program 17 (Exam Mode)."""\n'
+
+    files["train.py"] = train_doc + (
+        "import os\n"
+        "import sys\n"
+        "import joblib\n"
+        "try:\n"
+        "    import matplotlib.pyplot as plt\n"
+        "    HAS_MATPLOTLIB = True\n"
+        "except ImportError:\n"
+        "    HAS_MATPLOTLIB = False\n"
+        "import pandas as pd\n"
+        "from sklearn.ensemble import RandomForestClassifier\n"
+        "from sklearn.metrics import accuracy_score, classification_report, confusion_matrix\n"
+        "from sklearn.model_selection import train_test_split\n\n"
+        "DATA_PATH = os.path.join(os.path.dirname(__file__), 'data', 'city_day_sample.csv')\n"
+        "MODEL_DIR = os.path.join(os.path.dirname(__file__), 'model')\n"
+        "OUTPUT_DIR = os.path.join(os.path.dirname(__file__), 'output')\n\n"
+        "# Authoritative Central Pollution Control Board (CPCB) India National Air Quality Index Standard\n"
+        "CPCB_CLASSES = ['Good', 'Satisfactory', 'Moderate', 'Poor', 'Very Poor', 'Severe']\n"
+        "LABEL_TO_ID = {name: idx for idx, name in enumerate(CPCB_CLASSES)}\n"
+        "ID_TO_LABEL = {idx: name for idx, name in enumerate(CPCB_CLASSES)}\n\n"
+        "def derive_cpcb_bucket(aqi: float) -> str:\n"
+        "    \"\"\"Derives official CPCB category from numerical AQI if AQI_Bucket is unpopulated.\"\"\"\n"
+        "    if pd.isna(aqi):\n"
+        "        return None\n"
+        "    if aqi <= 50:\n"
+        "        return 'Good'\n"
+        "    elif aqi <= 100:\n"
+        "        return 'Satisfactory'\n"
+        "    elif aqi <= 200:\n"
+        "        return 'Moderate'\n"
+        "    elif aqi <= 300:\n"
+        "        return 'Poor'\n"
+        "    elif aqi <= 400:\n"
+        "        return 'Very Poor'\n"
+        "    else:\n"
+        "        return 'Severe'\n\n"
+        "def main():\n"
+        "    if not os.path.exists(DATA_PATH):\n"
+        "        print(f\"✗ Error: Dataset '{DATA_PATH}' not found.\")\n"
+        "        print(\"  Run `python data/download_dataset.py` to obtain city_day.csv.\")\n"
+        "        sys.exit(1)\n\n"
+        "    print('=' * 75)\n"
+        "    print('🌲 Program 17: Random Forest Air Quality Classification')\n"
+        "    print('=' * 75)\n"
+        "    print(f\"Loading dataset from: {DATA_PATH}...\")\n"
+        "    df = pd.read_csv(DATA_PATH)\n"
+        "    print(f\"✓ Loaded {len(df)} records. Inspecting schema...\")\n\n"
+        "    features = ['PM2.5', 'PM10', 'NO2', 'CO', 'SO2', 'O3']\n"
+        "    # Check features\n"
+        "    for f in features:\n"
+        "        if f not in df.columns:\n"
+        "            raise ValueError(f\"Required pollutant column '{f}' missing from dataset!\")\n\n"
+        "    # Verify or derive target label\n"
+        "    if 'AQI_Bucket' in df.columns:\n"
+        "        # Fill any missing AQI_Bucket from numerical AQI if available\n"
+        "        missing_buckets = df['AQI_Bucket'].isna()\n"
+        "        if missing_buckets.any() and 'AQI' in df.columns:\n"
+        "            df.loc[missing_buckets, 'AQI_Bucket'] = df.loc[missing_buckets, 'AQI'].apply(derive_cpcb_bucket)\n"
+        "    elif 'AQI' in df.columns:\n"
+        "        print(\"Notice: 'AQI_Bucket' missing. Deriving from numerical AQI using official CPCB thresholds...\")\n"
+        "        df['AQI_Bucket'] = df['AQI'].apply(derive_cpcb_bucket)\n"
+        "    else:\n"
+        "        raise ValueError(\"Neither 'AQI_Bucket' nor 'AQI' present in dataset!\")\n\n"
+        "    # Drop rows without valid CPCB class\n"
+        "    df = df[df['AQI_Bucket'].isin(CPCB_CLASSES)].copy()\n\n"
+        "    # Convert features to numeric and impute missing values using median\n"
+        "    for f in features:\n"
+        "        df[f] = pd.to_numeric(df[f], errors='coerce')\n"
+        "        median_val = df[f].median()\n"
+        "        df[f] = df[f].fillna(median_val)\n\n"
+        "    X = df[features]\n"
+        "    y = df['AQI_Bucket'].map(LABEL_TO_ID)\n\n"
+        "    print('\\nTarget Class Distribution:')\n"
+        "    counts = df['AQI_Bucket'].value_counts()\n"
+        "    for c in CPCB_CLASSES:\n"
+        "        print(f\"  - {c:<14}: {counts.get(c, 0):>4} records\")\n\n"
+        "    # Stratified Train-Test Split (80% Train, 20% Test)\n"
+        "    X_train, X_test, y_train, y_test = train_test_split(\n"
+        "        X, y, test_size=0.20, random_state=42, stratify=y\n"
+        "    )\n"
+        "    print(f\"\\nTraining set: {len(X_train)} samples | Testing set: {len(X_test)} samples\")\n\n"
+        "    # Train Random Forest Classifier\n"
+        "    rf = RandomForestClassifier(n_estimators=100, max_depth=10, random_state=42, n_jobs=-1)\n"
+        "    rf.fit(X_train, y_train)\n\n"
+        "    # Evaluate on Test Set\n"
+        "    y_pred = rf.predict(X_test)\n"
+        "    acc = accuracy_score(y_test, y_pred)\n"
+        "    cm = confusion_matrix(y_test, y_pred)\n"
+        "    report = classification_report(y_test, y_pred, target_names=CPCB_CLASSES)\n\n"
+        "    print('\\n' + '=' * 75)\n"
+        "    print('📊 Random Forest Classification Results (Test Set):')\n"
+        "    print('=' * 75)\n"
+        "    print(f\"Overall Accuracy: {acc * 100:.2f}%\")\n"
+        "    print('\\nClassification Report:')\n"
+        "    print(report)\n"
+        "    print('=' * 75)\n\n"
+        "    # Feature Importances\n"
+        "    importances = rf.feature_importances_\n"
+        "    print('\\nPollutant Feature Importances (Gini Reduction):')\n"
+        "    for feat, imp in sorted(zip(features, importances), key=lambda x: x[1], reverse=True):\n"
+        "        print(f\"  - {feat:<8}: {imp * 100:>5.2f}%\")\n\n"
+        "    # Save Model Bundle\n"
+        "    os.makedirs(MODEL_DIR, exist_ok=True)\n"
+        "    os.makedirs(OUTPUT_DIR, exist_ok=True)\n"
+        "    bundle = {\n"
+        "        'model': rf,\n"
+        "        'features': features,\n"
+        "        'classes': CPCB_CLASSES,\n"
+        "        'accuracy': acc\n"
+        "    }\n"
+        "    model_path = os.path.join(MODEL_DIR, 'air_quality_rf.joblib')\n"
+        "    joblib.dump(bundle, model_path)\n"
+        "    print(f\"\\n✓ Saved model bundle to: {model_path}\")\n\n"
+        "    if HAS_MATPLOTLIB:\n"
+        "        # Chart 1: Confusion Matrix Heatmap\n"
+        "        plt.figure(figsize=(7, 6))\n"
+        "        plt.imshow(cm, interpolation='nearest', cmap=plt.cm.Greens)\n"
+        "        plt.title(f'Random Forest Confusion Matrix (Accuracy: {acc*100:.1f}%)')\n"
+        "        plt.colorbar()\n"
+        "        ticks = range(len(CPCB_CLASSES))\n"
+        "        plt.xticks(ticks, CPCB_CLASSES, rotation=45, ha='right')\n"
+        "        plt.yticks(ticks, CPCB_CLASSES)\n"
+        "        thresh = cm.max() / 2.\n"
+        "        for i in range(len(CPCB_CLASSES)):\n"
+        "            for j in range(len(CPCB_CLASSES)):\n"
+        "                plt.text(j, i, format(cm[i, j], 'd'), ha='center', va='center',\n"
+        "                         color='white' if cm[i, j] > thresh else 'black')\n"
+        "        plt.ylabel('True CPCB Bucket')\n"
+        "        plt.xlabel('Predicted CPCB Bucket')\n"
+        "        plt.tight_layout()\n"
+        "        p1 = os.path.join(OUTPUT_DIR, 'confusion_matrix.png')\n"
+        "        plt.savefig(p1, dpi=150, bbox_inches='tight')\n"
+        "        plt.close()\n"
+        "        print(f\"✓ Saved Confusion Matrix: {p1}\")\n\n"
+        "        # Chart 2: Feature Importances Bar Chart\n"
+        "        plt.figure(figsize=(7, 4))\n"
+        "        plt.barh(features, importances, color='forestgreen')\n"
+        "        plt.title('Air Pollutant Importance for AQI Classification')\n"
+        "        plt.xlabel('Importance')\n"
+        "        plt.grid(axis='x', linestyle='--', alpha=0.6)\n"
+        "        p2 = os.path.join(OUTPUT_DIR, 'feature_importances.png')\n"
+        "        plt.savefig(p2, dpi=150, bbox_inches='tight')\n"
+        "        plt.close()\n"
+        "        print(f\"✓ Saved Feature Importance Chart: {p2}\")\n"
+        "    else:\n"
+        "        print(\"\\nℹ️  Notice: matplotlib not installed. Evaluation metrics (Accuracy, F1, Confusion Matrix) printed above. Install matplotlib to save PNG charts.\")\n\n"
+        "    print('\\nReady for inference! Test: python predict.py --pm25 85 --pm10 140 --no2 32 --co 1.2 --so2 15 --o3 45')\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # predict.py
+    if mode == "learning":
+        pred_doc = (
+            '"""Air Quality Classification Inference - Program 17.\n\n'
+            "Loads the trained Random Forest model and classifies a new set of ambient pollutant\n"
+            "readings (PM2.5, PM10, NO2, CO, SO2, O3) into one of the 6 official CPCB AQI categories.\n"
+            '"""\n'
+        )
+    else:
+        pred_doc = '"""Air Quality Inference - Program 17 (Exam Mode)."""\n'
+
+    files["predict.py"] = pred_doc + (
+        "import argparse\n"
+        "import os\n"
+        "import sys\n"
+        "import joblib\n"
+        "import pandas as pd\n\n"
+        "MODEL_PATH = os.path.join(os.path.dirname(__file__), 'model', 'air_quality_rf.joblib')\n\n"
+        "def main():\n"
+        "    parser = argparse.ArgumentParser(description='Classify air quality from pollutant readings')\n"
+        "    parser.add_argument('--pm25', type=float, default=85.0, help='PM2.5 concentration in μg/m³')\n"
+        "    parser.add_argument('--pm10', type=float, default=140.0, help='PM10 concentration in μg/m³')\n"
+        "    parser.add_argument('--no2', type=float, default=32.0, help='NO2 concentration in μg/m³')\n"
+        "    parser.add_argument('--co', type=float, default=1.2, help='CO concentration in mg/m³')\n"
+        "    parser.add_argument('--so2', type=float, default=15.0, help='SO2 concentration in μg/m³')\n"
+        "    parser.add_argument('--o3', type=float, default=45.0, help='O3 concentration in μg/m³')\n"
+        "    args = parser.parse_args()\n\n"
+        "    if not os.path.exists(MODEL_PATH):\n"
+        "        print(f\"✗ Error: Model file '{MODEL_PATH}' not found.\")\n"
+        "        print(\"  Run `python train.py` first to train the Random Forest model.\")\n"
+        "        sys.exit(1)\n\n"
+        "    bundle = joblib.load(MODEL_PATH)\n"
+        "    model = bundle['model']\n"
+        "    features = bundle['features']\n"
+        "    classes = bundle['classes']\n\n"
+        "    input_row = pd.DataFrame([{\n"
+        "        'PM2.5': args.pm25,\n"
+        "        'PM10': args.pm10,\n"
+        "        'NO2': args.no2,\n"
+        "        'CO': args.co,\n"
+        "        'SO2': args.so2,\n"
+        "        'O3': args.o3\n"
+        "    }])[features]\n\n"
+        "    pred_idx = model.predict(input_row)[0]\n"
+        "    probs = model.predict_proba(input_row)[0]\n"
+        "    pred_category = classes[pred_idx]\n"
+        "    confidence = probs[pred_idx] * 100\n\n"
+        "    print('=' * 65)\n"
+        "    print('🌲 Random Forest Air Quality Classification')\n"
+        "    print('=' * 65)\n"
+        "    print('Input Pollutant Concentrations:')\n"
+        "    print(f\"  - PM2.5 : {args.pm25:>6.1f} μg/m³\")\n"
+        "    print(f\"  - PM10  : {args.pm10:>6.1f} μg/m³\")\n"
+        "    print(f\"  - NO2   : {args.no2:>6.1f} μg/m³\")\n"
+        "    print(f\"  - CO    : {args.co:>6.1f} mg/m³\")\n"
+        "    print(f\"  - SO2   : {args.so2:>6.1f} μg/m³\")\n"
+        "    print(f\"  - O3    : {args.o3:>6.1f} μg/m³\")\n"
+        "    print('-' * 65)\n"
+        "    print(f\"Predicted CPCB AQI Bucket : {pred_category.upper()}\")\n"
+        "    print(f\"Classification Confidence : {confidence:.2f}%\")\n"
+        "    print('\\nClass Probabilities:')\n"
+        "    for c, p in zip(classes, probs):\n"
+        "        print(f\"  - {c:<14}: {p * 100:>5.1f}%\")\n"
+        "    print('=' * 65)\n\n"
+        "if __name__ == '__main__':\n"
+        "    main()\n"
+    )
+
+    # dashboard.py
+    files["dashboard.py"] = (
+        "import os\n"
+        "import joblib\n"
+        "import pandas as pd\n"
+        "import streamlit as st\n\n"
+        "st.set_page_config(page_title='Program 17: Air Quality Classifier', layout='wide')\n"
+        "st.title('🌲 Random Forest Air Quality Classification Dashboard')\n"
+        "st.caption('MSc/MCA IoT Practical — Program 17 (Indian CPCB AQI Standards)')\n\n"
+        "MODEL_PATH = os.path.join(os.path.dirname(__file__), 'model', 'air_quality_rf.joblib')\n\n"
+        "if not os.path.exists(MODEL_PATH):\n"
+        "    st.warning('Trained Random Forest model not found. Run `python train.py` in your terminal.')\n"
+        "else:\n"
+        "    bundle = joblib.load(MODEL_PATH)\n"
+        "    model = bundle['model']\n"
+        "    classes = bundle['classes']\n\n"
+        "    col1, col2 = st.columns([1, 1])\n"
+        "    with col1:\n"
+        "        st.subheader('🎛️ Input Pollutant Levels')\n"
+        "        pm25 = st.slider('PM2.5 (μg/m³)', 0.0, 500.0, 85.0, 1.0)\n"
+        "        pm10 = st.slider('PM10 (μg/m³)', 0.0, 800.0, 140.0, 5.0)\n"
+        "        no2 = st.slider('NO2 (μg/m³)', 0.0, 200.0, 32.0, 1.0)\n"
+        "        co = st.slider('CO (mg/m³)', 0.0, 30.0, 1.2, 0.1)\n"
+        "        so2 = st.slider('SO2 (μg/m³)', 0.0, 200.0, 15.0, 1.0)\n"
+        "        o3 = st.slider('O3 (μg/m³)', 0.0, 300.0, 45.0, 1.0)\n\n"
+        "    with col2:\n"
+        "        st.subheader('🎯 Predicted Air Quality Category')\n"
+        "        input_df = pd.DataFrame([{'PM2.5': pm25, 'PM10': pm10, 'NO2': no2, 'CO': co, 'SO2': so2, 'O3': o3}])\n"
+        "        pred_idx = model.predict(input_df)[0]\n"
+        "        probs = model.predict_proba(input_df)[0]\n"
+        "        pred_label = classes[pred_idx]\n\n"
+        "        color_map = {\n"
+        "            'Good': 'green', 'Satisfactory': 'lime',\n"
+        "            'Moderate': 'orange', 'Poor': 'red',\n"
+        "            'Very Poor': 'purple', 'Severe': 'maroon'\n"
+        "        }\n"
+        "        st.markdown(f\"### Status: **:{color_map.get(pred_label, 'blue')}[{pred_label.upper()}]**\")\n"
+        "        st.caption(f\"Confidence: {probs[pred_idx]*100:.1f}%\")\n\n"
+        "        prob_df = pd.DataFrame({'Category': classes, 'Probability': probs})\n"
+        "        st.bar_chart(prob_df.set_index('Category'))\n\n"
+        "    st.divider()\n"
+        "    st.subheader('📊 Training Evaluation Artifacts')\n"
+        "    c_img1, c_img2 = st.columns(2)\n"
+        "    output_dir = os.path.join(os.path.dirname(__file__), 'output')\n"
+        "    cm_p = os.path.join(output_dir, 'confusion_matrix.png')\n"
+        "    fi_p = os.path.join(output_dir, 'feature_importances.png')\n"
+        "    if os.path.exists(cm_p):\n"
+        "        c_img1.image(cm_p, caption='Multi-Class Confusion Matrix')\n"
+        "    if os.path.exists(fi_p):\n"
+        "        c_img2.image(fi_p, caption='Pollutant Feature Importances')\n"
+    )
+
+    # README.md
+    if mode == "learning":
+        readme_content = (
+            "# Program 17 — Random Forest Multi-Class Air Quality Classification\n\n"
+            "## 1. Overview\n"
+            "This practical implements an ensemble Random Forest classifier on authentic Indian Air Quality records:\n"
+            "- Uses the genuine **Kaggle Air Quality Data in India (`city_day.csv`)** dataset compiled by Rohan Rao (CC0 Public Domain).\n"
+            "- Analyzes 6 criteria pollutants: `PM2.5`, `PM10`, `NO2`, `CO`, `SO2`, and `O3`.\n"
+            "- Predicts the 6 official **Central Pollution Control Board (CPCB)** AQI buckets:\n"
+            "  - **Good** (0–50)\n"
+            "  - **Satisfactory** (51–100)\n"
+            "  - **Moderate** (101–200)\n"
+            "  - **Poor** (201–300)\n"
+            "  - **Very Poor** (301–400)\n"
+            "  - **Severe** (401–500)\n"
+            "- Evaluates model using stratified multi-class Accuracy, Classification Report, and Confusion Matrix.\n"
+            "- Ranks feature importances showing which pollutants govern health bucket transitions.\n"
+            "- Saves trained model to `model/air_quality_rf.joblib` with CLI and Streamlit inference.\n\n"
+            "## 2. Random Forest Ensemble Primer\n"
+            "Random Forest constructs $B$ decision trees on bootstrap samples of the training data. For each split, a random subset of $m \\approx \\sqrt{p}$ features is considered. The ensemble prediction is determined by majority vote:\n"
+            "$$\\hat{C}_{\\text{RF}}(x) = \\text{majority vote}\\left\\{ \\hat{C}_b(x) \\right\\}_{b=1}^B$$\n"
+            "This bagging technique drastically reduces model variance while maintaining low bias.\n\n"
+            "## 3. Step-by-Step Execution Guide\n\n"
+            "### Step A: Setup Environment\n"
+            "```bash\n"
+            "pip install -r requirements.txt\n"
+            "```\n\n"
+            "### Step B: Train Model & Evaluate\n"
+            "```bash\n"
+            "python train.py\n"
+            "```\n"
+            "Inspect accuracy score, per-class F1-scores, and generated charts in `output/`:\n"
+            "- `confusion_matrix.png`\n"
+            "- `feature_importances.png`\n\n"
+            "### Step C: Predict Air Quality on New Pollutant Readings\n"
+            "```bash\n"
+            "# Moderate winter day:\n"
+            "python predict.py --pm25 85 --pm10 140 --no2 32 --co 1.2 --so2 15 --o3 45\n\n"
+            "# Severe pollution episode:\n"
+            "python predict.py --pm25 320 --pm10 480 --no2 110 --co 4.5 --so2 35 --o3 80\n"
+            "```\n\n"
+            "### Step D: Interactive Dashboard\n"
+            "```bash\n"
+            "streamlit run dashboard.py\n"
+            "```\n\n"
+            "## 4. Viva Questions and Answers\n"
+            "**Q1: What are the 6 CPCB AQI health categories in India?**  \n"
+            "A: Good (0-50), Satisfactory (51-100), Moderate (101-200), Poor (201-300), Very Poor (301-400), and Severe (401-500).\n\n"
+            "**Q2: What is Bagging (Bootstrap Aggregation) in Random Forests?**  \n"
+            "A: Each tree is trained on an independently drawn random sample of the training dataset with replacement (bootstrap sample), and random subsets of features are evaluated at each split to decorrelate individual trees.\n"
+        )
+    else:
+        readme_content = (
+            "# Program 17 — Random Forest Air Quality Classification (Exam Mode)\n\n"
+            "## Execution\n"
+            "1. Train Random Forest: `python train.py`\n"
+            "2. Predict AQI Category: `python predict.py --pm25 85 --pm10 140 --no2 32 --co 1.2 --so2 15 --o3 45`\n"
+            "3. Dashboard: `streamlit run dashboard.py`\n\n"
+            "## Viva Q&A\n"
+            "- **Q: Why use Random Forest over a single Decision Tree?**  \n"
+            "  A: Random Forest averages predictions across dozens of decorrelated trees, substantially mitigating variance and preventing overfitting.\n"
+            "- **Q: What is the primary pollutant driving high Indian AQI values?**  \n"
+            "  A: Fine particulate matter (PM2.5), which typically exhibits the highest feature importance in CPCB classification models.\n"
+        )
+
+    files["README.md"] = readme_content
+    return files

iotlabkit-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iotlabkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.