TRACMASS is written in FORTRAN 90 with modules and runs on UNIX platforms such as MAC OS X and Linux. For certain configurations netCDF libraries are also required.
1. Download the code
git clone https://github.com/TRACMASS/Tracmass.git
2. Enter the TRACMASS directory
cd Tracmass
3. Modify the Makefile.proj to fit your system. You will need to set ARCH, which is the name of your system. If you are running simulations on a High-Performance Computing (HPC) system, such as tetralith, ARCH needs to be set to 'tetralith'. For other operating systems, such as Windows, macOS and general Linux, leave it blank. You will also need to configure how TRACMASS should find the netCDF libraries, if at all. For most systems, we recommend the option 'automatic-44'.
Make sure in Makefile both PROJECT and CASE are set to 'Theoretical'. In this case, TRACMASS will use a simple oscillating velocity field to trace trajectories, which is recomended for the first run to ensure the model downloaded sucessfully. Once all the changes have been made, the first few lines of Makefile.prj should look like this on Linux type operating system:
#================================================================
# TRACMASS MAKEFILE
#================================================================
# Project and case definition
PROJECT = Theoretical
CASE = Theoretical
RUNFILE = runtracmass
ARCH =
NETCDFLIBS = automatic-44
#================================================================
The Makefile.prj does not need quatation marks (" ") or apastrohpies (' ') for setting its variables.
4. Then you can run the make command in the terminal where the Makefile.prj is located.
make
This will compile the TRACMASS code and the final line of the terminal output should be:
...
cp projects/Theoretical/namelist_Theoretical.in namelist.in
This indicates that the compilation has been sucessful.
5. Finally, you can run the code
./runtracmass
If everything went without an error, you will get the following output in the terminal:
===============================================================================
TRACMASS Lagrangian off-line particle tracking
===============================================================================
Start date : 2020-06-30
Start time : 20:57:55
-------------------------------------------------------------------------------
Model information:
Project code : Theoretical
Case name : Theoretical
Namelist file : projects/Theoretical/namelist_Theoretical.in
-------------------------------------------------------------------------------
Output information:
Directory for output files : /Users/user/Tracmass_output
Prefix for output files : test
-------------------------------------------------------------------------------
Configuration options:
- Two-dimensional trajectories, no change in depth
-------------------------------------------------------------------------------
Start date in model-time : 2000-01-01 12:00
End date in model-time : 2000-01-01 21:00
Length of run in timesteps : 10
Number of seeding timesteps : 1
Steps between two GCM fields : 100
-------------------------------------------------------------------------------
t-step run out err tot model date
-------------------------------------------------------------------------------
1 | 1 | 0 | 0 | 1 | 2000-01-01 12:00:00
2 | 1 | 0 | 0 | 1 | 2000-01-01 13:00:00
3 | 1 | 0 | 0 | 1 | 2000-01-01 14:00:00
4 | 1 | 0 | 0 | 1 | 2000-01-01 15:00:00
5 | 1 | 0 | 0 | 1 | 2000-01-01 16:00:00
6 | 1 | 0 | 0 | 1 | 2000-01-01 17:00:00
7 | 1 | 0 | 0 | 1 | 2000-01-01 18:00:00
8 | 1 | 0 | 0 | 1 | 2000-01-01 19:00:00
9 | 1 | 0 | 0 | 1 | 2000-01-01 20:00:00
10 | 1 | 0 | 0 | 1 | 2000-01-01 21:00:00
===============================================================================
1 particles calculated
0 particles exited the space and time domain
0 particles flagged with errors
1 particles in domain
-------------------------------------------------------------------------------
===============================================================================
End date : 2020-06-30
End time : 20:57:55
===============================================================================
After this, you can try to make changes by yourself in the namelist file or jump into one of our TRACMASS Tutorials to better learn the hang of the software!