Changes between Version 2 and Version 3 of Doc/Tools/OpenTrusting

Timestamp:

12/01/23 12:23:56 (7 months ago)

Author:

jgipsl

Comment:

--

Doc/Tools/OpenTrusting

@@ -1 +1 @@
 
-== IPSLCM6.2 Open Trusting How-To ==
+== IPSLCM6.2 Open Trusting ==
 
-
+### How to run the Open Trusting ###
 1) At Irene, copy file {{{/${PATH_TO_BE_REQUESTED}/TRUSTING/IPSLCM6.2/SCRIPT/MYLAUNCH}}} into the personal directory of your choice.
 The root path is to be requested to the IPSL engineers responsible for the trusting operations, either J. Ghattas or T. Lurton.
-For JeanZay, the child directory remains the same, with another root path, likewise to be asked for.
+For !JeanZay, the child directory remains the same, with another root path, likewise to be asked for.
 
 2) Customise your own {{{MYLAUNCH}}} executable file:
@@ -14 +14 @@
         {{{prod}}}: launches standard trusting;
         {{{test}}}: allows a 5-minute break before the model extraction to be able to modify revisions specified in mod.def. Also sleeps for 5 minutes before compilation, if any source code modifications are needed.
-        {{{continue}}}: picks up things where they were in case of a failure in compilation or execution;
+        {{{continue}}}: continues by launching experiments in a previous trusting, see more information below;
         {{{check}}}: just performs a check of the last trusting you ran.
 
@@ -29 +29 @@
 
 {{{> ./MYLAUNCH}}}
+
+### How to understand the results ###
+You'll find a file called trusting_summary.txt in the local run directory for your trusting. It contains a summary of the results from the different experiments that were launched.
+
+### Option mode=check ###
+This option can be set in MYLAUNCH to re-run the control of the result from the previous open trusting that was launched locally. This is often necessary if the machine is too busy so the jobs had to wait to long in queue. The file trusting_summary.txt will be overwritten with the new results.
+
+### Option mode=continue ###
+This option can be set in MYLAUNCH. It'll work on the last trusting, as option check. Compilation must have been done previously. If one or several of the experiment folders trustXXX are missing, the trusting will launch them again.
+
+This option is usefull for example if you want to make your experiements again but changing something in the set up, in GENERAL or EXPERIMENT folders. For that case, remove first all output created in IGCM_OUT done by the last trusting you did (a specific ExperimentName is used for each run folder of a trusting). Then remove the experiment folders trustXXX found in modipsl/config/IPSLCM6 . Now launch again MYLAUNCH as before but setting mode=continue.