Solar and Storage
A Python Library to run solar and storage optimization. This uses mixed integer linear programming and maximises revenue made by charging and discharging the battery. The model uses variable prices and a solar generation profile.
Installation
pip install solar-and-storage
Development
This repository uses uv for local development and CI (pyproject.toml + uv.lock).
uv sync
uv run pytest src/tests
uv run ruff check .
Example
Import the packages
import numpy as np
from solar_and_storage import SolarAndStorage
Make the fake price and solar data
# make prices
prices = np.zeros(24) + 30
prices[6:19] = 40
prices[9] = 50
prices[12:14] = 30
prices[16:18] = 50
prices[17] = 60
# make solar profile
solar = np.zeros(24)
solar[8:16] = 2.0
solar[10:14] = 4.0
Then run optimization
solar_and_storage = SolarAndStorage(prices=prices, solar_generation=list(solar))
solar_and_storage.run_optimization()
result_df = solar_and_storage.get_results()
Now plot the data
fig = solar_and_storage.get_figure()
fig.show(rendered="browser")
The first plot shows the solar profile, the second shows the prices that day. The third shows the battery profile. Finally the fourth shows profit. You can see that the battery charged from the solar site at the end of the solar maximum
Starting with stored energy
Use current_soc to set the starting battery state of charge as a fraction of
the battery capacity. For example, a half-full battery can discharge during an
initial high-price period:
prices = np.zeros(24)
prices[0] = 100
solar = np.zeros(24)
solar_and_storage = SolarAndStorage(
prices=prices,
solar_generation=list(solar),
current_soc=0.5,
battery_eta_charge=1,
battery_eta_discharge=1,
)
result_df = solar_and_storage.get_results()
Thanks
Thanks you to the follow repos for inspiration
- https://github.com/ADGEfficiency/energy-py-linear
- https://github.com/wzyfrank/battery/
- https://github.com/greysonchung/Battery-Optimisation/
- https://github.com/edu230991/battery-optimization/ sdk-python-ci.yml
Contributors ✨
Thanks goes to these wonderful people (emoji key):
Peter Dudfield 💻 |
gilbertgong 💻 |
davidhuanggg 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Metadata
Release files for solar-and-storage 0.0.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| solar_and_storage-0.0.17.tar.gz | 8.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| solar_and_storage-0.0.17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.1 kB
Release files / solar_and_storage-0.0.17.tar.gz
| Download URL | solar_and_storage-0.0.17.tar.gz |
|---|---|
| Size | 8.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
118cd72d588c5678162009a2528eada5a41d326631a684dea334af0186123c5f
|
|
BLAKE2b-256 checksum How to use checksums |
bb3dfcedb36fc89ad9ce3b0d450c1880db3d941686812c3ba2ee0220d13fe9ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / solar_and_storage-0.0.17-py3-none-any.whl
| Download URL | solar_and_storage-0.0.17-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb5706d14c42e09541361655e041be0a77c8efdd266fbc3581f61cf2c9753c91
|
|
BLAKE2b-256 checksum How to use checksums |
6047aa960222024e60b8a0ce121cdec63e83ccb7185a9d65eb136fdf00c75fb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|