Fuel Cell Library - Release Information

Version 1.5 was released 2017-06-02.

Version 1.5 of the Fuel Cell library has focused on improving the user-friendliness. The newrelease has extended the capabilities of the composition visualizers to enable the option to show flow per species including both mass and mole based units. With this newfunctionality, it is easy to get an overview of the flow streams in the system. This is especially useful when visualizing diffusion flow through a membrane. There has also been
a big improvement on the examples where a large part of the examples visualize system performance indicators such as fuel utilization, heat release and temperature and concentration profiles. This makes it easy to quickly get an overview of the system characteristics.

Examples of improvements and new features:

  • Flow substance visualizers to show the flow composition in terms of mass and mole fractions. A user can conveniently switch between flow or fraction sensor types where both mass and mole based units are supported.
  • Predefined preferential oxidation reactor with a new output variable for the CO concentration in ppm. This makes it easy to directly compare against CO limits that are specified in ppm.
  • Example models that visualize important system indicators, to quickly get an overview of the system characteristics
  • Top-level propagation of composition design parameters in DesignProx model.

Conversion of user libraries:
No conversion is needed.

Version 1.4 of the FuelCell library comes with many new features and improvements. Highlights include new numerically robust and accurate reaction and reformer models for city gas, longitudinal cell material heat conduction option and mass and atom conservation checkers. The library has also seen several new features and improvements that make the usage more user-friendly and intuitive which makes it easier to get started with the modeling. The parameter user interface including parameter dialogs, diagram layer, examples and documentation has seen a major upgrade including new instruction on connection principles to guide the user to set up robust and efficient models. With the new visualizer components it is also easier to get an overview of the system states including flow, pressure, temperature and composition.

New features


  • New steam reforming reaction model for city gas: FuelCell.Reactions.DynamicCityGasReforming. With this reaction model it is possible to model reactions of heavier hydrocarbon such as Ethane, Propane and Butane (C2H6, C3H8, nC4H10 and iC4H10)
  • New city gas reformer component: FuelCell.Reactors.Reformers.DynamicCityGasReformer. This is a reformer model that is adapted to the new reforming reaction model for city gas.
  • New discretized reaction channel template: FuelCell.Reactors.Templates.DistributedDynamicReactor. This discretized pipe model with an integrated dynamic wall can be used as a base component to model complex customized heat interactions.
  • New discretized reformer component: FuelCell.Reactors.Reformers.DistributedDynamicReformer
  • New sensors that collect mass flow rate, pressure: temperature, specific enthalpy and mass/mole fractions simultaneously. This makes it easier to get a graphical overview of the states of the system which is particularly useful for larger system models.
  • New visualizers to show the flow composition in terms of mass and mole fractions.
  • New option to include heat conduction in the cell material along the flow direction. When activated this option can give more accurate description of the stack temperature distribution at large temperature gradients.
  • New models to check mass conservation of each element. The user can now in a user-friendly way verify that the mass balance is correct.



  • Enhanced the robustness of the dynamic (quasi-equilibrium) reaction models
  • Made the calculation of Gibbs energy of reaction independent of the reference temperature chosen in the Medium model
  • Restructured the Burners package and the Reactions package
  • Improved the user interfaces (parameter dialogs, diagram layer and etc.) of the library
  • Added visualizers and summary records in example models for easy access to key variables
  • Added instructions on connection principles for building numerically robust models
  • Improved documetation of various component models
  • Removed obsolete models

Fixed bugs


  • Corrected issues with Gibbs free energy calculation in the simplified SOFC membrane model.

New classes


  • FuelCell.Burners.Interfaces.Burner
  • FuelCell.Internal.Conservation.CheckMassBalanceVolume
  • FuelCell.Internal.Conservation.CheckMassBalanceStack
  • FuelCell.Internal.Conservation.CheckMassBalanceSystem
  • FuelCell.Reactions.Templates.DynamicReactionCityGasBase
  • FuelCell.Reactions.DynamicCityGasReforming
  • FuelCell.Reactors.Templates.DistributedDynamicReactor
  • FuelCell.Reactors.Reformers.DistributedDynamicReformer
  • FuelCell.Reactors.Reformers.DynamicCityGasReformer
  • FuelCell.Reactors.Experiments.TestCityGasReformer
  • FuelCell.Reactors.Experiments.TestDistributedDynamicReformer
  • FuelCell.Sensors.AirCompositionDisplay
  • FuelCell.Sensors.ReformateCompositionDisplay
  • FuelCell.Sensors.ReformateLongCompositionDisplay
  • FuelCell.Sensors.MultiDisplay_phTmdot
  • FuelCell.Sensors.CondensingGasMultiDisplaySensor
  • FuelCell.Sensors.GasMultiDisplaySensor
  • FuelCell.Sensors.WaterMultiDisplaySensor
  • FuelCell.Sensors.Examples.MultiDisplay
  • FuelCell.SubComponents.ComponentSummaries.PEMFCSystemSummary

Conversion of user libraries

Automatic conversion of user libraries from version 1.3.3 is supported using the included conversion script convertFCL_1.3.3_to_1.4.mos located under FuelCell/Resources/Scripts.


