cidetec/cidemod repository overview

⁠cideMOD

CIDETEC's open-source tool cideMOD is based on the Doyle--Fuller--Newman model in which the physicochemical equations are solved by Finite Element methods using the FEniCS library. It enables doing physics-based battery cell (herein after cell) simulations with a wide variety of use cases, from different drive cycles to studies of the SEI growth under storage conditions.

cideMOD is a pseudo X-dimensional (pXD) model that extends the original pseudo 2-dimensional (P2D) model, proposed by Newman and co-workers, from 1D to 2D and 3D cell geometries. Therefore, charge balance, mass balance and reaction kinetics, as well as energy balance, are spatially resolved for the entire cell geometry, considering the inhomogeneity of cell state properties. cideMOD has some additional models for solving the cell thermal behaviour, including mayor heat sources, and studying battery degradation mechanisms (e.g., SEI growth and loss of active material). It also supports several active materials in the electrodes, and, nonlinear and temperature dependent electrode and electrolyte transport properties.

It allows complete customization of the cell geometry including the tab position for optimal configuration, as well as highly customizable simulation conditions

⁠Documentation

The documentation can be viewed at ReadTheDocs ⁠.

You can also access the documentation on the docs folder building it (See the requirements.txt file for necessary packages):

   $ cd docs/
   $ make html

⁠License

cideMOD is copyright (C) 2022 of CIDETEC Energy Storage and is distributed under the terms of the Affero GNU General Public License (GPL) version 3 or later.

⁠Contact

For issues and bug reports visit:

https://github.com/cidetec-energy-storage/cideMOD⁠

For other questions about cideMOD, you are welcome to contact us via email:

[email protected]⁠