Package: nilm-analyzer
NILM_Analyzer: A Simple Python PackageA simple and convenient package to ease and fasten the process of loading and analyzing all the data of any publicly available NILM dataset. Provides basic transformations like resampling, standardization and extracting activations by thresholding for statistical analysis purpose. Can be used further for splitting datasets into train, validation and test subsets for Energy Disaggregation task.Getting StartedInstall the nilm_analyzer in your current environment.pip install nilm-analyzerDownloadany NILM dataset(s) and import the corresponding loader. Then, pass the data path of the data directory where the dataset is located. For instance,from nilm_datasets.loaders import REFIT_Loader
refit = REFIT_Loader(data_path='data/refit/')Fetch the list of available appliances for selected houses.refit.get_appliance_names(house=2)Load data for selected appliance (all houses)kettle = refit.get_appliance_data(appliance='Kettle')(OR) Load data for selected house (all appliances).house2 = refit.get_house_data(house=2)(OR) Load data for sselected appliance and elected houses.kettle = refit.get_appliance_data(appliance="Kettle", houses=[1,2,3])Take the reference from NILM_Analyzer to see how Refit_Loader can be accessed and how it's utilities can be used.Reference Repository:NILM Analyzer Tutorials= This repository serves more like a user guide that describes how to use the nilm analyzer package, and demonstrates all the basic functionalities that it provides.DependenciesEnsure that the following dependencies are satisfied in your current environment- python>=3.9.2
  - numpy>=1.20.3
  - pandas>=1.2.4
  - dask>=2021.06.2
  - scikit-learn>=1.1.2Datasets IncludedREFIT [United Kingdom]Murray, D., Stankovic, L. & Stankovic, V. An electrical load measurements dataset of United Kingdom households from a two-year longitudinal study. Sci Data 4, 160122 (2017).https://doi.org/10.1038/sdata.2016.122UK-DALE [United Kingdom]Kelly, J., Knottenbelt, W. The UK-DALE dataset, domestic appliance-level electricity demand and whole-house demand from five UK homes. Sci Data 2, 150007 (2015).https://doi.org/10.1038/sdata.2015.7GeLaP [Germany]Wilhelm, S., Jakob, D., Kasbauer, J., Ahrens, D. (2022). GeLaP: German Labeled Dataset for Power Consumption. In: Yang, XS., Sherratt, S., Dey, N., Joshi, A. (eds) Proceedings of Sixth International Congress on Information and Communication Technology. Lecture Notes in Networks and Systems, vol 235. Springer, Singapore.https://doi.org/10.1007/978-981-16-2377-6_5DEDDIAG [Germany]Wenninger, M., Maier, A. & Schmidt, J. DEDDIAG, a domestic electricity demand dataset of individual appliances in Germany. Sci Data 8, 176 (2021).https://doi.org/10.1038/s41597-021-00963-2AMPds [Canada]S. Makonin, F. Popowich, L. Bartram, B. Gill and I. V. Bajić, "AMPds: A public dataset for load disaggregation and eco-feedback research," 2013 IEEE Electrical Power & Energy Conference, Halifax, NS, Canada, 2013, pp. 1-6, doi: 10.1109/EPEC.2013.6802949.iAWE [India]N. Batra, A. Singh, P. Singh, H. Dutta, V. Sarangan, M. Srivastava "Data Driven Energy Efficiency in Buildings"DownloadsREFIT [United Kingdom]https://pureportal.strath.ac.uk/files/52873459/Processed_Data_CSV.7zUK-DALE [United Kingdom]http://data.ukedc.rl.ac.uk/simplebrowse/edc/efficiency/residential/EnergyConsumption/Domestic/UK-DALE-2017/UK-DALE-FULL-disaggregated/ukdale.zipAMPds [Canada]https://dataverse.harvard.edu/api/access/datafile/2741425?format=originalGeLaP [Germany]https://mygit.th-deg.de/tcg/gelap/-/tree/masterDEDDIAG [Germany]https://figshare.com/articles/dataset/DEDDIAG_a_domestic_electricity_demand_dataset_of_individual_appliances_in_Germany/13615073iAWE [India]https://drive.google.com/open?id=1c4Q9iusYbwXkCppXTsak5oZZYHfXPmnp