Get started with PyBaMM

Installation instructions#

PyBaMM is available on the pip and conda package managers for Windows, macOS, and Linux; and the the library (with its required dependencies) can be installed with

pip install pybamm

or

conda install -c conda-forge pybamm-base

More detailed instructions for installing PyBaMM on different platforms and for installing from source can be found in the installation instructions in the documentation.

Example notebooks#

If you would like to get started with PyBaMM, you may go through the Getting Started notebooks which introduce its basic features. You can launch the notebooks on Google Colab to run them on the cloud without having to install PyBaMM on your computer.

• Tutorial 1: How to run a model
• Tutorial 2: Compare models
• Tutorial 3: Basic plotting
• Tutorial 4: Setting parameter values
• Tutorial 5: Run experiments
• Tutorial 6: Managing simulation outputs
• Tutorial 7: Model options
• Tutorial 8: Solver options
• Tutorial 9: Changing the mesh

For more resources, please refer to the Examples section in the PyBaMM documentation.

Video tutorials#

We regularly hold PyBaMM workshops. You can find a list of the workshops we have held with links to the corresponding recordings on the Training page.

Get help#

You can get help by posting questions on the PyBaMM Slack channels or preferably in GitHub discussions. You can also get paid support from Ionworks.