# Nemo modelfactors
The project was developed and tested using NEMO 4.2 version.

This project is intended to compute important performance metrics for a NEMO run.

The statistic produced is focusing on the timestep loop, so these numbers are not related to the initialization and finalization parts.

# Installation and requeriments

This script relies on the following tools:
 
* *Extrae (4.0.0 or above)* 
* *Paraver*
* *Dimemas (latest has a bug use 5.4.2-devel instead)* 
* *Basicanalysis* 

*They can be downloaded at https://tools.bsc.es/downloads* and need to be installed, loaded and available through the PATH environment variable.

Here the list of the modules that need to be loaded before the script execution.

* Perl interpreter.
* Fortran compiler (ifort, gfortran, pgfortran, ftn, …),
* Message Passing Interface (MPI) implementation (e.g. OpenMPI or MPICH).
* Network Common Data Form (NetCDF) library with its underlying Hierarchical Data Form (HDF).


# Usage

* Clone this repository wherever you please.
* Don't move the content of the repository outside , the sub-modules won't load and the script will fail. If you want you can init the sub-modules manually with `git submodule update --init` and then move the content.
* ***Edit the file perf_metrics.config and replace the parameters values with the suited information.*** 
* ***MINIMUM CHANGES perf_metrics.config:***
	* Nemo_path, change the value to the path were NEMO is installed in your machine.
	* Nemo_input_data, change the value to the path were the input data for the configuration is downloaded.
	* Compilation_arch, replace the value with the name of the arch file that you use to compile NEMO.
	* Modules, change the value to suit the name of the modules you need to load.
	* Jobs_scheduler, replace the value with the name of the scheduler installed in your machine (currently supports slurm, lsf and torque)
* Execute perf_metrics.bash 
```
./perf_metrics.bash
```
* If the script executes without problems the data will be by default ready inside ../Output/Metrics folder. The Output dir path can be changed at perf_metrics.config.