Installation

Cloning & Building

Tomcat is designed to be ran on unix-like machines such as linux-based OSes and macos. To install tomcat, start by cloning the repository to a location you’d like:

~/Programs ❯ git clone https://github.com/LPP-ERM-KMS/tomcat.git

In the src folder, the folder BLAS holds an old version of BLAS which tomcat leverages, the makefile assumes you have gfortran installed, if this is not the case change the FORTRAN variable in make.inc. Compile BLAS by navigating into the folder and calling make:

~/Programs/tomcat/src/BLAS ❯ make

Having compiled blas, a file called libblas_TOMCAT_git.a should have been created. Now it is time to compile tomcat, tomcat is a series of fortran codes located in the folder “fortran_sources”. For a simple compilation, if you have gfortran installed a compilation script is located in the “scripts” folder:

~/Programs/tomcat/src/scripts ❯ ./compile_tomcat

This script can be modified to use a compiler of choosing, this compilation will create two executables in the “build” folder, one titled “tomcat” and one titled “tomcat_currentdrive” which represent two distinct functionalities of tomcat which are explained in Usage. Installation is not strictly necessary as the binary can be ran as is but for those interested:

Installing the binary

Having built tomcat it can be installed by adding the “build” folder to PATH, for example by adding:

export PATH="~/Programs/tomcat/src/build:$PATH"

to bashrc or by copying the executables to a location already in PATH like /usr/bin on linux devices.

You may now move on to Input.