Encapsulated LTES models

This repository contains the models for encapsulated latent energy storage (LTES) from the article:

F. Brosa Planella, A simple model for latent thermal energy storage systems with encapsulated phase-change material, International Journal of Heat and Mass Transfer 239 (2025) 126533.

To reproduce the results from the article, run the examples in the examples directory. The notebook validate_Nallusamy_et_al.ipynb compares the models with the experimental data from the Nallusamy et al (2007) article, while the script mesh_refinement.py runs a convergence study on the model. The figures are saved in the figures directory.

🚀 Installing the package

The package is not yet available on PyPI so it needs to be installed from the source code. These instructions assume that you have a compatible Python version installed (between 3.9 and 3.12).

Linux and macOS

First clone the repository, either from the command line or using a Git client:

git clone git@github.com:mmsg-warwick/encapsulated-LTES.git

If you do not have nox installed, install it with

python3 -m pip install nox

Then, navigate to the repository you just cloned and run

nox -s dev

This will create a virtual environment called venv in your current directory and install the package in editable mode with all the development dependencies. To activate the virtual environment, run

source env/bin/activate

You can now run the examples in the examples directory.

If needed, you can deactivate your virtual environment with

deactivate

Windows

First clone the repository, either from the command line or using a Git client:

git clone git@github.com:mmsg-warwick/encapsulated-LTES.git

If you do not have nox installed, install it with

python3 -m pip install nox

Then, navigate to the repository you just cloned and run

nox -s dev

This will create a virtual environment called venv in your current directory and install the package in editable mode with all the development dependencies. To activate the virtual environment, run

venv\Scripts\activate.bat

if you are using Command Prompt, or

venv\Scripts\Activate.ps1

if you are using PowerShell.

You can now run the examples in the examples directory.

If needed, you can deactivate your virtual environment with

deactivate