LUCIA tool can be used to evaluate the load balance among components of Earth System Models which are coupled using OASIS. This tool can obtain the interpolation and communication/waiting time of each component separately.
In $(OASIS_DIR)/oasis3-mct/util/lucia, compile main-lucia.F90 :
specify your compiler by modifying “F90=my_compiler” in “lucia” script file
Simulation set up
Before launching your OASIS coupled model, modify your “namcouple” file: the second number on the line below $NLOGPRT must be set to -1. This option enables the production of OASIS-LUCIA log files, named “lucia.MM.PPPPP”, with “MM” executable number and “PPPPP” MPI process number in local communicator. It is not possible to produce timer log files at the same time that lucia log files.
In your results directory (where executable and model output are located), post-treat the files produced by OASIS-LUCIA log files:
This command will post-treat the OASIS-LUCIA log files located in the directory using lucia.exe
Several information related to the coupled simulation are provided on standard output:
For performance reasons (ASCII file reading), LUCIA do not process all OASIS-LUCIA log files, but only a subset, displayed below the comment line “Computed log files for model MM”
This information is displayed below the comment line “Exchanged fields (based on first exchange)”
For each model, LUCIA gives the total time spent during calculations, the total time spent to wait information from OASIS and the number of coupling time step used to calculate those values. Time is in seconds. Information is displayed below the comment line “Component - Calculations - Waiting time (s) - # cpl step ”
LUCIA also provides, for each model, the total time spent to perform OASIS interpolations during simulation, and total process jitter measured at each OASIS send/receive steps. This information is displayed below the comment line “Additional informations”.
This tool was developped by Eric Maisonnave (CERFACS), Uwe Fladrich, Martin Evaldsson (SMHI) and Arnaud Caubel (IPSL) to perform an analysis of the coupled components load balance
For more details about lucia, see the document: http://www.cerfacs.fr/globc/publication/technicalreport/2014/lucia_documentation.pdf