Skip to main content

A python package for Interpretable Feature Extraction of Electricity Loads (IFEEL)

Project description

Interpretable Feature Extraction of Electricity Loads (IFEEL)

  • A python package for Interpretable Feature Extraction of Electricity Loads (IFEEL).
  • IFEEL has a similar pronunciation to the Eiffel Tower 🗼 so you will find two "Eiffel" electricity towers in the IFEEL logo.
  • Description of IFEEL can be found on GitHub 🔗 (Recommended, no image loading issue) or PyPI 🔗

📌 Illustration:

Illustration of IFEEL process

Note: If the picture fails to load, please click here.

⚙️ Installation:

You can use pip to easily install IFEEL with:

pip install ifeel

More info about pip can be found here .

🤖 Developer info:

💬 About IFEEL:

(1) This Python package (i.e., IFEEL) aims to help energy data analysts to readily extract interpretable features of daily electricity profiles from a physical perspective. The extracted features can be applied for further feature-based machine learning purposes, including feature-based PCA, clustering, classification, and regression.

(2) Two PY files (.py) are included in the IFEEL package, including ifeel_transformation.py and ifeel_extraction.py.

(3) Two types of features, including 13 global features (GFs) and 8 peak-period features (PFs), can be extracted by using this package. Detailed description of all features can be found in Ref [1] or the Demo file in the installed IFEEL package.

(4) GFs are extracted based on raw time-series data, while PFs are extracted based on symbolic representation of time series data. GFs and PFs can be obtained by using IFEEL.ifeel_extraction.feature_global and IFEEL.ifeel_extraction.feature_peak_period, respectively.

(5) For fast peak-period feature extraction, Symbolic Aggregate approXimation (SAX) representation is first used to transform the time-series numerical patterns into alphabetical words. The feature transformation process is performed by calling IFEEL.ifeel_transformation.feature_transformation. More details about SAX approach can be found in Ref [2] and Ref [3].

🔈 Notes:

(1) To successfully run the IFEEL, the following Python data analysis libraries need to be installed in advance: Numpy, Scipy, and Pandas.

(2) A Demo can be found in the installed IFEEL package or here. Three datasets at different time intervals can be downloaded here, and tested in the Demo.

(3) The Demo has been tested on Python 3.7.7.

📚 References

[1] Hu M, Ge D, Telford R, Stephen B, Wallom D. Classification and characterization of intra-day load curves of PV and non-PV households using interpretable feature extraction and feature-based clustering. Sustainable Cities and Society. 2021;75:103380.

[2] Lin J, Keogh E, Wei L, Lonardi S. Experiencing SAX: a novel symbolic representation of time series. Data Mining and Knowledge Discovery. 2007;15:107-44.

[3] Keogh E, Lin J, Fu A. HOT SAX: efficiently finding the most unusual time series subsequence. 5TH IEEE International Conference on Data Mining (ICDM'05). 2005. p8.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ifeel-1.5.1.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ifeel-1.5.1-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file ifeel-1.5.1.tar.gz.

File metadata

  • Download URL: ifeel-1.5.1.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for ifeel-1.5.1.tar.gz
Algorithm Hash digest
SHA256 ced972fbcdeb7dfb7c3711ffbfcad70d2152b57a8c858322314a3213cb663d65
MD5 fa5fbabc41016923c0607eb25371e519
BLAKE2b-256 e13e6892da8e5df93521055f6f6339327d190d5c068252774d98625a07daa465

See more details on using hashes here.

File details

Details for the file ifeel-1.5.1-py3-none-any.whl.

File metadata

  • Download URL: ifeel-1.5.1-py3-none-any.whl
  • Upload date:
  • Size: 15.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for ifeel-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ea991fff42f3003e11ec630b9526c998d196e522ea437f24b3c48b2024ab957
MD5 6f99d2c2cf707bd49f5a71df5c3e8166
BLAKE2b-256 73929997bb2c582c06af9ab1061ff7226396ccfbd225c642304c232adcf5930e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page