Energy-Consumption-Anomaly-Detection

Model Card for energy-consumption-anomaly-detection

A Random Forest classifier for detecting anomalies in hourly energy meter readings across 200 commercial buildings, with per-building MinMax scaling and engineered temporal/statistical features.

Model Details

Model Description

This model classifies hourly energy meter readings as Normal or Anomaly, enabling automated monitoring of large-scale building infrastructure without manual review of individual meter logs. It was selected after comparing five candidate models (Transformer Autoencoder, LSTM Autoencoder, XGBoost, LightGBM, Random Forest) and achieved the best precision/recall balance on a highly imbalanced dataset (98.5% normal vs. 1.5% anomaly).

• Developed by: Vikaash17
• Model type: Random Forest Classifier (tabular, binary classification)
• Language(s): N/A (tabular numeric data)
• License: Apache 2.0
• Trained from scratch: Yes (not fine-tuned from a pretrained model)

Model Sources

• GitHub Repository: https://github.com/Vikaash-17/Energy_Consumption_Anomaly_Detection
• Hugging Face Repository: https://huggingface.co/Vikaash17/Energy-Consumption-Anomaly-Detection

Note: The trained model file (~222MB) is hosted here on Hugging Face rather than GitHub due to GitHub's file size limits. The Flask web application code, preprocessing pipeline, and dashboard remain in the GitHub repository.

Out-of-Scope Use

Not intended for buildings outside the original 200-building training set without validation, non-hourly reading frequencies, or meter types substantially different from those in training. Not designed as a general-purpose anomaly detector for non-energy tabular data.

Bias, Risks, and Limitations

• Trained on 200 specific buildings; generalization to new buildings relies on a global fallback scaler and has not been extensively validated.
• Severe class imbalance (1.5% anomalies) means the model may still under-detect rare/novel anomaly patterns not represented in training data.

Recommendations

Users should validate performance on new buildings before production use, and treat predictions for buildings with historically lower F1 scores (e.g., Building 240) with additional scrutiny.

How to Get Started with the Model

The model is serialized using skops, a secure format for sharing scikit-learn models that avoids the arbitrary code execution risks associated with pickle.

import pandas as pd
from skops.io import load
from huggingface_hub import hf_hub_download

model_path = hf_hub_download(
    repo_id="Vikaash17/Energy-Consumption-Anomaly-Detection",
    filename="model.skops"  # replace with your actual filename in the repo
)

model = load(model_path)

# Input requires 15 engineered features (see Training Data section)
# X = preprocessed_dataframe[feature_columns]
predictions = model.predict_proba(X)[:, 1]
anomaly_flag = predictions >= 0.20  # optimal threshold

Training Details

Training Data

Hourly energy meter readings from 200 commercial buildings over a full year (8,736 hours), ~1.4M+ records. Raw inputs: building_id, timestamp, meter_reading. Anomaly labels were generated via statistical deviation analysis. Dataset is not publicly available.

Feature Engineering

15 engineered features computed from the 3 raw inputs, requiring a minimum of 49 prior readings per building:

Training Procedure

• Train/test split: 80% / 20%
• Class-imbalance-aware evaluation (98.5% normal / 1.5% anomaly)
• Detection threshold tuned via precision-recall curve analysis (optimal: 0.20, vs. default 0.50)

Evaluation

Model Comparison

Threshold Optimization

Per-Building Performance

Summary

Random Forest outperformed all other candidates, including deep learning approaches, largely due to the tabular nature of the feature set and severe class imbalance, which disadvantaged the autoencoder-based models. XGBoost and LightGBM had strong recall but weaker precision (more false alarms). Threshold tuning improved anomaly recall from 0.68 to 0.89 vs. the default 0.50 threshold.

Technical Specifications

Model Architecture and Objective

Random Forest Classifier (scikit-learn) with tuned decision threshold (0.20), trained for binary anomaly classification on engineered tabular features.

Compute Infrastructure

Software

• Python 3.x
• scikit-learn
• Pandas, NumPy
• skops (model serialization)
• Flask (deployment/web app)

Model Card Contact

Vikaash17 — via Hugging Face profile or GitHub repository issues.