PyBaMM-GEM 0.1.0__tar.gz → 0.2.0__tar.gz

pybamm_gem-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+# Runs the tests on every push and pull request, and every Monday, against the latest
+# PyBaMM release. A failing scheduled run opens ONE issue (or adds a comment to the open
+# one). It never changes any code.
+name: CI
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: "17 6 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  release:
+    name: PyBaMM release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check src tests
+      - name: Test
+        run: pytest
+
+  report:
+    name: Report a failure
+    needs: [release]
+    if: ${{ always() && github.event_name == 'schedule' && needs.release.result == 'failure' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Open an issue, or comment on the open one
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          TITLE="Weekly check failed"
+          NUMBER=$(gh issue list --repo "$REPO" --state open --search "$TITLE in:title" --json number --jq '.[0].number')
+          if [ -z "$NUMBER" ]; then
+            gh issue create --repo "$REPO" --title "$TITLE" --body "The weekly check failed. See $RUN_URL"
+          else
+            gh issue comment "$NUMBER" --repo "$REPO" --body "Failed again. See $RUN_URL"
+          fi

pybamm_gem-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv*/
+.pytest_cache/
+.ruff_cache/
+.ipynb_checkpoints/

pybamm_gem-0.2.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.2.0
+
+- Rebuilt in the PyBaMM model-zoo layout: one folder per model, each with a `model.toml`
+  manifest, `CITATION.bib`, `README.md`, tests and an example.
+- Models: `spm_2d` (`BasicSPM2D`), `spm_3d` (`BasicSPM3D`), `dfn_2d` (`DFN2D`) and `dfn_3d` (`DFN3D`).
+- Registry: `pybamm_gem.list_models()`, `pybamm_gem.info()` and `pybamm_gem.load()`.
+- Example notebook: `examples/higher_dimensional_models.ipynb`.
+- Needs PyBaMM 26.9 or newer.
+- The previous code is kept on the branch `legacy-2026-11`.

pybamm_gem-0.1.0/LICENSE → pybamm_gem-0.2.0/LICENSE.txt

@@ -1,28 +1,29 @@
-BSD 3-Clause License
-
-Copyright (c) 2026, Mohammed Asheruddin (Asher)
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+BSD 3-Clause License
+
+Copyright (c) 2026, Imperial College London
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pybamm_gem-0.2.0/LICENSES-bundled.txt

@@ -0,0 +1,37 @@
+PyBaMM-GEM contains code adapted from PyBaMM (https://github.com/pybamm-team/PyBaMM):
+
+- src/pybamm_gem/spm_2d/model.py, adapted from pybamm/models/full_battery_models/lithium_ion/basic_spm.py
+- src/pybamm_gem/dfn_2d/model.py, the electrolyte and electrode submodel methods, adapted from
+  pybamm/models/submodels/electrolyte_conductivity/full_conductivity.py,
+  pybamm/models/submodels/electrolyte_diffusion/full_diffusion.py and
+  pybamm/models/submodels/electrode/ohm/full_ohm.py
+
+PyBaMM is distributed under the following licence:
+
+Copyright (c) 2018, the PyBaMM team.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pybamm_gem-0.2.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.5
+Name: PyBaMM-GEM
+Version: 0.2.0
+Summary: Spatially resolved (2D and 3D) battery models for PyBaMM
+Author: Mohammed Asheruddin N
+License-Expression: BSD-3-Clause
+License-File: LICENSE.txt
+License-File: LICENSES-bundled.txt
+Keywords: battery,electrochemistry,lithium-ion,modelling,pybamm,simulation
+Requires-Python: >=3.10
+Requires-Dist: pybamm[cite]>=26.9
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PyBaMM-GEM
+
+Spatially resolved (2D and 3D) battery models built on [PyBaMM](https://pybamm.org), laid out
+like the PyBaMM model zoo: one folder per model, each with a `model.toml` manifest, a
+`CITATION.bib`, a README, tests and an example.
+
+## Models
+
+| Slug | Class | What it is |
+|---|---|---|
+| `spm_2d` | `BasicSPM2D` | Single Particle Model with a pair of particles at every height z |
+| `spm_3d` | `BasicSPM3D` | The same, over a y-z grid of points |
+| `dfn_2d` | `DFN2D` | Doyle-Fuller-Newman model resolved in x and z |
+| `dfn_3d` | `DFN3D` | The same, resolved in x, y and z |
+
+## Installation
+
+```
+pip install git+https://github.com/ImperialCollegeLondon/PyBaMM-GEM
+```
+
+PyBaMM 26.9 or newer is needed.
+
+## Usage
+
+```python
+import pybamm
+import pybamm_gem as gem
+
+print(gem.list_models())
+model = gem.load("spm_2d")()
+simulation = pybamm.Simulation(model)
+solution = simulation.solve([0, 3000])
+print(solution["Voltage [V]"](1500))
+```
+
+The classes are also available directly, for example `gem.lithium_ion.BasicSPM2D` or
+`gem.lithium_ion.DFN2D`.
+
+The notebook `examples/higher_dimensional_models.ipynb` runs all four models, compares them with
+the stock PyBaMM models and shows a temperature that changes with height.
+
+## Licence
+
+BSD 3-Clause, see `LICENSE.txt`. Copyright (c) 2026, Imperial College London.
+Some of the model code is adapted from PyBaMM; see `LICENSES-bundled.txt`.

pybamm_gem-0.2.0/README.md

@@ -0,0 +1,46 @@
+# PyBaMM-GEM
+
+Spatially resolved (2D and 3D) battery models built on [PyBaMM](https://pybamm.org), laid out
+like the PyBaMM model zoo: one folder per model, each with a `model.toml` manifest, a
+`CITATION.bib`, a README, tests and an example.
+
+## Models
+
+| Slug | Class | What it is |
+|---|---|---|
+| `spm_2d` | `BasicSPM2D` | Single Particle Model with a pair of particles at every height z |
+| `spm_3d` | `BasicSPM3D` | The same, over a y-z grid of points |
+| `dfn_2d` | `DFN2D` | Doyle-Fuller-Newman model resolved in x and z |
+| `dfn_3d` | `DFN3D` | The same, resolved in x, y and z |
+
+## Installation
+
+```
+pip install git+https://github.com/ImperialCollegeLondon/PyBaMM-GEM
+```
+
+PyBaMM 26.9 or newer is needed.
+
+## Usage
+
+```python
+import pybamm
+import pybamm_gem as gem
+
+print(gem.list_models())
+model = gem.load("spm_2d")()
+simulation = pybamm.Simulation(model)
+solution = simulation.solve([0, 3000])
+print(solution["Voltage [V]"](1500))
+```
+
+The classes are also available directly, for example `gem.lithium_ion.BasicSPM2D` or
+`gem.lithium_ion.DFN2D`.
+
+The notebook `examples/higher_dimensional_models.ipynb` runs all four models, compares them with
+the stock PyBaMM models and shows a temperature that changes with height.
+
+## Licence
+
+BSD 3-Clause, see `LICENSE.txt`. Copyright (c) 2026, Imperial College London.
+Some of the model code is adapted from PyBaMM; see `LICENSES-bundled.txt`.