EL 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.
  • 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).
  • Less obstructing default limits in core machine models.
  • 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.