A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

MPET

Run simulations of batteries with porous electrodes using porous electrode theory, which is a volume-averaged, multiscale approach to capture the coupled behavior of electrolyte and active material within electrodes.
https://github.com/TRI-AMDD/mpet

Category: Energy Storage
Sub Category: Battery

Last synced: about 20 hours ago
JSON representation

Repository metadata

MPET lithium-ion battery simulator

README.md

Build
Coverage Status
readthedocs
release

MPET -- Multiphase Porous Electrode Theory

This software is designed to run simulations of batteries with porous electrodes using porous electrode theory, which is a volume-averaged, multiscale approach to capture the coupled behavior of electrolyte and active material within electrodes. As a result, with physical parameter inputs and run protocols (specified current or voltage profiles), it makes predictions about the internal dynamics within a battery (electrolyte concentration and potential, solid phase concentrations, reaction rates, etc.) and also macroscopic, easily measurable electrochemical quantities such as total current and voltage. In this way, it is similar to the dualfoil code released by Newman and coworkers from Berkeley. This software has much of the functionality contained in dualfoil (it is currently missing, e.g., temperature dependence). However, beyond the standard porous electrode theory simulations, this software can also simulate electrodes in which the active materials phase separate using non-equilibrium thermodynamics within a phase field modeling framework. Such behavior is common in widely used electrode materials, including graphite and LiFePO4.

If you use this software in academic work, please cite the relevant references detailing its development as presented in the LICENSE file. For more details on the theory implemeneted in the code, see:

Smith, R. B., and Bazant M. Z., Multiphase Porous Electrode Theory, Journal of the Electrochemical Society, 2017, 164 (11) E3291-E3310, arXiv preprint.

Documentation

Documentation is available here (https://mpet.readthedocs.io) for installing, running, and analyzing results with mpet.

Troubleshooting

Please use the Issues section of of this repository to ask questions or file bug reports with the software.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 5 days ago

Total Commits: 1,314
Total Committers: 21
Avg Commits per committer: 62.571
Development Distribution Score (DDS): 0.549

Commits in past year: 23
Committers in past year: 4
Avg Commits per committer in past year: 5.75
Development Distribution Score (DDS) in past year: 0.348

Name Email Commits
Raymond Smith r****h@g****m 593
Dan Cogswell c****l@m****u 252
Leon Oostrum l****m@e****l 117
Debbie Zhuang d****g@m****u 89
Laura Ootes l****s@e****l 70
Victor Azizi v****r@l****u 59
Ombrini P****i@t****l 47
Edwin Khoo e****l@g****m 33
Dan Cogswell c****l@a****u 15
Ombrini P****1@t****l 12
Tammo Schwietert t****t@t****l 9
Ombrini 9****i 5
Nicolas Renaud n****d@g****m 3
Supratim Das s****7@m****u 2
TR Ferguson t****f@m****u 2
Edwin Khoo e****l@m****u 1
Ombrini p****o@t****l 1
Spencer Patryck Delgado s****c@D****u 1
Victor Azizi b****t@l****u 1
alexandros A****s@t****l 1
unknown m****s@L****e 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 44
Total pull requests: 66
Average time to close issues: 8 months
Average time to close pull requests: 2 months
Total issue authors: 10
Total pull request authors: 8
Average comments per issue: 1.41
Average comments per pull request: 2.79
Merged pull request: 52
Bot issues: 0
Bot pull requests: 0

Past year issues: 1
Past year pull requests: 4
Past year average time to close issues: 23 days
Past year average time to close pull requests: 15 days
Past year issue authors: 1
Past year pull request authors: 2
Past year average comments per issue: 1.0
Past year average comments per pull request: 0.25
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/TRI-AMDD/mpet

Top Issue Authors

  • d-cogswell (15)
  • lightningclaw001 (10)
  • loostrum (6)
  • NicoRenaud (3)
  • marbris (3)
  • v1kko (3)
  • Ombrini (1)
  • stephendkang (1)
  • laurasootes (1)
  • Yanisiqi (1)

Top Pull Request Authors

  • d-cogswell (19)
  • lightningclaw001 (16)
  • Ombrini (10)
  • loostrum (7)
  • laurasootes (6)
  • v1kko (6)
  • NicoRenaud (1)
  • patrickherring-TRI (1)

Top Issue Labels

  • bug (14)
  • enhancement (7)
  • help wanted (6)
  • question (1)

Top Pull Request Labels

  • documentation (1)

Package metadata

pypi.org: mpet

Multiphase porous electrode theory

  • Homepage: https://github.com/TRI-AMDD/mpet
  • Documentation: https://mpet.readthedocs.io/
  • Licenses: MIT
  • Latest release: 1.0.0 (published about 1 year ago)
  • Last Synced: 2025-04-27T13:04:14.785Z (about 20 hours ago)
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 291 Last month
  • Rankings:
    • Dependent packages count: 9.991%
    • Dependent repos count: 21.734%
    • Average: 22.274%
    • Downloads: 35.098%
  • Maintainers (1)

Dependencies

setup.py pypi
  • configparser *
  • h5py *
  • matplotlib *
  • numpy *
  • pyQt5 *
  • schema *
  • scipy *
.github/workflows/mpet-code-style.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/mpet-regression-test.yml actions
  • actions/checkout v3 composite
  • conda-incubator/setup-miniconda v2 composite

Score: 12.438267113444798