Table of contents

• Overview
• Installation
• Usage
• Issues & Bug Reports
• Contribution
• Dependencies
• Thanks
• Cite
• Authors
• License
• Donate
• Changelog
• Code of Conduct

Overview

GOPEM is a graphical user interface of OPEM (Open Source PEM Fuel Cell Simulation Tool).

Branch	master	develop
Travis
AppVeyor

Code Quality

Installation

Source Code

• Download and install Python3.x (>=3.6)
  • Select Add to PATH option
  • Select Install pip option
• Download Version 0.6 or Latest Source
• Run pip install -r requirements.txt or pip3 install -r requirements.txt (Need root access)
• Run python3 setup.py install or python setup.py install (Need root access)

PyPI

• Check Python Packaging User Guide
• Run pip install gopem or pip3 install gopem (Need root access)

Easy Install

• Run easy_install --upgrade gopem (Need root access)

Docker

• Run docker pull ecsim/gopem (Need root access)
• Configuration :
  • Ubuntu 16.04
  • Python 3.6

Exe Version (Only Windows)

• Download Installer-Version 0.6 or Portable-Version 0.6
• Run and install

⚠️ The portable build is slower to start

DMG Version (MacOS)

• Download DMG-Version 0.6
• Open DMG file
• Copy GOPEM into your system
• Run GOPEM

Exe Version Note

For GOPEM targeting Windows < 10, the user needs to take special care to include the Visual C++ run-time .dlls: Python >=3.5 uses Visual Studio 2015 run-time, which has been renamed into “Universal CRT“ and has become part of Windows 10. For Windows Vista through Windows 8.1 there are Windows update packages, which may or may not be installed in the target-system. So you have the following options:

1. Use OPEM (Without GUI)
2. Use Source Code
3. Download and install Visual C++ Redistributable for Visual Studio 2015

System Requirements

GOPEM will likely run on a modern dual core PC. Typical configuration is:

• Dual Core CPU (2.0 Ghz+)
• 2GB of RAM

⚠️ Note that it may run on lower end equipment though good performance is not guaranteed.

Usage

GIF

Screenshot 1

Screenshot 2

• Open CMD (Windows) or Terminal (UNIX)
• Run python -m gopem or python3 -m gopem (or run GOPEM.exe)
• Wait about 4-15 seconds (depends on your system specification)
• Enter PEM cell parameters (or run standard test vectors)
• For more information about parameters visit OPEM (Open Source PEM Fuel Cell Simulation Tool)

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP! or send an email to opem@ecsim.ir.

Gitter is another option :

Dependencies

master	develop

Thanks

• PyInstaller

Cite

If you use OPEM in your research , please cite this paper :

@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}
}

Download OPEM.bib(BibTeX Format)

JOSS
Zenodo
Researchgate

License

Donate to our project

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 ;-) .

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.6 - 2020-03-16

Added

• __version__ variable

Changed

• Test system modified
• dev-requirements.txt modified
• requirements.txt modified
• Logo updated
• Icon updated
• ISSUE_TEMPLATE.md updated
• setup.py modified
• README.md modified
• build_exe.bat modified
• build_unix.sh modified

0.5 - 2019-10-28

Added

• version_check.py
• CODE_OF_CONDUCT.md
• ISSUE_TEMPLATE.md
• PULL_REQUEST_TEMPLATE.md
• build_exe.bat
• build_unix.sh
• GOPEM.iss
• Check update button
• Save plot button
• Report generating controller
• Console print controller
• PyPI package

Changed

• CONTRIBUTING.md modified
• README.md modified
• Test system modified
• Menu bug in Windows fixed
• Padulles-Amphlett model default test case bug fixed
• Docstrings modified
• Report default location bug fixed
• Icon bug fixed

0.1 - 2018-09-10

Added

• GUI and plotter
• Use same test data as OPEM lib
• Documents and README