Skip to main content

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.

Metadata

Release files for ifeel 1.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ifeel 1.5.1
File Size Uploaded Provenance Actions
ifeel-1.5.1.tar.gz 7.5 kB Without provenance Details for ifeel-1.5.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ifeel 1.5.1
File Interpreter ABI Platform Actions
ifeel-1.5.1-py3-none-any.whl Python 3 none any Details for ifeel-1.5.1-py3-none-any.whl

Total release size: 23.1 kB

Release files / ifeel-1.5.1.tar.gz

Download URL ifeel-1.5.1.tar.gz
Size 7.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ced972fbcdeb7dfb7c3711ffbfcad70d2152b57a8c858322314a3213cb663d65
BLAKE2b-256 checksum
How to use checksums
e13e6892da8e5df93521055f6f6339327d190d5c068252774d98625a07daa465
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / ifeel-1.5.1-py3-none-any.whl

Download URL ifeel-1.5.1-py3-none-any.whl
Size 15.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2ea991fff42f3003e11ec630b9526c998d196e522ea437f24b3c48b2024ab957
BLAKE2b-256 checksum
How to use checksums
73929997bb2c582c06af9ab1061ff7226396ccfbd225c642304c232adcf5930e
Upload date
Uploaded using Trusted Publishing?
What is 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

Security for ifeel 1.5.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page