Welcome to Demand Response Events Simulator
===========================================
|Build Status| |Documentation| |Coverage|
Incentive Based DR Program: Overview
-------------------------------------
Incentive based Demand Response programs are voluntary programs offered to residential,
commercial, and industrial customer. The participants are offered financial incentives
if they voluntarily reduce loads during stressful times for the grid, which are notified
as DR events. There are different flavors of these DR programs across the country,
with different rules that constitute when the events are called, how often they are
called, the duration of these calls and much more. The DR Simulator tool uses various
program and simulation parameters to model these incentive-based demand response
programs across the country. This enables the user to configure any DR programs from
any ISOs and simulate DR events once they provide the simulation parameters based on
historical distribution or based on a custom distribution.
--------------
Features
--------
- Use custom or historic distribution
- Simulate Monte-Carlo samples
- Customize and configure DR events using marimo app
Installation
------------
**Stable Release:** ``pip install dr-simulator``
**Development Head:**
``pip install git+https://github.com/we3lab/dr-simulator.git``
Documentation
-------------
For full package documentation please visit
`we3lab.github.io/dr-simulator <https://we3lab.github.io/dr-simulator>`__.
Development
-----------
See `CONTRIBUTING.rst <https://we3lab.github.io/dr-simulator/CONTRIBUTING.html#>`__ for information related to
developing the code.
The Commands You Need To Know
----------------------------------
1. ``pip install -e .[dev]``
This will install your package in editable mode with all the required
development dependencies (i.e. ``tox``).
Visualizing the DR Simulator using marimo notebook
--------------------------------------------------
You can visualize the DR Simulator using `marimo <https://github.com/marimo-team/marimo>`_ notebook.
1. Install marimo using ``pip install marimo``
2. From the terminal, run ``marimo run dr_events_simulator.py``. This will open a new tab in your browser with the marimo notebook in app mode.
3. You can also run ``marimo edit dr_events_simulator.py`` to open the notebook in edit mode.
Upcoming release features
-------------------------
Watch out for the upcoming release features:
- Optimization framework for the simulated DR events using ``cvxpy`` library and finding the optimal capacity bid
- Include program parametes data for other ISO's DR programs
- Case study of using DR simulator for finding the optimal capacity bid of SVCW water resource recovery facility in participating in the PG&E's Capacity Bidding Program
.. |Build Status| image:: https://github.com/we3lab/dr_simulator/workflows/Build%20Main/badge.svg
:target: https://github.com/we3lab/dr-simulator/actions
.. |Documentation| image:: https://github.com/we3lab/dr_simulator/workflows/Documentation/badge.svg
:target: https://we3lab.github.io/dr-simulator/
.. |Coverage| image:: https://codecov.io/gh/we3lab/dr-simulator/graph/badge.svg?token=HXGOYK8JCD
:target: https://codecov.io/gh/we3lab/dr-simulator
Raw data
{
"_id": null,
"home_page": "https://github.com/we3lab/dr-simulator",
"name": "dr-simulator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<3.11",
"maintainer_email": "",
"keywords": "demand-response,simulator,energy,forecasting,optimization",
"author": "ThyanRevolter",
"author_email": "admkr.2010@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3b/f6/452225c64a669bfaa2b5a9bd87f4301951190eee01ef6b868d59a210680d/dr_simulator-0.3.1.tar.gz",
"platform": null,
"description": "Welcome to Demand Response Events Simulator\n===========================================\n\n|Build Status| |Documentation| |Coverage|\n\nIncentive Based DR Program: Overview\n-------------------------------------\n\nIncentive based Demand Response programs are voluntary programs offered to residential, \ncommercial, and industrial customer. The participants are offered financial incentives \nif they voluntarily reduce loads during stressful times for the grid, which are notified \nas DR events. There are different flavors of these DR programs across the country, \nwith different rules that constitute when the events are called, how often they are \ncalled, the duration of these calls and much more. The DR Simulator tool uses various \nprogram and simulation parameters to model these incentive-based demand response \nprograms across the country. This enables the user to configure any DR programs from \nany ISOs and simulate DR events once they provide the simulation parameters based on \nhistorical distribution or based on a custom distribution.\n\n--------------\n\nFeatures\n--------\n\n- Use custom or historic distribution\n- Simulate Monte-Carlo samples\n- Customize and configure DR events using marimo app\n\n\nInstallation\n------------\n\n**Stable Release:** ``pip install dr-simulator`` \n\n**Development Head:**\n``pip install git+https://github.com/we3lab/dr-simulator.git``\n\nDocumentation\n-------------\n\nFor full package documentation please visit\n`we3lab.github.io/dr-simulator <https://we3lab.github.io/dr-simulator>`__.\n\nDevelopment\n-----------\n\nSee `CONTRIBUTING.rst <https://we3lab.github.io/dr-simulator/CONTRIBUTING.html#>`__ for information related to\ndeveloping the code.\n\nThe Commands You Need To Know\n----------------------------------\n\n1. ``pip install -e .[dev]``\n\n This will install your package in editable mode with all the required\n development dependencies (i.e.\u00a0``tox``).\n\n\nVisualizing the DR Simulator using marimo notebook\n--------------------------------------------------\n\nYou can visualize the DR Simulator using `marimo <https://github.com/marimo-team/marimo>`_ notebook. \n\n1. Install marimo using ``pip install marimo``\n\n2. From the terminal, run ``marimo run dr_events_simulator.py``. This will open a new tab in your browser with the marimo notebook in app mode.\n\n3. You can also run ``marimo edit dr_events_simulator.py`` to open the notebook in edit mode.\n\nUpcoming release features\n-------------------------\n\nWatch out for the upcoming release features:\n\n- Optimization framework for the simulated DR events using ``cvxpy`` library and finding the optimal capacity bid\n- Include program parametes data for other ISO's DR programs\n- Case study of using DR simulator for finding the optimal capacity bid of SVCW water resource recovery facility in participating in the PG&E's Capacity Bidding Program\n\n.. |Build Status| image:: https://github.com/we3lab/dr_simulator/workflows/Build%20Main/badge.svg\n :target: https://github.com/we3lab/dr-simulator/actions\n.. |Documentation| image:: https://github.com/we3lab/dr_simulator/workflows/Documentation/badge.svg\n :target: https://we3lab.github.io/dr-simulator/\n.. |Coverage| image:: https://codecov.io/gh/we3lab/dr-simulator/graph/badge.svg?token=HXGOYK8JCD\n :target: https://codecov.io/gh/we3lab/dr-simulator\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Demand Response Simulator enables you to sample DR events based on a distribution and optimize your energy flexible process",
"version": "0.3.1",
"project_urls": {
"Documentation": "https://we3lab.github.io/dr-simulator/index.html",
"Homepage": "https://github.com/we3lab/dr-simulator",
"Repository": "https://github.com/we3lab/dr-simulator"
},
"split_keywords": [
"demand-response",
"simulator",
"energy",
"forecasting",
"optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8503b69af0c94478089648b7327b830343287bc1bbbaf57d0d565ce3ec1fbd8e",
"md5": "d2860991f25cefa8014e4891ff42fe77",
"sha256": "2b11366cef379a0a42c5c82f996923c845e6e733dbde72e651af1404eb43d6d7"
},
"downloads": -1,
"filename": "dr_simulator-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d2860991f25cefa8014e4891ff42fe77",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<3.11",
"size": 9695,
"upload_time": "2024-03-14T21:57:09",
"upload_time_iso_8601": "2024-03-14T21:57:09.390260Z",
"url": "https://files.pythonhosted.org/packages/85/03/b69af0c94478089648b7327b830343287bc1bbbaf57d0d565ce3ec1fbd8e/dr_simulator-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3bf6452225c64a669bfaa2b5a9bd87f4301951190eee01ef6b868d59a210680d",
"md5": "b0e7a34f230dda2bfe05f3049a655827",
"sha256": "395eaea7bc8022d375378a8195a291cc74e32bf425c0190fe8e764508f4e8cbc"
},
"downloads": -1,
"filename": "dr_simulator-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "b0e7a34f230dda2bfe05f3049a655827",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<3.11",
"size": 9671,
"upload_time": "2024-03-14T21:57:11",
"upload_time_iso_8601": "2024-03-14T21:57:11.065889Z",
"url": "https://files.pythonhosted.org/packages/3b/f6/452225c64a669bfaa2b5a9bd87f4301951190eee01ef6b868d59a210680d/dr_simulator-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-14 21:57:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "we3lab",
"github_project": "dr-simulator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "dr-simulator"
}
JSON
