Awesome
<div align="center"> <img src="https://github.com/ECSIM/opem/raw/master/otherfile/logo.png" width=300px> <br/> <a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3" /></a> <a href="https://codecov.io/gh/ECSIM/opem"> <img src="https://codecov.io/gh/ECSIM/opem/branch/master/graph/badge.svg" /> </a> <a href="https://badge.fury.io/py/opem"><img src="https://badge.fury.io/py/opem.svg" alt="PyPI version" height="18"></a> <a href="https://anaconda.org/ECSIM/opem"><img src="https://anaconda.org/ecsim/opem/badges/version.svg"></a> <a href="Documents/"><img src="https://img.shields.io/badge/doc-latest-orange.svg"></a> <a href="https://discord.gg/v9RGYq9W5m"> <img src="https://img.shields.io/discord/1006472275920425012.svg" alt="Discord Channel"> </a> </div>Table of Contents
- What is PEM?
- Overview
- Installation
- Usage
- Issues & Bug Reports
- Contribution
- Outputs
- Thanks
- Reference
- Cite
- Authors
- License
- Show Your Support
- Changelog
- Code of Conduct
Overview
<p align="justify"> Modeling and simulation of proton-exchange membrane fuel cells (PEMFC) may work as a powerful tool in the research & development of renewable energy sources. The Open-Source PEMFC Simulation Tool (OPEM) is a modeling tool for evaluating the performance of proton exchange membrane fuel cells. This package is a combination of models (static/dynamic) that predict the optimum operating parameters of PEMFC. OPEM contained generic models that will accept as input, not only values of the operating variables such as anode and cathode feed gas, pressure and compositions, cell temperature and current density, but also cell parameters including the active area and membrane thickness. In addition, some of the different models of PEMFC that have been proposed in the OPEM, just focus on one particular FC stack, and some others take into account a part or all auxiliaries such as reformers. OPEM is a platform for collaborative development of PEMFC models. </p> <div align="center"> <img src="https://github.com/ECSIM/opem/raw/master/otherfile/OPEM_BLOCK_DIAGRAM.jpg"> <p>Fig1. OPEM Block Diagram</p> </div> <table> <tr> <td align="center">Open Hub</td> <td align="center"><a href="https://www.openhub.net/p/opem"><img src="https://www.openhub.net/p/opem/widgets/project_thin_badge.gif"></a></td> </tr> <tr> <td align="center">PyPI Counter</td> <td align="center"><a href="http://pepy.tech/project/opem"><img src="http://pepy.tech/badge/opem"></a></td> </tr> <tr> <td align="center">Github Stars</td> <td align="center"><a href="https://github.com/ecsim/opem"><img src="https://img.shields.io/github/stars/ECSIM/opem.svg?style=social&label=Stars"></a></td> </tr> </table> <table> <tr> <td align="center">Branch</td> <td align="center">master</td> <td align="center">develop</td> </tr> <tr> <td align="center">CI</td> <td align="center"><img src="https://github.com/ECSIM/opem/actions/workflows/test.yml/badge.svg?branch=master"></td> <td align="center"><img src="https://github.com/ECSIM/opem/actions/workflows/test.yml/badge.svg?branch=develop"></td> </tr> </table> <table> <tr> <td align="center">Code Quality</td> <td align="center"><a href="https://www.codacy.com/gh/ECSIM/opem/dashboard?utm_source=github.com&utm_medium=referral&utm_content=ECSIM/opem&utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/7e8bf5e11c0b455da3807ee4e493713e"/></a></td> <td align="center"><a href="https://www.codefactor.io/repository/github/ecsim/opem"><img src="https://www.codefactor.io/repository/github/ecsim/opem/badge" alt="CodeFactor" /></a></td> </tr> </table>Usage
Executable
- Open
CMD
(Windows) orTerminal
(UNIX) - Run
opem
orpython -m opem
(or runOPEM.exe
) - Enter PEM cell parameters (or run standard test vectors)
-
Amphlett Static Model
<html> <table> <tr> <td align="center">Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">T</td> <td align="center">Cell operation temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">PH2</td> <td align="center">Partial pressure</td> <td align="center">atm</td> </tr> <tr> <td align="center">PO2</td> <td align="center">Partial pressure</td> <td align="center">atm</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> <tr> <td align="center">A</td> <td align="center">Active area</td> <td align="center">cm^2</td> </tr> <tr> <td align="center">l</td> <td align="center">Membrane thickness</td> <td align="center">cm</td> </tr> <tr> <td align="center">lambda</td> <td align="center">An adjustable parameter with a min value of 14 and max value of 23</td> <td align="center">--</td> </tr> <tr> <td align="center">R(*Optional)</td> <td align="center">R-Electronic</td> <td align="center">ohm</td> </tr> <tr> <td align="center">JMax</td> <td align="center">Maximum current density</td> <td align="center">A/(cm^2)</td> </tr> <tr> <td align="center">N</td> <td align="center">Number of single cells</td> <td align="center">--</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Amphlett.html">here</a> -
Larminie-Dicks Static Model
<html> <table> <tr> <td align="center">Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">Fuel cell reversible no loss voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">A</td> <td align="center">The slope of the Tafel line</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Cell operation temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> <tr> <td align="center">i_n</td> <td align="center">Internal current</td> <td align="center">A</td> </tr> <tr> <td align="center">i_0</td> <td align="center">Exchange current at which the overvoltage begins to move from zero </td> <td align="center">A</td> </tr> <tr> <td align="center">i_L</td> <td align="center">Limiting current</td> <td align="center">A</td> </tr> <tr> <td align="center">RM</td> <td align="center">The membrane and contact resistances</td> <td align="center">ohm</td> </tr> <tr> <td align="center">N</td> <td align="center">Number of single cells</td> <td align="center">--</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Larminie_Dicks.html">here</a> -
Chamberline-Kim Static Model
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">Open circuit voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">b</td> <td align="center">Tafel's parameter for the oxygen reduction</td> <td align="center">V</td> </tr> <tr> <td align="center">R</td> <td align="center">Resistance</td> <td align="center">ohm.cm^2</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> <tr> <td align="center">A</td> <td align="center">Active area</td> <td align="center">cm^2</td> </tr> <tr> <td align="center">m</td> <td align="center">Diffusion's parameters</td> <td align="center">V</td> </tr> <tr> <td align="center">n</td> <td align="center">Diffusion's parameters</td> <td align="center">(A^-1)(cm^2)</td> </tr> <tr> <td align="center">N</td> <td align="center">Number of single cells</td> <td align="center">--</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Chamberline_Kim.html">here</a> -
Padulles Dynamic Model I
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">No load voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Fuel cell temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">KH2</td> <td align="center">Hydrogen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KO2</td> <td align="center">Oxygen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">tH2</td> <td align="center">Hydrogen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tO2</td> <td align="center">Oxygen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">B</td> <td align="center">Activation voltage constant</td> <td align="center">V</td> </tr> <tr> <td align="center">C</td> <td align="center">Activation constant parameter</td> <td align="center">A^(-1)</td> </tr> <tr> <td align="center">Rint</td> <td align="center">Fuel cell internal resistance</td> <td align="center">ohm</td> </tr> <tr> <td align="center">rho</td> <td align="center">Hydrogen-Oxygen flow ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">qH2</td> <td align="center">Molar flow of hydrogen</td> <td align="center">kmol/s</td> </tr> <tr> <td align="center">N0</td> <td align="center">Number of cells</td> <td align="center">--</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles1.html">here</a> -
Padulles Dynamic Model II
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">No load voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Fuel cell temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">KH2</td> <td align="center">Hydrogen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KH2O</td> <td align="center">Water valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KO2</td> <td align="center">Oxygen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">tH2</td> <td align="center">Hydrogen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tH2O</td> <td align="center">Water time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tO2</td> <td align="center">Oxygen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">B</td> <td align="center">Activation voltage constant</td> <td align="center">V</td> </tr> <tr> <td align="center">C</td> <td align="center">Activation constant parameter</td> <td align="center">A^(-1)</td> </tr> <tr> <td align="center">Rint</td> <td align="center">Fuel cell internal resistance</td> <td align="center">ohm</td> </tr> <tr> <td align="center">rho</td> <td align="center">Hydrogen-Oxygen flow ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">qH2</td> <td align="center">Molar flow of hydrogen</td> <td align="center">kmol/s</td> </tr> <tr> <td align="center">N0</td> <td align="center">Number of cells</td> <td align="center">--</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles2.html">here</a> -
Padulles-Hauer Dynamic Model
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">No load voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Fuel cell temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">KH2</td> <td align="center">Hydrogen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KH2O</td> <td align="center">Water valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KO2</td> <td align="center">Oxygen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">tH2</td> <td align="center">Hydrogen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tH2O</td> <td align="center">Water time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tO2</td> <td align="center">Oxygen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">t1</td> <td align="center">Reformer time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">t2</td> <td align="center">Reformer time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">B</td> <td align="center">Activation voltage constant</td> <td align="center">V</td> </tr> <tr> <td align="center">C</td> <td align="center">Activation constant parameter</td> <td align="center">A^(-1)</td> </tr> <tr> <td align="center">CV</td> <td align="center">Conversion factor</td> <td align="center">--</td> </tr> <tr> <td align="center">Rint</td> <td align="center">Fuel cell internal resistance</td> <td align="center">ohm</td> </tr> <tr> <td align="center">rho</td> <td align="center">Hydrogen-Oxygen flow ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">qMethanol</td> <td align="center">Molar flow of methanol</td> <td align="center">kmol/s</td> </tr> <tr> <td align="center">N0</td> <td align="center">Number of cells</td> <td align="center">--</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles_Hauer.html">here</a> -
Padulles-Amphlett Dynamic Model
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">No load voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Fuel cell temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">KH2</td> <td align="center">Hydrogen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KH2O</td> <td align="center">Water valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KO2</td> <td align="center">Oxygen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">tH2</td> <td align="center">Hydrogen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tH2O</td> <td align="center">Water time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">tO2</td> <td align="center">Oxygen time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">t1</td> <td align="center">Reformer time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">t2</td> <td align="center">Reformer time constant</td> <td align="center">s</td> </tr> <tr> <td align="center">A</td> <td align="center">Active area</td> <td align="center">cm^2</td> </tr> <tr> <td align="center">l</td> <td align="center">Membrane thickness</td> <td align="center">cm</td> </tr> <tr> <td align="center">lambda</td> <td align="center">An adjustable parameter with a min value of 14 and max value of 23</td> <td align="center">--</td> </tr> <tr> <td align="center">R(*Optional)</td> <td align="center">R-Electronic</td> <td align="center">ohm</td> </tr> <tr> <td align="center">JMax</td> <td align="center">Maximum current density</td> <td align="center">A/(cm^2)</td> </tr> <tr> <td align="center">CV</td> <td align="center">Conversion factor</td> <td align="center">--</td> </tr> <tr> <td align="center">rho</td> <td align="center">Hydrogen-Oxygen flow ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">qMethanol</td> <td align="center">Molar flow of methanol</td> <td align="center">kmol/s</td> </tr> <tr> <td align="center">N0</td> <td align="center">Number of cells</td> <td align="center">--</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles_Amphlett.html">here</a> -
Chakraborty Dynamic Model
<html> <table> <tr> <td align="center" >Input</td> <td align="center">Description</td> <td align="center">Unit</td> </tr> <tr> <td align="center">E0</td> <td align="center">No load voltage</td> <td align="center">V</td> </tr> <tr> <td align="center">T</td> <td align="center">Cell operation temperature</td> <td align="center">K</td> </tr> <tr> <td align="center">KH2</td> <td align="center">Hydrogen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KH2O</td> <td align="center">Water valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">KO2</td> <td align="center">Oxygen valve constant</td> <td align="center">kmol.s^(-1).atm^(-1)</td> </tr> <tr> <td align="center">rho</td> <td align="center">Hydrogen-Oxygen flow ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">Rint</td> <td align="center">Fuel cell internal resistance</td> <td align="center">ohm</td> </tr> <tr> <td align="center">N0</td> <td align="center">Number of cells</td> <td align="center">--</td> </tr> <tr> <td align="center">u</td> <td align="center">Fuel utilization ratio</td> <td align="center">--</td> </tr> <tr> <td align="center">i-start</td> <td align="center">Cell operating current start point</td> <td align="center">A</td> </tr> <tr> <td align="center">i-step</td> <td align="center">Cell operating current step</td> <td align="center">A</td> </tr> <tr> <td align="center">i-stop</td> <td align="center">Cell operating current end point</td> <td align="center">A</td> </tr> </table> </html> * For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Chakraborty.html">here</a>
- Find your reports in
Model_Name
folder
Screen Record
<div align="center"> <a href="https://asciinema.org/a/170416" target="_blank"><img src="https://asciinema.org/a/170416.png" /></a> <p>Screen Record</p> </div> -
Library
-
Amphlett Static Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >Eta_Active</td> <td align="center">Eta activation</td> <td align="center">List</td> </tr> <tr> <td align="center" >Eta_Conc</td> <td align="center">Eta concentration</td> <td align="center">List</td> </tr> <tr> <td align="center" >Eta_Ohmic</td> <td align="center">Eta ohmic</td> <td align="center">List</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Static.Amphlett import Static_Analysis >>> Test_Vector={"T": 343.15,"PH2": 1,"PO2": 1,"i-start": 0,"i-stop": 75,"i-step": 0.1,"A": 50.6,"l": 0.0178,"lambda": 23,"N": 1,"R": 0,"JMax": 1.5,"Name": "Amphlett_Test"} >>> data=Static_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Amphlett.html">here</a>
-
Larminie-Dicks Static Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Static.Larminie_Dicks import Static_Analysis >>> Test_Vector = {"A": 0.06,"E0": 1.178,"T": 328.15,"RM": 0.0018,"i_0": 0.00654,"i_L": 100.0,"i_n": 0.23,"N": 23,"i-start": 0.1,"i-stop": 98,"i-step": 0.1,"Name": "Larminiee_Test"} >>> data=Static_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Larminie_Dicks.html">here</a>
-
Chamberline-Kim Static Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Static.Chamberline_Kim import Static_Analysis >>> Test_Vector = {"A": 50.0,"E0": 0.982,"b": 0.0689,"R": 0.328,"m": 0.000125,"n": 9.45,"N": 1,"i-start": 1,"i-stop": 42.5,"i-step": 0.1,"Name": "Chamberline_Test"} >>> data=Static_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Static/Chamberline_Kim.html">here</a>
-
Padulles Dynamic Model I
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >PO2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Dynamic.Padulles1 import Dynamic_Analysis >>> Test_Vector = {"T": 343,"E0": 0.6,"N0": 88,"KO2": 0.0000211,"KH2": 0.0000422,"tH2": 3.37,"tO2": 6.74,"B": 0.04777,"C": 0.0136,"Rint": 0.00303,"rho": 1.168,"qH2": 0.0004,"i-start": 0,"i-stop": 100,"i-step": 0.1,"Name": "PadullesI_Test"} >>> data=Dynamic_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles1.html">here</a>
-
Padulles Dynamic Model II
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >PO2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2O</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Dynamic.Padulles2 import Dynamic_Analysis >>> Test_Vector = {"T": 343,"E0": 0.6,"N0": 5,"KO2": 0.0000211,"KH2": 0.0000422,"KH2O": 0.000007716,"tH2": 3.37,"tO2": 6.74,"tH2O": 18.418,"B": 0.04777,"C": 0.0136,"Rint": 0.00303,"rho": 1.168,"qH2": 0.0004,"i-start": 0.1,"i-stop": 100,"i-step": 0.1,"Name": "Padulles2_Test"} >>> data=Dynamic_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles2.html">here</a>
-
Padulles-Hauer Dynamic Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >PO2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2O</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Dynamic.Padulles_Hauer import Dynamic_Analysis >>> Test_Vector = {"T": 343,"E0": 0.6,"N0": 5,"KO2": 0.0000211,"KH2": 0.0000422,"KH2O": 0.000007716,"tH2": 3.37,"tO2": 6.74,"t1": 2,"t2": 2,"tH2O": 18.418,"B": 0.04777,"C": 0.0136,"Rint": 0.00303,"rho": 1.168,"qMethanol": 0.0002,"CV": 2,"i-start": 0.1,"i-stop": 100,"i-step": 0.1,"Name": "Padulles_Hauer_Test"} >>> data=Dynamic_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles_Hauer.html">here</a>
-
Padulles-Amphlett Dynamic Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >PO2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2O</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >Eta_Active</td> <td align="center">Eta activation</td> <td align="center">List</td> </tr> <tr> <td align="center" >Eta_Conc</td> <td align="center">Eta concentration</td> <td align="center">List</td> </tr> <tr> <td align="center" >Eta_Ohmic</td> <td align="center">Eta ohmic</td> <td align="center">List</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Dynamic.Padulles_Amphlett import Dynamic_Analysis >>> Test_Vector = {"A": 50.6,"l": 0.0178,"lambda": 23,"JMax": 1.5,"T": 343,"N0": 5,"KO2": 0.0000211,"KH2": 0.0000422,"KH2O": 0.000007716,"tH2": 3.37,"tO2": 6.74,"t1": 2,"t2": 2,"tH2O": 18.418,"rho": 1.168,"qMethanol": 0.0002,"CV": 2,"i-start": 0.1,"i-stop": 75,"i-step": 0.1,"Name": "Padulles_Amphlett_Test"} >>> data=Dynamic_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Padulles_Amphlett.html">here</a>
-
Chakraborty Dynamic Model
<html> <table> <tr> <td align="center" >Key</td> <td align="center">Description</td> <td align="center">Type</td> </tr> <tr> <td align="center" >Status</td> <td align="center">Simulation status</td> <td align="center">Bool</td> </tr> <tr> <td align="center" >P</td> <td align="center">Power</td> <td align="center">List</td> </tr> <tr> <td align="center" >I</td> <td align="center">Cell operating current</td> <td align="center">List</td> </tr> <tr> <td align="center" >V</td> <td align="center">FC voltage</td> <td align="center">List</td> </tr> <tr> <td align="center" >EFF</td> <td align="center">Efficiency</td> <td align="center">List</td> </tr> <tr> <td align="center" >PO2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >PH2O</td> <td align="center">Partial pressure</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ph</td> <td align="center">Thermal power</td> <td align="center">List</td> </tr> <tr> <td align="center" >Nernst Gain</td> <td align="center">Nernst Gain</td> <td align="center">List</td> </tr> <tr> <td align="center" >Ohmic Loss</td> <td align="center">Ohmic Loss</td> <td align="center">List</td> </tr> <tr> <td align="center" >V0</td> <td align="center">Linear-Apx intercept</td> <td align="center">Float</td> </tr> <tr> <td align="center" >K</td> <td align="center">Linear-Apx slope</td> <td align="center">Float</td> </tr> <tr> <td align="center" >VE</td> <td align="center">Estimated FC voltage</td> <td align="center">List</td> </tr> </table> </html>>>> from opem.Dynamic.Chakraborty import Dynamic_Analysis >>> Test_Vector = {"T": 1273,"E0": 0.6,"u":0.8,"N0": 1,"R": 3.28125 * 10**(-3),"KH2O": 0.000281,"KH2": 0.000843,"KO2": 0.00252,"rho": 1.145,"i-start": 0.1,"i-stop": 300,"i-step": 0.1,"Name": "Chakraborty_Test"} >>> data=Dynamic_Analysis(InputMethod=Test_Vector,TestMode=True,PrintMode=False,ReportMode=False)
- For more information about this model visit <a href="https://www.ecsim.site/opem/doc/Dynamic/Chakraborty.html">here</a>
Parameters
TestMode
: Active test mode and get/return data asdict
, (Default :False
)ReportMode
: Generate reports(.csv
,.opem
,.html
) and print result in console, (Default :True
)PrintMode
: Control printing in console, (Default :True
)Folder
: Reports folder, (Default :os.getcwd()
)
Note
- Return type :
dict
Telegram Bot
- Send
/start
command to OPEM BOT - Choose models from menu
- Send your test vector according to the template
- Download your results
Try OPEM in Your Browser!
OPEM can be used online in interactive Jupyter Notebooks via the Binder service! Try it out now! :
- Check
.ipynb
files inDocuments
folder - Edit and execute each part of the notes, step by step from the top panel by run button
- For executing a complete simulation, you can edit
Test_Vector
inFull Run
section
Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP! or send an email to opem@ecsim.site.
You can also join our discord server
<a href="https://discord.gg/v9RGYq9W5m"> <img src="https://img.shields.io/discord/1006472275920425012.svg?style=for-the-badge" alt="Discord Channel"> </a>Outputs
Thanks
- Chart.js
- PyInstaller
- Draw.io
- Zahra Mobasher (Logo design)
Reference
<blockquote>1- J. C. Amphlett, R. M. Baumert, R. F. Mann, B. A. Peppley, and P. R. Roberge. 1995. "Performance Modeling of the Ballard Mark IV Solid Polymer Electrolyte Fuel Cell." J. Electrochem. Soc. (The Electrochemical Society, Inc.) 142 (1): 9-15. doi: 10.1149/1.2043959. </blockquote> <blockquote>2- Jeferson M. Correa, Felix A. Farret, Vladimir A. Popov, Marcelo G. Simoes. 2005. "Sensitivity Analysis of the Modeling Parameters Used in Simulation of Proton Exchange Membrane Fuel Cells." IEEE Transactions on Energy Conversion (IEEE) 20 (1): 211-218. doi:10.1109/TEC.2004.842382.</blockquote> <blockquote>3- Junbom Kim, Seong-Min Lee, Supramaniam Srinivasan, Charles E. Chamberlin. 1995. "Modeling of Proton Exchange Membrane Fuel Cell Performance with an Empirical Equation." Journal of The Electrochemical Society (The Electrochemical Society) 142 (8): 2670-2674. doi:10.1149/1.2050072.</blockquote> <blockquote> 4- I. Sadli, P. Thounthong, J.-P. Martin, S. Rael, B. Davat. 2006. "Behaviour of a PEMFC supplying a low voltage static converter." Journal of Power Sources (Elsevier) 156: 119–125. doi:10.1016/j.jpowsour.2005.08.021. </blockquote> <blockquote> 5- J. Padulles, G.W. Ault, J.R. McDonald. 2000. "An integrated SOFC plant dynamic model for power systems simulation." Journal of Power Sources (Elsevier) 86 (1-2): 495-500. doi:10.1016/S0378-7753(99)00430-9. </blockquote> <blockquote> 6- Hauer, K.-H. 2001. "Analysis tool for fuel cell vehicle hardware and software (controls) with an application to fuel economy comparisons of alternative system designs." Ph.D. dissertation, Transportation Technology and Policy, University of California Davis. </blockquote> <blockquote> 7- A. Saadi, M. Becherif, A. Aboubou, M.Y. Ayad. 2013. "Comparison of proton exchange membrane fuel cell static models." Renewable Energy (Elsevier) 56: 64-71. doi:dx.doi.org/10.1016/j.renene.2012.10.012. </blockquote> <blockquote> 8- Diego Feroldi, Marta Basualdo. 2012. "Description of PEM Fuel Cells System." Green Energy and Technology (Springer) 49-72. doi:10.1007/978-1-84996-184-4_2 </blockquote> <blockquote> 9- Gottesfeld, Shimshon. n.d. The Polymer Electrolyte Fuel Cell: Materials Issues in a Hydrogen Fueled Power Source. http://physics.oregonstate.edu/~hetheriw/energy/topics/doc/electrochemistry/fc/basic/The_Polymer_Electrolyte_Fuel_Cell.htm </blockquote> <blockquote> 10- Mohamed Becherif, Aïcha Saadi, Daniel Hissel, Abdennacer Aboubou, Mohamed Yacine Ayad. 2011. "Static and dynamic proton exchange membrane fuel cell models." Journal of Hydrocarbons Mines and Environmental Research 2 (1) </blockquote> <blockquote> 11- Larminie, J., Dicks, A., & McDonald, M. S. 2003. Fuel cell systems explained (Vol. 2, pp. 207-225). Chichester, UK: J. Wiley. doi: 10.1002/9781118706992. </blockquote> <blockquote> 12- Rho, Y. W., Srinivasan, S., & Kho, Y. T. 1994. ''Mass transport phenomena in proton exchange membrane fuel cells using o 2/he, o 2/ar, and o 2/n 2 mixtures ii. Theoretical analysis.'' Journal of the Electrochemical Society, 141(8), 2089-2096. doi: 10.1149/1.2055066. </blockquote> <blockquote> 13- U. Chakraborty, A New Model for Constant Fuel Utilization and Constant Fuel Flow in Fuel Cells, Appl. Sci. 9 (2019) 1066. https://doi.org/10.3390/app9061066. </blockquote>Cite
If you use OPEM in your research , please cite this paper :
<pre> @article{Haghighi2018, doi = {10.21105/joss.00676}, url = {https://doi.org/10.21105/joss.00676}, year = {2018}, month = {jul}, publisher = {The Open Journal}, volume = {3}, number = {27}, pages = {676}, author = {Sepand Haghighi and Kasra Askari and Sarmin Hamidi and Mohammad Mahdi Rahimi}, title = {{OPEM} : Open Source {PEM} Cell Simulation Tool}, journal = {Journal of Open Source Software} } </pre>Download OPEM.bib(BibTeX Format)
<table> <tr> <td align="center">JOSS</td> <td align="center"><a style="border-width:0" href="https://doi.org/10.21105/joss.00676"><img src="http://joss.theoj.org/papers/10.21105/joss.00676/status.svg" alt="DOI badge" ></a></td> </tr> <tr> <td align="center">Zenodo</td> <td align="center"><a href="https://doi.org/10.5281/zenodo.1133110"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.1133110.svg" alt="DOI"></a></td> </tr> </table>Show Your Support
<h3>Star This Repo</h3>Give a ⭐️ if this project helped you!
<h3>Donate to Our Project</h3>If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .
<a href="https://www.ecsim.site/opem/donate.html" target="_blank"><img src="http://www.ecsim.site/images/Donate-Button.png" height="90px" width="270px" alt="OPEM Donation"></a>