Skip to content
Show your energy consumption
Python Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
meterplot
test
.flake8
.gitignore
.travis.yml
LICENSE
Makefile
README.md
codecov.yml
setup.py

README.md

meterplot

CircleCI codecov Code style: black PyPi Version GitHub stars

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
groups:
  - style:
      color: '#2ca02c'
    meters:
      - 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

groups:
  # warm
  - style:
      color: '#d62728'
    meters:
      - data:
          - date: 2013-01-01T00:00:00+00:00
            value: 0.0
          - date: 2013-07-01T00:00:00+00:00
            value: 16.6
          - date: 2014-01-01T00:00:00+00:00
            value: 30.0
      - data:
          - date: 2014-01-01T00:00:00+00:00
            value: 0.0
          - date: 2014-07-01T00:00:00+00:00
            value: 15.2
          - date: 2015-01-01T00:00:00+00:00
            value: 25.1

  # cold
  - style:
      color: '#1f77b4'
    meters:
      - data:
          - date: 2013-01-01T00:00:00+00:00
            value: 0.0
          - date: 2013-04-01T00:00:00+00:00
            value: 4.0
          - date: 2014-07-01T00:00:00+00:00
            value: 23.0
          - date: 2015-01-01T00:00:00+00:00
            value: 35.1
meterplot electricity.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.

You can’t perform that action at this time.