EEmeter: tools for calculating metered energy savings ===================================================== .. image:: https://travis-ci.org/openeemeter/eemeter.svg?branch=master :target: https://travis-ci.org/openeemeter/eemeter :alt: Build Status .. image:: https://img.shields.io/github/license/openeemeter/eemeter.svg :target: https://github.com/openeemeter/eemeter :alt: License .. image:: https://readthedocs.org/projects/eemeter/badge/?version=master :target: https://eemeter.readthedocs.io/?badge=master :alt: Documentation Status .. image:: https://img.shields.io/pypi/v/eemeter.svg :target: https://pypi.python.org/pypi/eemeter :alt: PyPI Version .. image:: https://codecov.io/gh/openeemeter/eemeter/branch/master/graph/badge.svg :target: https://codecov.io/gh/openeemeter/eemeter :alt: Code Coverage Status .. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/ambv/black :alt: Code Style --------------- **EEmeter** — an open source toolkit for implementing and developing standard methods for calculating normalized metered energy consumption (NMEC) and avoided energy use. Background - why use the EEMeter library ---------------------------------------- At time of writing (Sept 2018), the OpenEEmeter, as implemented in the eemeter package and sister :any:`eeweather ` package, contains the most complete open source implementation of the `CalTRACK Methods`_, which specify a family of ways to calculate and aggregate estimates avoided energy use at a single meter particularly suitable for use in pay-for-performance (P4P) programs. The eemeter package contains a toolkit written in the python langage which may help in implementing a CalTRACK compliant analysis (see :ref:`caltrack-compliance`). It contains a modular set of of functions, parameters, and classes which can be configured to run the CalTRACK methods and close variants. .. _CalTRACK Methods: http://caltrack.org/ .. note:: Please keep in mind that use of the OpenEEmeter is neither necessary nor sufficient for compliance with the CalTRACK method specification. For example, while the CalTRACK methods set specific hard limits for the purpose of standardization and consistency, the EEmeter library can be configured to edit or entirely ignore those limits. This is becuase the eemeter package is used not only for compliance with, but also for *development of* the CalTRACK methods. Please also keep in mind that the EEmeter assumes that certain data cleaning tasks specified in the CalTRACK methods have occurred prior to usage with the eemeter. The package proactively exposes warnings to point out issues of this nature where possible. .. _installation: Installation ------------ EEmeter is a python package and can be installed with pip. :: $ pip install eemeter .. note:: If you are having trouble installing, see :ref:`anaconda`. Features -------- - Candidate model selection - Data sufficiency checking - Reference implementation of standard methods - CalTRACK Daily Method - CalTRACK Monthly Billing Method - CalTRACK Hourly Method - Flexible sources of temperature data. See :any:`EEweather `. - Model serialization - First-class warnings reporting - Pandas DataFrame support - Visualization tools Roadmap for 2020 development ---------------------------- The OpenEEmeter project growth goals for the year fall into two categories: 1. Community goals - we want help our community thrive and continue to grow. 2. Technical goals - we want to keep building the library in new ways that make it as easy as possible to use. Community goals ~~~~~~~~~~~~~~~ 1. Develop project documentation and tutorials A number of users have expressed how hard it is to get started when tutorials are out of date. We will dedicate time and energy this year to help create high quality tutorials that build upon the API documentation and existing tutorials. 2. Make it easier to contribute As our user base grows, the need and desire for users to contribute back to the library also grows, and we want to make this as seamless as possible. This means writing and maintaining contribution guides, and creating checklists to guide users through the process. Technical goals ~~~~~~~~~~~~~~~ 1. Implement new CalTRACK recommendations The CalTRACK process continues to improve the underlying methods used in the OpenEEmeter. Our primary technical goal is to keep up with these changes and continue to be a resource for testing and experimentation during the CalTRACK methods setting process. 2. Hourly model visualizations The hourly methods implemented in the OpenEEMeter library are not yet packaged with high quality visualizations like the daily and billing methods are. As we build and package new visualizations with the library, more users will be able to understand, deploy, and contribute to the hourly methods. 3. Weather normal and unusual scenarios The EEweather package, which supports the OpenEEmeter, comes packaged with publicly available weather normal scenarios, but one feature that could help make that easier would be to package methods for creating custom weather year scenarios. 4. Greater weather coverage The weather station coverage in the EEweather package includes full coverage of US and Australia, but with some technical work, it could be expanded to include greater, or even worldwide coverage. Usage Guides ------------ .. toctree:: :maxdepth: 2 basics advanced tutorial caltrack_compliance api