examples/synd_exploration.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Exploring SynD with NILMTK\n",
    "\n",
    "In this tutorial, we will use NILMTK to load and explore SynD!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'contact': 'klemenjak@ieee.org',\n",
       " 'creators': ['Klemenjak, Christoph',\n",
       "  'Kovatsch, Christoph',\n",
       "  'Herold, Manuel',\n",
       "  'Elmenreich, Wilfried'],\n",
       " 'dataset_ID': 1,\n",
       " 'date_created': '2019-09-29',\n",
       " 'description': 'an energy consumption dataset created from synthetic power signals',\n",
       " 'duration': 180,\n",
       " 'geo_location': {'country': 'AT',\n",
       "  'latitude': 46.6247222,\n",
       "  'locality': 'Klagenfurt',\n",
       "  'longitude': 14.3052778},\n",
       " 'institution': 'University of Klagenfurt',\n",
       " 'long_name': 'SynD - A Synthetic Energy Consumption Dataset for Non-Intrusive Load Monitoring in Residential Buildings',\n",
       " 'name': 'SynD',\n",
       " 'number_of_buildings': 1,\n",
       " 'publication_date': 2019,\n",
       " 'related_documents': ['http://github.com/klemenjak/synd/'],\n",
       " 'sampling_interval': 0.2,\n",
       " 'schema': 'https://github.com/nilmtk/nilm_metadata/tree/v0.2',\n",
       " 'subject': 'SynD - A Synthetic Energy Dataset for Load Disaggregation Scholarship',\n",
       " 'timezone': 'Europe/Vienna',\n",
       " 'meter_devices': {'HMC8015': {'description': 'Power analyzer',\n",
       "   'manufacturer': 'R&S',\n",
       "   'manufacturer_url': 'https://www.rohde-schwarz.com/us/product/hmc8015-productstartpage_63493-150914.html',\n",
       "   'max_sample_period': 0.2,\n",
       "   'measurements': [{'lower_limit': 0,\n",
       "     'physical_quantity': 'power',\n",
       "     'type': 'active',\n",
       "     'upper_limit': 96000}],\n",
       "   'model': 'HMC8015 Power analyzer',\n",
       "   'sample_period': 0.2}}}"
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from nilmtk import DataSet\n",
    "\n",
    "SynD = DataSet('/Users/christoph/datasets/SynD-release/SynD.h5')\n",
    "\n",
    "SynD.metadata"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The *elec object* is a key element in NILMTK."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "MeterGroup(meters=\n",
       "  ElecMeter(instance=1, building=1, dataset='SynD', site_meter, appliances=[])\n",
       "  ElecMeter(instance=2, building=1, dataset='SynD', appliances=[Appliance(type='fridge', instance=1)])\n",
       "  ElecMeter(instance=3, building=1, dataset='SynD', appliances=[Appliance(type='dish washer', instance=1)])\n",
       "  ElecMeter(instance=4, building=1, dataset='SynD', appliances=[Appliance(type='electric space heater', instance=1)])\n",
       "  ElecMeter(instance=5, building=1, dataset='SynD', appliances=[Appliance(type='washing machine', instance=1)])\n",
       "  ElecMeter(instance=6, building=1, dataset='SynD', appliances=[Appliance(type='toaster', instance=1)])\n",
       "  ElecMeter(instance=7, building=1, dataset='SynD', appliances=[Appliance(type='fan', instance=1)])\n",
       "  ElecMeter(instance=8, building=1, dataset='SynD', appliances=[Appliance(type='microwave', instance=1)])\n",
       "  ElecMeter(instance=9, building=1, dataset='SynD', appliances=[Appliance(type='clothes iron', instance=1)])\n",
       "  ElecMeter(instance=10, building=1, dataset='SynD', appliances=[Appliance(type='fan', instance=2)])\n",
       "  ElecMeter(instance=11, building=1, dataset='SynD', appliances=[Appliance(type='broadband router', instance=1)])\n",
       "  ElecMeter(instance=12, building=1, dataset='SynD', appliances=[Appliance(type='coffee maker', instance=1)])\n",
       "  ElecMeter(instance=13, building=1, dataset='SynD', appliances=[Appliance(type='television', instance=1)])\n",
       "  ElecMeter(instance=14, building=1, dataset='SynD', appliances=[Appliance(type='printer', instance=1)])\n",
       "  ElecMeter(instance=15, building=1, dataset='SynD', appliances=[Appliance(type='laptop computer', instance=1)])\n",
       "  ElecMeter(instance=16, building=1, dataset='SynD', appliances=[Appliance(type='light', instance=1)])\n",
       "  ElecMeter(instance=17, building=1, dataset='SynD', appliances=[Appliance(type='computer', instance=1)])\n",
       "  ElecMeter(instance=18, building=1, dataset='SynD', appliances=[Appliance(type='unknown', instance=1)])\n",
       "  ElecMeter(instance=19, building=1, dataset='SynD', appliances=[Appliance(type='computer monitor', instance=1)])\n",
       "  ElecMeter(instance=20, building=1, dataset='SynD', appliances=[Appliance(type='electric oven', instance=1)])\n",
       "  ElecMeter(instance=21, building=1, dataset='SynD', appliances=[Appliance(type='hair dryer', instance=1)])\n",
       "  ElecMeter(instance=22, building=1, dataset='SynD', appliances=[Appliance(type='kettle', instance=1)])\n",
       ")"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "elec = SynD.buildings[1].elec\n",
    "elec"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can use the *elec* object to obtain basic information on SynD's household."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "SynD comes with a Sample Period of: 0.2\n",
      "Available physical quantities: ['power']\n",
      "Available AC types :['active']\n",
      "Number of days: 179 days 23:59:59.400000\n"
     ]
    }
   ],
   "source": [
    "print(\"SynD comes with a Sample Period of: \" + str( elec.sample_period() ))\n",
    "print(\"Available physical quantities: \" + str( elec.available_physical_quantities() ))\n",
    "print(\"Available AC types :\" + str(elec.available_ac_types('power')))\n",
    "print(\"Number of days: \"+ str(elec.uptime()))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The *wiring graph* reveals how the power grid inside the household looks like."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(<networkx.classes.digraph.DiGraph at 0x123d72940>,\n",
       " <matplotlib.axes._axes.Axes at 0x123d7b748>)"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "elec.draw_wiring_graph()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Since SynD is synthetic, we have knowledge about all components of the aggregate signal!\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Running MeterGroup.proportion_of_energy_submetered...\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "1.0"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "round(elec.proportion_of_energy_submetered(), 2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we explore how much consumption per appliance we have in SynD:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "21/21 ElecMeter(instance=22, building=1, dataset='SynD', appliances=[Appliance(type='kettle', instance=1)])1)]))]))]))])"
     ]
    },
    {
     "data": {
      "text/plain": [
       "(2, 1, SynD)     0.073865\n",
       "(3, 1, SynD)     0.115977\n",
       "(4, 1, SynD)     0.348956\n",
       "(5, 1, SynD)     0.104910\n",
       "(6, 1, SynD)     0.003695\n",
       "(7, 1, SynD)     0.008397\n",
       "(8, 1, SynD)     0.004937\n",
       "(9, 1, SynD)     0.183080\n",
       "(10, 1, SynD)    0.008172\n",
       "(11, 1, SynD)    0.015761\n",
       "(12, 1, SynD)    0.001748\n",
       "(13, 1, SynD)    0.055371\n",
       "(14, 1, SynD)    0.000339\n",
       "(15, 1, SynD)    0.002415\n",
       "(16, 1, SynD)    0.000274\n",
       "(17, 1, SynD)    0.013942\n",
       "(18, 1, SynD)    0.000114\n",
       "(19, 1, SynD)    0.002901\n",
       "(20, 1, SynD)    0.013366\n",
       "(21, 1, SynD)    0.022287\n",
       "(22, 1, SynD)    0.019496\n",
       "dtype: float64"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "elec.submeters().fraction_per_meter()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This tutorial should give you basic code fragments to start working with NILMTK. May the elec object be with you!\n",
    "\n",
    "best, \n\n",
    "Christoph\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python (nilmtk)",
   "language": "python",
   "name": "nilmtk-env"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}