Home

Welcome to the c-vis wiki!

What is Joule?

Joule is a web app that fetches, combines / separates and processes the captured energy data, and then displays the data to the user, within a web browser. It carries out all data processing in-browser which negates the need for specific server software to be installed, and only relies on a standard web server able to serve up the static files needed for the app, and the data JSON files. It is just an example of what can be done with energy data and should hopefully open the way to other visualisation tools.

The JSON files

Data files

#sensorindex.json provides an index describing all sensors.

{
  "sensors" : {
    "elec" : [
        {
          "function" : "Power",
          "path" : "meters.cl.cam.ac.uk/elec",
          "sensor" : "S-m36",
          "room" : "GN17",
          "readings" : [
            "S-m257-2011-03.json",
            ...
          ]
        },
        ...
    ]
  }
}

elec[array] : contains the objects representing electricity meters

function[string] : description of the function performed by the branch monitored by the meter

path[string] : absolute path of the folder containing the data files

sensor[string] : sensor name

room[string] : room name

readings[array] : contains the file names of the data files

#S-m##-YYYY-MM.json is a typical data file name, containing the meter readings at 1 hour intervals. ## is the meter number, YYYY is the year and MM is the month the readings refer to.

{
  "label" : "257 2011-07-06",
  "room" : "GN17",
  "path" : "meters.cl.cam.ac.uk/elec",
  "phase" : "3",
  "description" : "Power",
  "coverage" : "Gates building",
  "type" : "Auto Meter IC1995",
  "ts" : "2013-09",
  "data" : {
    "start" : 1377993600000,
    "step" : 3600000,
    "readings" : [
      148.366,
      149.25,
      ...
    ]
  }
}

#S-m##-YYYY-MM-DD.json same as above but meter readings are at 2 minutes intervals. DD is the day of the month the readings refer to.

Visualisation configuration files

config.json is the configuration file that instructs Joule on the location of the data files and sets some visualisation variables.

'trees.json'