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
# Check out the sources for TRUST git clone https://github.com/cea-trust-platform/trust-code.git TRUST-1.9.6 # Move to the cloned TRUST folder cd TRUST-1.9.6 # Download the required external packages wget ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-1.9.6.tar # or: # curl ftp://ftp.cea.fr/pub/TRUST/externalpackages/externalpackages-1.9.6.tar > externalpackages-1.9.6.tar # or: # wget "https://drive.usercontent.google.com/download?id=1LAbrUO0at7eN_nwg28F92SF4SS_Qw4K5&export=download&authuser=4&confirm=t" -O externalpackages-1.9.6.tar # Unzip the downloaded external packages folder tar xf externalpackages-1.9.6.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 $OPTIONSWarning: 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# Download the sources for TRUST wget ftp://ftp.cea.fr/pub/TRUST/TRUST/Version1.9.6/TRUST-1.9.6.tar.gz # or: # curl ftp://ftp.cea.fr/pub/TRUST/TRUST/Version1.9.6/TRUST-1.9.6.tar.gz > TRUST-1.9.6.tar.gz # Unzip the downloaded folder tar xzf TRUST-1.9.6.tar.gz # Move to the unziped TRUST folder cd TRUST-1.9.6 # Execute the configure script with your selected options ./configure $OPTIONSFor 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 git@github.com: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 - 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 -indexYou are also invited to visit the TRUST Doxygen documentation which is available here.
-
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/
-
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
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 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 makeThis 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 PropsSIATTENTION: 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 makeHere, YOUR_PATH_REFPROP is the path towards the shared library of REFPROP.