diff --git a/docs/source/user_guide/fundamentals/battery_models.md b/docs/source/user_guide/fundamentals/battery_models.md new file mode 100644 index 0000000000..b2faff98dd --- /dev/null +++ b/docs/source/user_guide/fundamentals/battery_models.md @@ -0,0 +1,29 @@ +# Battery Models + +References for the battery models used in PyBaMM simulations can be found calling +```python +pybamm.print_citations() +``` +However, a few papers are provided in this section for anyone interested in reading the theory +behind the models before doing the tutorials. + +## Review Articles + +[Review of physics-based lithium-ion battery models](https://doi.org/10.1088/2516-1083/ac7d31) + +[Review of parameterisation and a novel database for Li-ion battery models](https://doi.org/10.1088/2516-1083/ac692c) + +## Model References + +### Lithium-Ion Batteries + +[Doyle-Fuller-Newman model](https://doi.org/10.1149/1.2221597) + +[Single particle model](https://doi.org/10.1149/2.0341915jes) + + +### Lead-Acid Batteries + +[Isothermal porous-electrode model](https://doi.org/10.1149/2.0301910jes) + +[Leading-Order Quasi-Static model](https://doi.org/10.1149/2.0441908jes) diff --git a/docs/source/user_guide/fundamentals/index.md b/docs/source/user_guide/fundamentals/index.md index 632b4c0cb4..fafc6d9956 100644 --- a/docs/source/user_guide/fundamentals/index.md +++ b/docs/source/user_guide/fundamentals/index.md @@ -70,7 +70,7 @@ solution = sim.solve() solution.plot() ``` -Finally, PyBaMM provides cusotm visualization tools: +Finally, PyBaMM provides custom visualization tools: - [](quick_plot): for easily plotting simulation outputs in a grid, including comparing multiple simulations - [](pybamm.plot_voltage_components): for plotting the component overpotentials that make up a voltage curve diff --git a/docs/source/user_guide/index.md b/docs/source/user_guide/index.md index f7bc57a414..e288a67e28 100644 --- a/docs/source/user_guide/index.md +++ b/docs/source/user_guide/index.md @@ -21,6 +21,7 @@ caption: Fundamentals and usage maxdepth: 2 --- fundamentals/index +fundamentals/battery_models ``` # Example notebooks