Stats improvements #31 :

* Tidying up some doc strings
* collapsing 'kwh()' and 'joules()' into 'energy()'
* allow `usage_per_period()` to take an `energy_unit` parameter.