Skip to content

Installation

Prerequisites

Ensure you have the following before proceeding:

  • MATLAB installed (version 2023b or newer).
  • Access to Simulink and Simscape toolboxes.
  • Breathe Model files downloaded. Unzip the Breathe Model folder to a convenient location on your computer.

Installation steps

There are two main approaches:

  1. Add the entire Breathe Model folder to the MATLAB Path:

    • Open MATLAB.
    • In MATLAB's toolbar, select Home > Set Path.
    • Click Add with Subfolders, navigate to the location where you have downloaded the Breathe Model folder, and select it.
    • Confirm by clicking Save and then Close.

  2. Run the Setup Script:

    • Navigate to the downloaded Breathe_Model_Library folder.
    • Open the addLibraryToPath.m file and click Run on the MATLAB toolbar.

This will ensure the library files are correctly configured and ready to use.

Verifying your installation

  1. Open MATLAB.
  2. In MATLAB, click the Simulink button (usually in the toolbar).
    • This will open the Simulink environment.
  3. In the Simulink window, select Library Browser (e.g., via the Simulink toolbar or by typing simulink and then clicking "Library Browser").
    • If you still don't see your custom library, press F5 or click the Refresh icon to update the list.

The installation is successful if you find the following blocks within the newly available Breathe_Model_Library:

  • Breathe Model: The primary model block used for the simulation of battery electrochemical and thermodynamic behaviour.
  • Electrical Source: Provides prescribed electrical conditions such as current, voltage, or power.
  • Battery Cycler: Simulates charge, discharge and rest sequences typically used in battery testing scenarios.
  • DCIR Cycler: Enables simulation of Direct Current Internal Resistance (DCIR) test protocols, useful for evaluating battery resistance and health.

Note You can easily include any of the Breathe model library components by double clicking on a blank space of Simulink file and by start typing the name of the Breathe Model Library block that you need.

With these blocks available, your Breathe Model library installation is confirmed and ready for use. You can learn more about what these blocks are and how they work in the Included Components pages and Creating a Simulation.