Usage

Directly interfacing with the binary

To run tomcat, an input file specifying the parameters needs to be passed, an example input file is found in the “input_files” folder titled “Input_TestModBC”, an explanation of the input file can be found in Input, copying this over to a directory in which you’ll run the simulation (here tomator_sim), tomcat can be run as (assuming you have installed tomcat, if not the same can be done calling the executable):

~/Documents/tomcat_sim ❯ tomcat < Input_TestModBC > Output_TestModBC

This should run tomcat, generating multiple files in the folder titled e.g fort.23, fort.60,… an Output_TestModBC file, a TimeOfRun.dat file and and Input_PrepPlotCD_self_generated.dat file, this last file may be passed to tomcat_currentdrive to calculate the aspects of current drive:

~/Documents/tomcat_sim ❯ tomcat_currentdrive < Input_PrePlotCD_self_generated.dat > Output_PrePlotCD

This then creates more fort.* files and the files CurrentDrive_Main_Output.dat, CurrentDrive_Output4Ernesto.dat, CurrentsFile and Output_PrePlotCD.

On how to interpret these results, please refer to Interpretation.

Using a pre-made bash script

In the scripts folder a script called “run_tomcat” is located, this automatically performs the commands mentioned in the previous subsection, as well as plot the results using gnuplot and automatically generates a report in a pdf file.