Fuel Cell Library 1.4 is based on Modelon Base Library 2.5 and Modelica Standard Library 3.2.2.

New features

  • New media was added FuelCell.Media.PreDefined.IdealGases.FastCityGas and FuelCell.Media.PreDefined.IdealGases.NASACityGas
  • New component FuelCell.Sensors


  • The documentation has been improved

New classes

  • FuelCell.Media.PreDefined.IdealGases.FastCityGas
  • FuelCell.Media.PreDefined.IdealGases.NASACityGas

Conversion of user libraries

Automatic conversion of user libraries from version 1.3 is supported using the included conversion script Convert_to_1_3_1 located under FuelCell/Resources/Scripts.


Fuel Cell Library 1.3.3 is based on Modelon Base Library 2.4 and Modelica Standard Library 3.2.2.

The library has been tested with:

  • Dymola 2016
  • Dymola 2016FD01
  • Dymola 2017

Release notes for version 1.3.2 of the Fuel Cell Library. This is a maintenance release. Previous library version was 1.3.1

Conversion of user libraries

No conversion is needed for this release.

Library dependencies

Fuel Cell Library 1.3.2 is based on Modelon Base Library 2.3 and Modelica Standard Library 3.2.1.

The library has been tested with:

  • Dymola 2016 FD01
  • Dymola 2016

Available for: Dymola 2016

Dependencies: Modelon Base Library 2.0


  • Improved structure of FuelCell.Media.ReactionGas.ReactionProperties for increased readability. p, T, and X are now inputs.
  • Added possibility to parameterize flow and temperature boundaries in
  • FuelCell.Sources with enthalpy instead of temperature. Default behavior is the same as in earlier versions, i.e. parameterization with temperature.
  • The Index record is no longer part of FuelCell.Media.Templates.ReactionGas, it is replaced by the use of the substanceIndexVector function in media.
  • Moved gibbsReactionEnergy function to ReactionGas template.
  • Improved Modelica compliance.

Conversion of user libraries

  • Automatic conversion of user libraries from version 1.3 is supported using the included conversion script.




Available for: Dymola 2015 and 2015 FD01

Dependencies: Modelon Base Library 2.1

New Features:

  • Manifold structure with support for both external and internal manifolds. Predefined manifolds with inlet/outlet at the top, bottom or in the middle of the stack.
  • New manifold structure implemented in the FullStack template. The template now allows for modeling of different flow configurations: U-flow, Z-flow, Mid-flow, equally distributed flows or combinations.
  • New example: SOFC system with energy recovery (micro-gas turbine)


  • Pump model based on pump from the Modelon Base library added.
  • Support for both co-flow and counter flow in FullStack template
  • Support for stack insulation in FullStack template
  • Added new predefined media: steam (H2O) hydrogen mixture both as ideal gas (in NASA and Fast representation) and as ideal gas with condensated mass fraction of water.
  • SOFC system examples now uses FastMedia with linear cp instead of NASA media to avoid nonlinear systems of equations and improve simulation speed.
  • ReactionChannel updated to work with the updated channel interface from Modelon.ThermoFluid.
  • Added parameter frictionDistribution to ReactionChannel. The option can be used to control the type of model exposed in the fluid connector and facilitates creation of numerically sound system models with alternating control volume and flow resistance models.
  • Removed SimpleManifold as a consequence of the new manifold structure. Replaced by the new external manifold.
  • Elaborated Tutorial section
  • New icons (library, stack, manifolds etc.)
  • Improved Modelica compliance

Conversion of user libraries

  • Automatic conversion of user libraries from version 1.2.1 is supported using the included conversion script Convert_to_1_3.

Available for: Dymola 2014 FD01

Dependencies: Modelica Standard Library Version: 3.2.1 and Modelon Base Library 1.9

Conversion: None since version 1.2 is the first official release of the Fuel Cell Library.

  • The Fuel Cell Library is targeted towards modeling, analysis and control development of fuel-cell systems
  • The library contains predefined reactors for fuel preprocessing and internal reforming, and predefined stack structures for both Solid Oxide (SOFC) and Proton Exchange Membrane (PEMFC) fuel cells. 
  • Easy to adapt stack and reactor templates to new structures 
  • Solid oxide fuel cells (SOFC) and Proton exchange membrane fuel cells (PEMFC) models
  • Predefined reactors for fuel pre-processing and internal stack reforming 
  • Reactions calculated by various approaches 
  • Handles reformate and other ideal gas mixtures 
  • Support for condensation 


Available for: Dymola 2014 and MapleSim 6.2

Dependencies: Modelica Standard Library Version: 3.2 and Modelon Base Library 1.8

Conversion script from 3.2.1 to 3.3.X is included

  • Hydraulics 3.3.2 is a minor release with the following improvements and bug fixes.
  • Improved the power steering example
  • Added a hydraulic damper example
  • Scaling improvements for regRoot in Hydraulics/Elements
  • General improvements in the library for cross platform compatibility
  • Some parts of the library documentation were unintentionally hidden