meterplot

Display water/electricity consumption data


Keywords
electricity, power, pypi, python, visualization
License
MIT
Install
pip install meterplot==0.3.0

Documentation

meterplot

gh-actions codecov Code style: black PyPi Version PyPI pyversions GitHub stars PyPi downloads

This little script takes a number of energy measurements (e.g., from your electricity meter or old power bills) and displays the consumption over time. Works for electricity and water readings.

For example, with the data file

# electricity data
---
unit: kWh
data:
  - date: 2016-01-01T00:00:00+00:00
    value: 1000
  - date: 2016-02-01T00:00:00+00:00
    value: 1200
  - date: 2016-04-01T00:00:00+00:00
    value: 2000
  - date: 2016-07-01T00:00:00+00:00
    value: 3500
  - date: 2016-10-01T00:00:00+00:00
    value: 4000

you'll get

meterplot electricity.yml

Input of water data is equally easy (here for warm and cold water, with a meter change)

# Water data
---
unit: m^3

- data:
    - date: 2013-01-01T00:00:00+00:00
      value: [0.0, 0.0]
    - date: 2013-07-01T00:00:00+00:00
      value: [16.6, 4.0]
    - date: 2014-01-01T00:00:00+00:00
      value: [30.0, 23.0]
    - date: 2014-01-01T00:00:00+00:00
      value: [0.0, 35.1]
    - date: 2014-07-01T00:00:00+00:00
      value: 15.2
    - date: 2015-01-01T00:00:00+00:00
      value: 25.1
meterplot water.yml

Installation

meterplot is available from the Python Package Index, so with

pip install -U meterplot

you can install/upgrade.

Distribution

To create a new release

  1. bump the __version__ number,

  2. publish to PyPi and GitHub:

    $ make publish
    

License

meterplot is published under the MIT license.