Skip to main content

display energy consumption data

Project description

meterplot

CircleCI 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
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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for meterplot, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size meterplot-0.2.0-py3-none-any.whl (6.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size meterplot-0.2.0.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page