Skip to content

AlphaPEM is an open-source software package for simulating proton exchange membrane fuel cell (PEMFC) systems using physics-based models for embedded applications.

License

Notifications You must be signed in to change notification settings

gassraphael/AlphaPEM

Repository files navigation

AlphaPEM

AlphaPEM is an open-source software package for simulating proton exchange membrane fuel cell (PEMFC) systems for embedded applications. It is based on a physics-based, one-dimensional (1D), dynamic, two-phase, and non-isothermal model. It quickly simulates the internal states and voltage dynamics of PEMFC systems for all current densities and operating conditions imposed on it. In particular, it is possible to apply a step current density or use current profiles to generate polarization curves or electrochemical impedance spectroscopy (EIS) curves. It can also automatically calibrate the undetermined parameters of the model to simulate a given real fuel cell system.

A detailed presentation of this program is published in the peer-reviewed journal SoftwareX. Furthermore, comprehensive documentation in Numpy style for the software functions is available.

Improvements to AlphaPEM, such as the addition of auxiliary cooling system modeling and spatial extension to 1D+1D, will be available in the future.

Important note: AlphaPEM is an ongoing research project and is not a commercial product. Therefore, the latest online version may contain bugs, and not all features may be available. Relatively stable versions are listed in the Major updates section.

AlphaPEM graphical user interface

Table of Contents

Installation

To install AlphaPEM, follow these steps in a shell:

  1. Clone the repository:

    git clone https://github.com/gassraphael/AlphaPEM.git
  2. Navigate to the project directory:

    cd AlphaPEM
  3. Update the Python package manager, pip, to the latest available version:

    pip install --upgrade pip
  4. Install the required dependencies (eventually in a specific environment):

    pip install numpy scipy matplotlib colorama pygad
    python3 -m pip install git+https://github.com/RedFantom/ttkthemes

Major updates

  • V1.2 - in progress - This version of AlphaPEM includes:
    • the addition of the MPL to the simulated cell, in both the anode and cathode. To ensure good numerical stability, a transition layer between each GDL and MPL is also included.
    • the addition of the open-source ZSW GenStack as a calibrated fuel cell case study.
  • V1.1 - 2025.08.18 - This version of AlphaPEM includes:
    • the addition of heat transfer to the program, in cooperation with Pedro Affonso Nobrega (PERSEE, MINES PSL).
    • an improvement of the initial variable values: the algorithm waits for a given time (approximately 2 virtual hours) to reach equilibrium, and then the experiment starts (step/pola/EIS).
    • the limit liquid water saturation coefficient ($s_{lim}$) is temporarily removed for future refinement.
  • V1.0 - 2024.09.05 - This version of AlphaPEM corresponds to the one developed during Raphaël Gass's PhD from 2021 to 2024.
    • It is based on a physics-based, one-dimensional (1D), dynamic, two-phase, and isothermal model.

Work in progress

  • The addition of the MPL to the model is currently in progress.

Related publications

The detailed model description and simulation results can be found in the following articles and thesis.

  • Published journal papers:

    • AlphaPEM: An Open-Source Dynamic 1D Physics-Based Pem Fuel Cell Model for Embedded Applications (2025, 1st author)

      • In the SoftwareX journal, in arXiv, in HAL or in SSRN (postprint).
      • The objective of this work is to highlight the AlphaPEM software, which has been published as open-source on GitHub. The first version of this PEM fuel cell simulator is based on the dynamic 1D model developed during 2021-2024.
    • An Advanced 1D Physics-Based Model for PEM Hydrogen Fuel Cells With Enhanced Overvoltage Prediction (2025, 1st author)

      • In the International Journal of Hydrogen Energy, in arXiv, in HAL or in SSRN (postprint).
      • The aim of this study was to introduce the dynamic 1D model developed during 2021-2024, emphasizing the adjustment of the equations for this specific model and their numerical resolution. Furthermore, a novel coefficient is proposed to establish a physical relationship between the voltage drop at high currents, the quantity of liquid water in the cell, and operating conditions.
      • 1D modeling of matter transport phenomena in a PEM single cell divided into several nodes.
    • A Critical Review of Proton Exchange Membrane Fuel Cells Matter Transports and Voltage Polarisation for Modelling (2024, 1st author)

      • In the Journal of the Electrochemical Society or in HAL (postprint).
      • The aim of this work was to compile, within a single article, all the equations required for the physical modeling of a fuel cell. Each equation is complemented with explanations, critical analysis, and suggestions for potential enhancements.
  • Thesis manuscript:

    • Advanced physical modeling of PEM fuel cells to enhance their performances (2024, 1st author)
      • In HAL (final version).
      • The objective of this thesis was to develop an advanced model for PEMFCs to optimize their control and improve performance. A 1D, dynamic, two-phase, isothermal model was proposed, leading to the development of the open-source software AlphaPEM, which enables accurate simulations and facilitates predictive control strategies for enhanced fuel cell operation.

Contributions

Authors

  • AlphaPEM is firstly developed by Raphaël Gass during his PhD thesis in control engineering at the LIS Laboratory in Aix-Marseille University, and in co-supervision with FEMTO-ST Institute, within the FCLab, in Franche-Comté University, from 2021 to 2024. This work has been supervised by Prof. Zhongliang Li (FEMTO-ST), Prof. Rachid Outbib (LIS), Prof. Samir Jemei (FEMTO-ST) and Prof. Daniel Hissel (FEMTO-ST).

  • The development of AlphaPEM was subsequently continued by Raphaël Gass during his postdoctoral research from 2025 to 2027 at ENERGY-Lab, University of Reunion island, in partnership with the ZSW Institute in Ulm, Germany. This work was supervised by Prof. Michel Benne (ENERGY-Lab), Associate Prof. Cédric Damour (ENERGY-Lab), Associate Prof. Dominique Grondin (ENERGY-Lab), and Dr. Florian Wilhelm (ZSW).

Financial support

This work has been supported:

  • from 2021 to 2024 by French National Research Agency via project DEAL (Grant no. ANR-20-CE05-0016-01), the Region Provence-Alpes-Côte d’Azur, the EIPHI Graduate School (contract ANR-17-EURE-0002) and the Region Bourgogne Franche-Comté.
  • from 2025 to 2027 by European FEDER funds via project OPUS-H2 and the Region Reunion.

Licenses

AlphaPEM is licensed under the GNU GPL 3.0. See the LICENSE file for more details.

It also includes components licensed under the BSD-3-Clause license:

  • calibration/parameter_calibration.py from PyGAD.

New contributors

Contributions from the community are welcome! If you would like to contribute to AlphaPEM, please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/YourFeature).
  3. Commit your changes (git commit -am 'Add some feature').
  4. Push to the branch (git push origin feature/YourFeature).
  5. Create a new Pull Request.

Contact

For any questions or support, please contact me at [email protected].

Thank you for using AlphaPEM!

About

AlphaPEM is an open-source software package for simulating proton exchange membrane fuel cell (PEMFC) systems using physics-based models for embedded applications.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published