Skip to main content

Python Battery Optimisation and Parameterisation

Project description

logo.svg

Python Battery Optimisation and Parameterisation

Scheduled Contributors Last Commit Python Versions from PEP 621 TOML Forks Stars Codecov Open Issues License Open in Colab nbviewer Static Badge Releases

PyBOP provides a complete set of tools for parameterisation and optimisation of battery models, using both Bayesian and frequentist approaches, with example workflows to assist the user. PyBOP can be used to parameterise various battery models, including electrochemical and equivalent circuit models available in PyBaMM. PyBOP prioritises clear and informative diagnostics for the user, while also allowing for advanced probabilistic methods.

The diagram below shows the conceptual framework of PyBOP. This package is currently under development, so users can expect the API to evolve with future releases.

pybop_arch.svg

Installation

Within your virtual environment, install PyBOP:

pip install pybop

To install the most recent state of PyBOP, install from the develop branch,

pip install git+https://github.com/pybop-team/PyBOP.git@develop

To install a previous version of PyBOP, use the following template and replace the version number:

pip install pybop==v24.3

To check that PyBOP is installed correctly, run one of the examples in the following section. For a development installation, see the Contribution Guide. More installation information is available in our documentation and the extended installation instructions for PyBaMM.

Using PyBOP

PyBOP has two intended uses:

  1. Parameter inference from battery test data.

  2. Design optimisation under battery manufacturing/use constraints.

These include a wide variety of optimisation problems that require careful consideration due to the choice of battery model, data availability and/or the choice of design parameters.

Jupyter Notebooks

Explore our example notebooks for hands-on demonstrations:

Python Scripts

Find additional script-based examples in the examples directory:

Supported Methods

The table below lists the currently supported models, optimisers, and cost functions in PyBOP.

Battery Models Optimization Algorithms Cost Functions
Single Particle Model (SPM) Covariance Matrix Adaptation Evolution Strategy (CMA-ES) Sum of Squared Errors (SSE)
Single Particle Model with Electrolyte (SPMe) Particle Swarm Optimization (PSO) Root Mean Squared Error (RMSE)
Doyle-Fuller-Newman (DFN) Exponential Natural Evolution Strategy (xNES) Minkowski
Many Particle Model (MPM) Separable Natural Evolution Strategy (sNES) Sum of Power
Multi-Species Multi-Reactants (MSMR) Adaptive Moment Estimation with Weight Decay (AdamW) Gaussian Log Likelihood
Weppner-Huggins Improved Resilient Backpropagation (iRProp-) Log Posterior
Equivalent Circuit Models (ECM) SciPy Minimize & Differential Evolution Unscented Kalman Filter (UKF)
Cuckoo Search Gravimetric Energy Density
Gradient Descent Volumetric Energy Density
Nelder-Mead

Code of Conduct

PyBOP aims to foster a broad consortium of developers and users, building on and learning from the success of the PyBaMM community. Our values are:

  • Inclusivity and fairness (those who wish to contribute may do so, and their input is appropriately recognised)

  • Interoperability (modularity for maximum impact and inclusivity)

  • User-friendliness (putting user requirements first via user-assistance & workflows)

License

PyBOP is released under the BSD 3-Clause License.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Brady Planden
Brady Planden

🚇 ⚠️ 💻 💡 👀
NicolaCourtier
NicolaCourtier

💻 👀 💡 ⚠️
David Howey
David Howey

🤔 🧑‍🏫
Martin Robinson
Martin Robinson

🤔 🧑‍🏫 👀 💻 ⚠️
Ferran Brosa Planella
Ferran Brosa Planella

👀 💻 💡
Agriya Khetarpal
Agriya Khetarpal

💻 🚇 👀
Faraday Institution
Faraday Institution

💵
UK Research and Innovation
UK Research and Innovation

💵
Horizon Europe IntelLiGent Consortium
Horizon Europe IntelLiGent Consortium

💵
Muhammed Nedim Sogut
Muhammed Nedim Sogut

💻
MarkBlyth
MarkBlyth

💻
f-g-r-i-m-m
f-g-r-i-m-m

💡
Dibyendu-IITKGP
Dibyendu-IITKGP

💡

This project follows the all-contributors specifications. Contributions of any kind are welcome! See CONTRIBUTING.md for ways to get started.

Project details


Download files

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

Source Distribution

pybop-24.9.1.tar.gz (91.5 kB view details)

Uploaded Source

Built Distribution

pybop-24.9.1-py3-none-any.whl (111.8 kB view details)

Uploaded Python 3

File details

Details for the file pybop-24.9.1.tar.gz.

File metadata

  • Download URL: pybop-24.9.1.tar.gz
  • Upload date:
  • Size: 91.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for pybop-24.9.1.tar.gz
Algorithm Hash digest
SHA256 7e1d6c78f8c4cf51187c67e53f611f47792a6ea431a1a9489b32064172e29e15
MD5 84ed087ec32173daea8f57638586b862
BLAKE2b-256 cc628bb8d1aeca6b7865fa3ab8c76dc9f6b99992bb5606d91dd0b15e02e7d7f3

See more details on using hashes here.

File details

Details for the file pybop-24.9.1-py3-none-any.whl.

File metadata

  • Download URL: pybop-24.9.1-py3-none-any.whl
  • Upload date:
  • Size: 111.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for pybop-24.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 374170f189d4c1cec2123f0b746eb30282875208ba00857d9b53dbe0e0304dbb
MD5 6118946a000c82e8395cf5e4bc8dda65
BLAKE2b-256 eedcab6620267718c8ce0fb3c2825610ad50a3b0e833699ab156fcc3638621d9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page