Version 1.9

Electrification Library 1.9 is part of Modelon’s 2023.1 release. New versions of Modelon libraries are sold and distributed directly from Modelon, as well as approved resellers.

New Features and improvements

Tutorials

  • New tutorial: Thermal dynamics (part of the Getting Started tutorials)

Battery thermal management

Several additions to support thermal management use cases with batteries:

  • New examples that demonstrate different aspects of thermal management (Batteries.Experiments.Thermal).
  • All thermal cell models now have a common interface, enabling re-usable experiments that are compatible with all of them.
  • New cell experiments that include a thermal model (examples and templates in Batteries.Core.Experiments).
  • Introduced a Lumped thermal cell model that supports thermal resistance to the surface.
  • Thermal connections to the cells are now made via surface nodes instead of the core node (in CommonCell, IndividualCells, Prismatic and Cylindrical models), with a parameter for reverting to the old behaviour (core_instead_of_surface).
  • Both the IndividualCells and CommonCell thermal models now support using a separate cell model, allowing cell models to be separately parametrized and validated.
  • Improved support for separate parametrization of cell and pack mass in the Lumped thermal model.
  • Unit test examples with a single thermal cell and a pack/module (Batteries.Thermal.Cells.Experiments and Batteries.Thermal.Experiments).
  • Added summary outputs: cell heat losses, minimum cell temperature and C-rate.
  • New ActiveCooling example, demonstrating the Thermostat battery temperature controller, with external cool_request signal. This is a generalization of the old FanThermostat controller.
  • New example cell with tabular parameters and temperature dependencies (Batteries.Core.Examples.NCA).
  • It is now possible to change the temperature unit in the tabular voltage and impedance models.
  • Updates to thermal adapters for discretized cells.
  • More flexible and consistent parameters for the Lumped thermal pack model.

Batteries

  • Added summary outputs for accumulated charge and energy (e_out and Q_out).
  • Improved support for specifying tabular parameters relative to Ah instead of SoC (for example in Core.OCV.Table).
  • New basic example with battery cell imbalances (Batteries.Experiments.Imbalances.RandomCellParameters).
  • Template for importing a causal model of a battery (e.g. using FMI).
  • Batteries.Control.ContactorControl now allows starting with contactors closed without going through pre-charge.

Machines

  • New example experiment (MotorGeneratorQuadrants) demonstrating motoring and generating in all four quadrant.
  • A re-usable experiment for evaluating machine limits (LimitSweep).
  • Added options for specifying tabular torque limits relative to only speed (Table1Dw) and relative to speed and temperature (Table2DwT).
  • Added power angle summary output (phi_power) to electromagnetic AC machine models.

Software-in-the-Loop (SiL)

New examples that demonstrate SiL use cases, where controllers and plant models are imported and exported using FMI.

  • New example (ControllerImport): Import an external controller.
  • New example (PlantExport): Export a plant model with an interface for a separate controller.

Other improvements

  • Introduced protection against direct connections of the thermalPort of multiple components (more information in the Thermal chapter of the User's Guide).
  • An improved DCSeries component, for connecting e.g. battery packs in series.
  • Added the DCCurrent constant source.(
  • Improved robustness to missing ambient thermal connections.
  • Fixed parameter issues in the IndividualCells model.
  • Fixed an issue with the Nominal battery models that could lead to a division by zero error when heat losses were not enabled.
  • Fixed an invalid default parameter for maximum power in the Nominal battery model.
  • Various improvements to documentation.
  • Several minor fixes.
  • Removed several deprecated components.