bpx is added as an optional dependency

CHANGELOG.md

@@ -40,6 +40,7 @@
 
 ## Breaking Changes
 
+- [#499](https://github.com/pybop-team/PyBOP/pull/499) - BPX is added as an optional dependency.
 - [#483](https://github.com/pybop-team/PyBOP/pull/483) - Replaces `pybop.MAP` with `pybop.LogPosterior` with an updated call args and bugfixes.
 - [#436](https://github.com/pybop-team/PyBOP/pull/436) - **API Change:** The functionality from `BaseCost.evaluate/S1` & `BaseCost._evaluate/S1` is represented in `BaseCost.__call__` & `BaseCost.compute`. `BaseCost.compute` directly acts on the predictions, while `BaseCost.__call__` calls `BaseProblem.evaluate/S1` before `BaseCost.compute`. `compute` has optional args for gradient cost calculations.
 - [#424](https://github.com/pybop-team/PyBOP/issues/424) - Replaces the `init_soc` input to `FittingProblem` with the option to pass an initial OCV value, updates `BaseModel` and fixes `multi_model_identification.ipynb` and `spm_electrode_design.ipynb`.

docs/installation.rst

@@ -42,6 +42,28 @@ For those who prefer to install PyBOP from a local clone of the repository or wi
 
 In editable mode, changes you make to the source code will immediately affect the PyBOP installation without the need for reinstallation.
 
+Optional Packages
+-----------------
+plotly - PyBOP uses plotly>=5.0, and can be installed with:
+
+.. code-block:: console
+
+    pip install plotly
+
+scikit-fem - This is a dependency for the multi-dimensional pybamm models, and can be installed using:
+
+.. code-block:: console
+
+    pip install scikit-fem[all]
+
+bpx - To use physics based battery models of Faraday Institution's MSM project Battery Parameter eXchange (BPX) is required:
+
+.. code-block:: console
+
+    pip install bpx
+
+For more information of the additional packages, user may have a look `here <https://github.com/pybop-team/PyBOP/blob/develop/pyproject.toml>`_.
+
 Verifying Installation
 ----------------------
 

pyproject.toml

@@ -30,7 +30,6 @@ dependencies = [
   "numpy>=1.16, <2.0",
   "scipy>=1.3",
   "pints>=0.5",
-  "bpx>=0.4",
 ]
 
 [project.optional-dependencies]
@@ -58,7 +57,10 @@ dev = [
 scifem = [
   "scikit-fem>=8.1.0" # scikit-fem is a dependency for the multi-dimensional pybamm models
 ]
-all = ["pybop[plot]", "pybop[scifem]"]
+bpx = [
+    "bpx>=0.4",
+]
+all = ["pybop[plot]", "pybop[scifem]", "pybop[bpx]"]
 
 [tool.setuptools.packages.find]
 include = ["pybop", "pybop.*"]