RESTART MODE for GAIA like in TELEMAC-2D and TELEMAC-3D

[gaia] RESTART MODE for GAIA like in TELEMAC-2D and TELEMAC-3D First part

Partially closes #899 and #756 (closed)

Major improvements:

• automatic saving of variables in the RESTART FILE necessary to continue a GAIA computation at the wished records and not every graphic printout,
• as necessary variables are not saved in the RESULT FILE anymore (in particular at every graphic printout), this last file is smaller in size (e.g. with CO sediments),
• no loss of accuracy when continuing a computation.

New keywords:

• RECORD NUMBER FOR RESTART,
• RESTART MODE,
• RESTART FILE,
• RESTART FILE FORMAT,
• RESTART FILE PRINTOUT PERIOD,
• RECORD NUMBER IN RESTART FILE.

Examples:

• mud_conservation-t2d,
• yen-t2d (multi 1),
• littoral-t2d-tom (triple coupling).

Some reference files have been updated (due to less stored variables):

• flume_bc-t2d (coh),
• hippodrome-t2d (1COs, 1COs_vf),
• hippodrome-t3d (1CO + 4NCObs_4CO_consolidation),
• mud_conservation-t2d,
• rouse-t3d,
• tidal_flats-t3d.

NB: some continuations of computation are not currently perfect and need to be investigated (coupling TELEMAC-3D, CVSM...)

added module:gaia type:feature labels

requested review from @sara.pavan

assigned to @chi-tuan.pham

added 18 commits

• 25b1a81d - 1 commit from branch main
• 25b1a81d...0ca78fbc - 7 earlier commits
• c682228c - [VnV][gaia] Update a few GAIA reference files after restart GAIA feature
• e87fe3e3 - [VnV][gaia] Update a few epsilons for hippodrome-t3d example
• f4939c5f - [src][gaia] Remove COMPRST variable as not used
• 31e27ac7 - [VnV][gaia] Update a few GAIA reference files after restart GAIA feature
• a052c2f7 - [VnV][gaia] Add restart example for mud_conservation-t2d
• 14ee0149 - [VnV][gaia] Add restart example for yen multi1
• a343f31b - [VnV][gaia] Add restart example for littoral-t2d-tom
• 1e0499b7 - [doc][gaia] Add RESTART MODE feature in the GAIA user manual
• d6a7e519 - [dico][gaia] Good name of keyword PREVIOUS SEDIMENTOLOGICAL COMPUTATION FILE
• 01ed8c7d - [doc][gaia] Cosmetics + move 1 line

Compare with previous version

added 19 commits

• 01ed8c7d...bbc4b53a - 5 commits from branch main
• bbc4b53a...81349649 - 4 earlier commits
• 1d45e547 - [VnV][gaia] Update a few GAIA reference files after restart GAIA feature
• c73edda4 - [VnV][gaia] Update a few epsilons for hippodrome-t3d example
• 52a0a1cc - [src][gaia] Remove COMPRST variable as not used
• 35293351 - [VnV][gaia] Update a few GAIA reference files after restart GAIA feature
• 50b3aa56 - [VnV][gaia] Add restart example for mud_conservation-t2d
• e786aa28 - [VnV][gaia] Add restart example for yen multi1
• 9ea1b9ae - [VnV][gaia] Add restart example for littoral-t2d-tom
• 8d507ee6 - [doc][gaia] Add RESTART MODE feature in the GAIA user manual
• 30eb0718 - [dico][gaia] Good name of keyword PREVIOUS SEDIMENTOLOGICAL COMPUTATION FILE
• 51d102c2 - [doc][gaia] Cosmetics + move 1 line

Compare with previous version

changed the description

Dear Chi-Tuân,
here below some additional questions and comments.
RECORD NUMBER FOR RESTART: can you please confirm me that this keyword is an improvement also for the classic way to continue a computation?
Is it possible to list the major improvements with respect to the classic way to continue a computation (e.g. for CO sediments results file are now smaller in size,...)?
Once the branch merged, I suggest you to create a new issue about restart that states which test cases are not working (in order to not forget to complete/generalize this feature) - even if this will be written in documentation, as well as in the old issue that will be closed.
Some final suggestions for the commit message (not the message itself but the details that can be added below the message): short explanation about the fact that some reference files are changed; do not forget to list the new keywords.
Thanks,
Sara

About modifications to tex files, I didn't check the column number (<80).

added 1 commit

• f810ab26 - Apply 1 suggestion(s) to 1 file(s)

Compare with previous version

added 1 commit

• 57fd44ea - Apply 1 suggestion(s) to 1 file(s)

Compare with previous version

added 1 commit

• 838e1cad - Apply 1 suggestion(s) to 1 file(s)

Compare with previous version