OpenDSM (formerly OpenEEmeter) — an open-source library used to measure the impacts of demand-side programs by using historical data to fit models and then create predictions (counterfactuals) to compare to post-intervention, observed energy usage.
Energy efficiency programs have traditionally focused on addressing long-term load growth and reducing customer energy bills rather than serving as reliable grid resources. However, as utilities work to decarbonize power generation, buildings, and transportation, demand-side programs (e.g. energy efficiency, load shifting, electrification, and demand response programs) must evolve into dependable, scalable grid assets. Ultimately, decarbonizing the power grid will require both supply and demand-side solutions. While supply-side production is easily quantified, measuring the impacts of demand-side programs has historically been challenging due to inconsistent and opaque measurement methodologies.
OpenDSM solves these problems with accurate, efficient, and transparent models designed to measure demand-side program impacts. OpenDSM gives all stakeholders full visibility and confidence in the results.
OpenDSM builds upon the shoulders of OpenEEmeter and the CalTRACK Methods which themselves are built upon the foundational work of the Princeton Scorekeeping Method (PRISM 1986) for the daily and billing models and Lawrence Berkeley National Laboratory's Time-of-Week and Temperature Model (TOWT 2011) for the hourly energy efficiency and demand response models. OpenDSM models have been proven to meet or exceed the predictive capablity of the aforementioned models. These models adhere to a statistical approach, as opposed to an engineering approach, so that these models can be efficiently run on millions of meters at a time, while still providing accurate predictions.
Using default settings in OpenDSM will provide accurate and stable model predictions suitable for savings measurements from demand side interventions. Settings can be modified and sufficiency requirements can be bypassed for research and development purposes; however, the outputs of such models are no longer OpenDSM compliant measurements as the modifications mean that these models are no longer verified and approved by the OpenDSM Working Group.
OpenDSM is a python package and can be installed with pip.
$ pip install opendsm
-
Models:
- Energy Efficiency Daily Model
- Energy Efficiency Billing (Monthly) Model
- Energy Efficiency Non-Solar Hourly Model
- Energy Efficiency Solar Hourly Model
- Demand Response Hourly Model
-
Flexible sources of temperature data. See EEweather.
-
Data sufficiency checking
-
Model serialization
-
First-class warnings reporting
Documenation for this library can be found here. Additionally, within the repository, the scripts directory contains Jupyter Notebooks, which function as interactive examples.
The OpenDSM project growth goals fall into two categories:
- Community goals - we want help our community thrive and continue to grow.
- Technical goals - we want to keep building the library in new ways that make it as easy as possible to use.
- Improve repository structure, architecture, and API
The first step of being able to contribute to a project is to understand how the repository is laid out and how OpenDSM is architected. We have made giant steps in this area as of late, but there is additional organizational work to be done. This will continue to be an ongoing area of work.
- Improve 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 continue to dedicate time and energy to help create high quality tutorials that build upon the API documentation and existing tutorials. We hope that the community will contribute to this effort.
- 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.
- Revert the billing model logic back to its previously approved state
When OpenEEmeter 4.0 was released, an unintentional change was made to the billing model. The billing model currently inherits from the daily model so a change to the daily model currently necessitates a change in the billing model. The previously approved method was to put the billing usage directly into the daily model weighted by the number of days in the billing period. During the daily model improvement efforts, the billing model was mistakenly modified such that it averages usage across the billing period these averaged days are input directly into the daily model as daily data. A working group is being assembled to address this.
- Update the Demand Response (DR) model
In the most recent release, the hourly energy efficiency (EE) model has been entirely changed and updated. Much like the billing model is to the daily model, the DR model is a subset of the EE hourly model. Many of the improvements seen in the EE hourly model could be realized in the DR model if it were finalized. It is currently in a functional state within a branch, but its parameters have not been optimized rendering it unusable for measurements. In the meantime, the existing DR model is still available.
- Develop and approve adaptive weighting for the hourly model
At present, the hourly model does not down weight or remove any outliers during the fitting process. While this is still acceptable for measurement purposes, given that the model still meets all sufficiency requirements; it could be improved. There currently exists functionality within the settings to turn on adaptive daily weighting that would serve to down weight days which are significant outliers when fitting the hourly model, but it has not yet been tested at a population level.
- Reassess existing sufficiency and disqualification criteria
The existing sufficiency and disqualification criteria exist as conservative estimates from OpenEEmeter and CalTRACK recommendations. There is almost certainly room for these criteria to be revisited so that more meters would pass and be approved for measurement.
- Determine the sufficiency requirements of PV installation date in the hourly model
The hourly EE model currently has the capability of ingesting a PV installation date and generating an additional feature that can much better represent a meter who installs a solar PV system mid-baseline year. However, this feature currently is classified as experimental and not allowed for official measurement because we have not quantified how much data is required post-installation to be able to accurately predict the meter's behavior in the reporting year.
- Improve the daily model
There are two potential areas of improvement of the daily model. First it could be extended to allow additional sources of information, but this must carefully be considered as the primary usage of the daily model is to be able to disaggregate heating and cooling usage. The second area of improvement would be to allow an additional break point within both the cooling and heating regions such that the model would be able to change slope. This should likely still be limited such that the model's slope in each region is appropriately constrained. A new smoothing function would also need to be developed.
- Integrate EEweather
EEweather is commonly used to obtain weather information to be used within OpenDSM. If it were more tightly coupled, it would streamline the most standard use of OpenDSM. As an example this could simplify several of the data classes such that the aggregation of weather data would be done within EEweather instead of within data classes where it is a more complex procedure
- Integrate GRIDmeter
GRIDmeter is frequently used after DR/EEmeter in order to correct models for external population-level effects by using non-participant meters. Similarly to EEweather, this process could be streamlines and made more cohesive by fully integrating it into OpenDSM.
- Organize and revise existing test suite
The existing testing suite is the last remaining vestige of the library prior to the extensive reorganization and API changes made. It would be well served to update the testing suite to make it easier for future contributors to know how and where they should develop their tests for any new features or bugs found.
- 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.
This project is licensed under Apache 2.0.
- CONTRIBUTING: How to contribute to the project.
- MAINTAINERS: An ordered list of project maintainers.
- CHARTER: Open source project charter.
- CODE OF CONDUCT: Code of conduct for contributors.