Skip to content

BowonY/nilmtk

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nilmtk survey

Please fill in our NILMTK survey to help us get a better idea of who's using NILMTK and what's important to you.

Build Status

Coverage Status

Code Health

v0.2 Released!

v0.2 is a complete re-write. Please see the docs for details. The old v0.1 code is still available in the v0.1 branch and the old docs are in v0.1.1.

nilmtk: Non-Intrusive Load Monitoring Toolkit

Non-Intrusive Load Monitoring (NILM) is the process of estimating the energy consumed by individual appliances given just a whole-house power meter reading. In other words, it produces an (estimated) itemised energy bill from just a single, whole-house power meter.

NILM is sometimes called:

  • "non-intrusive appliance load monitoring (NALM or NIALM)"
  • "[electriciy | energy | smart meter] disaggregation"

Below is an illustration (produced using nilmtk) of what NILM, in general, can do.

Drawing

NILMTK Documentation

http://nilmtk.github.io/nilmtk/

NILMTK v0.2 BuildSys 2014 demo. This is the demo that Oli Parson presented at BuildSys 2014 in Memphis and it won best demo.

Academic paper on NILMTK

Batra, N., Kelly, J., Parson, O., Dutta, H., Knottenbelt, W., Rogers, A., Singh, A., Srivastava, M. (2014). NILMTK: An Open Source Toolkit for Non-intrusive Load Monitoring. In Fifth International Conference on Future Energy Systems (ACM e-Energy). Cambridge, UK. arXiv:1404.3878 DOI:10.1145/2602044.2602051

Bibtex:

@inproceedings{NILMTK,
   title         = {NILMTK: An Open Source Toolkit for
                    Non-intrusive Load Monitoring},
   year          = {2014},
   author        = {Batra, Nipun and Kelly, Jack and Parson, Oliver and
                    Dutta, Haimonti and Knottenbelt, William and
                    Rogers, Alex and Singh, Amarjeet and Srivastava, Mani},
   booktitle     = {Fifth International Conference on Future Energy
                    Systems (ACM e-Energy)},
   address       = {Cambridge, UK},
   archivePrefix = {arXiv},
   arxivId       = {1404.3878},
   doi           = {10.1145/2602044.2602051},
   eprint        = {1404.3878}
}

Please note that the paper was submitted back in Jan 2014 and the code has evolved a lot since then! Please do not use the paper as a guide to the current API. Instead please use the online docs.

We also wrote a short paper on some of the updates to NILMTK v0.2:

Kelly, J., Batra, N., Parson, O., Dutta, H., Knottenbelt, W., Rogers, A., Singh, A., Srivastava, M. (2014). NILMTK v0.2: A Non-intrusive Load Monitoring Toolkit for Large Scale Data Sets. In The first ACM Workshop On Embedded Systems For Energy-Efficient Buildings at BuildSys 2014. Memphis, USA. DOI:10.1145/2674061.2675024 arXiv:1409.5908

Bibtex:

@Inproceedings{kelly2014NILMTKv02,
  Title      = {NILMTK v0.2: A Non-intrusive Load Monitoring
                Toolkit for Large Scale Data Sets},
  Author     = {Kelly, Jack and Batra, Nipun and Parson, Oliver and
                Dutta, Haimonti and Knottenbelt, William and
                Rogers, Alex and Singh, Amarjeet and Srivastava, Mani},
  Booktitle  = {The first ACM Workshop On Embedded Systems For
                Energy-Efficient Buildings at BuildSys 2014},
  Year       = {2014},
  Doi        = {10.1145/2674061.2675024},
  Eprint     = {1409.5908},
  Eprinttype = {arXiv},
  Address    = {Memphis, USA}
}
Keeping up to date with NILMTK

Please sign up to the NILMTK-Announce mailing list to be kept up to speed on NILMTK. It will be a fairly low-traffic mailing list. We'll just announce new versions, new docs etc.

NILMTK is also on Twitter.

Current state of the project

The project is in its early stages.

Please note that NILMTK is currently a research tool. It is not yet ready for use by end-users, although we certainly hope that NILMTK will be capable of doing 'plug and play' disaggregation in the future.

Please see the docs for more info.

Installing on Ubuntu like Linux variants (debian based)

NB: The following procedure is for Ubuntu like Linux variants (debian based). Please adapt accordingly for your OS. We would welcome installation instructions for other OS as well. We would recommend using Anaconda, which bundles togther most of the required packages. After installing Anaconda, please do the following:

  • Updating anaconda
conda update --yes conda
  • Installing HDF5 libaries and python-dev
sudo apt-get install libhdf5-serial-dev python-dev
  • Installing git client
sudo apt-get install git
  • Installing pip and other dependencies which might be missing from Anaconda
conda install --yes pip numpy scipy six scikit-learn pandas numexpr pytables dateutil matplotlib networkx
git clone https://github.com/nilmtk/nilm_metadata/
cd nilm_metadata
python setup.py develop
cd ..
  • Installing postgresql support (currently needed for WikiEnergy converter)
sudo apt-get build-dep python-psycopg2
  • Misc. pip installs
pip install psycopg2 nose coveralls coverage
  • Finally! Install nilmtk
git clone https://github.com/nilmtk/nilmtk.git
cd nilmtk
python setup.py develop
cd..
  • Run tests
cd nilmtk
nosetests
Installing on Windows
  • Install Anaconda, which bundles togther most of the required packages.

  • Install git client

  • Installing pip and other dependencies which might be missing from Anaconda

$ conda install --yes pip numpy scipy six scikit-learn pandas numexpr pytables dateutil matplotlib networkx
$ git clone https://github.com/nilmtk/nilm_metadata/
$ cd nilm_metadata
$ python setup.py develop
$ cd ..
$ pip install nose pbs coveralls coverage
  • Finally! Install nilmtk from git bash
$ git clone https://github.com/nilmtk/nilmtk.git
$ cd nilmtk
$ python setup.py develop
$ cd..
  • Run tests
$ cd nilmtk
$ nosetests

About

Non-Intrusive Load Monitoring Toolkit (nilmtk)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.4%
  • Makefile 1.5%
  • Shell 1.5%
  • CSS 0.6%