TRUST is a thermalhydraulic software package for CFD simulations. It was originally designed for incompressible single-phase and Low Mach Number flows, but now also allows simulating real compressible multi-phase flows. TRUST is also being progressively ported to support GPU acceleration (NVidia/AMD).

This software is OpenSource (BSD license).

You can visit TRUST website

How to install TRUST-1.9.5 version ?

First method (git configuration)

# Check out the sources for TRUST
git clone https://github.com/cea-trust-platform/trust-code.git TRUST-1.9.5
# Move to the cloned TRUST folder
cd TRUST-1.9.5
# Download the required external packages
wget ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-1.9.5.tar
# or:
# curl ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-1.9.5.tar > externalpackages-1.9.5.tar
# or:
# wget "https://drive.usercontent.google.com/download?id=1YrG36uK5cJoQ9gHAnilJSUjfTWnFBboJ&export=download&authuser=0&confirm=t" -O externalpackages-1.9.5.tar
# Unzip the downloaded external packages folder
tar xf externalpackages-1.9.5.tar
# Have a look at the available configuration options
./configure -help
# Execute the configure script with your selected options
# At the end of configure, file env/machine.env will be created. 
# You can then edit it and some others (env/make.linux*) to change some default values.
./configure $OPTIONS

Warning: Check carefully the MPI version you want to use for parallel computing before installing the code, especially onto a HPC cluster.

Run the following command, mpicxx should be found into the bin directory of the MPI version you plan to use

type mpicxx

Second method (download a tar.gz)

# Download the sources for TRUST
wget ftp://ftp.cea.fr/pub/TRUST/TRUST/Version1.9.5/TRUST-1.9.5.tar.gz
# or:
# curl ftp://ftp.cea.fr/pub/TRUST/TRUST/Version1.9.5/TRUST-1.9.5.tar.gz > TRUST-1.9.5.tar.gz
# Unzip the downloaded folder
tar xzf TRUST-1.9.5.tar.gz
# Move to the unziped TRUST folder
cd TRUST-1.9.5
# Execute the configure script with your selected options
./configure $OPTIONS

How to install TRUST development version ?

For developers and those interested in new features only.

Warning: "next" branch may not compile or some tests fail if important developments merged...

# Check out the sources for TRUST
git clone [email protected]:cea-trust-platform/trust-code.git TRUST-next
# Move to the cloned TRUST folder
cd TRUST-next
# Checkout the developement TRUST branch
git checkout next
# Download the requested external packages
wget ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-next.tar
# or:
# curl ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-next.tar > externalpackages-next.tar
# Unzip the downloaded packages
tar xf externalpackages-next.tar
# Execute the configure script with your selected options
./configure $OPTIONS 

How to start ?

• Initializing TRUST environment

# To initialize TRUST environment
source ./env_TRUST.sh

# To initialize the TRUST python's environment (MEDCoupling, swig and ICoCo python) (TRUST should be built)
source ./env_for_python.sh

• Building TRUST sources / libraries / tools

# To build TRUST as a user application (optimized mode only)
make optim

# To build TRUST as a developer (optimized + debug modes)
make

• Useful TRUST env variables

# To go to the TRUST root directory from any location (supposing that TRUST is initialized)
cd $TRUST_ROOT

# To go to the TRUST tests directory from any location (supposing that TRUST is initialized)
cd $TRUST_TESTS

• Testing TRUST

# To check TRUST in a parallel way (more than one test case at a time)
make ctest_optim

# To check TRUST in a sequential way (one test case at a time)
make check

• Cleaning TRUST

# To clean (will delete all .o and .a of TRUST sources, inside directories or MonoDir_... directories)
make clean

#To clean TRUST's third party libraries
./configure -clean

• TRUST documentation

# To see TRUST's documentation
trust -index

You are also invited to visit the TRUST Doxygen documentation which is available here.

Quick directories description

• TRUST scripts => bin/

• Documentation files => doc/

• Environment files => env_src/ & env/

• Binaries => exec/

• Link to all TRUST include files (automatically updated) => include/

• Libraries => ThirdPart/ & lib/

• TRUST sources => src/

• TRUST tests => tests/

• Tools to build TRUST => Outils/

• Location of Validation forms => Validation/

Quick files description

• README.md => This file

• env_TRUST.sh => Script loading TRUST environment

• env_for_python.sh => TRUST python tools initialization script

• RELEASE_NOTES => Release notes (manually and regulary updated by support)

• DEVELOPER_NOTES => Developer notes (manually and regulary updated by support)

• Makefile => List of targets to build the code

• ToDo => List of tasks to do

• configure => configure script

• index.html => Index description (gives access to documentation, tutorials, ...)

• license => TRUST and third party licences

Thermo-Physical Properties interface

TRUST offers a generic interface that can be used to calculate thermo-physical properties (useful for multi-phase flows). For that, two external libraries can be used:

• CoolProp (open source http://www.coolprop.org/)

• EOS (only for CEA agents and requires permission)

CoolProp

CoolProp is an open source (MIT License) library useful to compute thermo-physical properties for the masses.

A pre-compiled static library of CoolProp is mandatory if a TRUST user wants to use its interface via TRUST. Warning: On a cluster, if you want to install TRUST with CoolProp, you should install both with the same compilers. Here are the steps that can be followed to obtain a libcoolprop.a

# Get the sources archive (version 6.6.0)
wget https://sourceforge.net/projects/coolprop/files/CoolProp/6.6.0/source/CoolProp_sources.zip
unzip CoolProp_sources.zip
mv source CoolProp
# or download CoolProp (attention recursive, beta version that may have issues with TRUST !!!)
git clone https://github.com/CoolProp/CoolProp --recursive
# Move into the folder you just created
cd CoolProp
# Make a build folder
mkdir -p build && cd build
# Build the makefile using CMake
cmake .. -DCOOLPROP_STATIC_LIBRARY=ON -DCOOLPROP_FPIC=ON
# Make the static library
cmake --build .
# Instead, you can do : make -j all ...

Once done, you need to configure TRUST with the following (maybe additional) option

./configure $OPTIONS -with-coolprop=YOUR_PATH_COOLPROP
make

This configure with make it also possible to access CoolProp via a python module. You can try it

source env_TRUST.sh
python
from CoolProp.CoolProp import PropsSI

ATTENTION: YOUR_PATH_COOLPROP is the path towards the cloned CoolProp repository and not the build. It is recommended to verify first that the folder include exists in YOUR_PATH_COOLPROP and that the library libCoolProp.a exists in YOUR_PATH_COOLPROP/build.

Note: It is possible to call REFPROP via the TRUST CoolProp interface. However, this requires a license and a well built shared library of REFPROP. In this case, you need to configure TRUST with the following (maybe additional) option

./configure $OPTIONS -with-refprop=YOUR_PATH_REFPROP
make

Here, YOUR_PATH_REFPROP is the path towards the shared library of REFPROP.