Changeset 3349 for trunk/LMDZ.COMMON/libf/evolution/deftank/README

Timestamp:

May 31, 2024, 10:46:55 AM (6 months ago)

Author:

jbclement

Message:

PEM:
New script called "launchPEM.sh" to launch a chained simulation of PCM/PEM runs:

• It is far more efficient since it submits a cycle of PCM/PEM dependent jobs waiting in the SLURM queue. Plus, it does not involve a endless running master script;
• It is more robust and user-friendly since it holds lots of warning/error messages handling different situations. It can take arguments to adapt to the needs of the user. It also creates automotically a script called "kill_launchPEM.sh" to cancel all the current dependent jobs.

There are 3 other files to make it work:

• "lib_launchPEM.sh" which is the library containing the bash functions used by the script;
• "jobPCM.slurm" which is the SLURM job script for the PCM used as a template by the script;
• "jobPEM.slurm" which is the SLURM job script for the PEM used as a template by the script.

More info in the "README" of the deftank.
JBC

File:

• trunk/LMDZ.COMMON/libf/evolution/deftank/README (modified) (2 diffs)

trunk/LMDZ.COMMON/libf/evolution/deftank/README

@@ -1 +1 @@
 This folder contains all the files needed to run the Planetary Evolution Model (PEM).
 
-# launch_pem.sh:
+# launchPEM.sh:
   Bash script file to launch the chained simulation of PEM and PCM runs.
   The user has to specify:
       (i)   n_mars_years, n_earth_years -> the number of Mars/Earth years to be simulated in total;
-      (ii)  nPCM -> the number of PCM calls between PEM runs (usually nPCM=2);
-      (iii) exePEM -> the name of executable file for the PEM run;
-      (iv)  exeReshape -> the name of executable file for the data reshaping task with XIOS.
+      (ii)  nPCM_ini -> the number of initial PCM runs (at least 2);
+      (iii) nPCM -> the number of PCM runs between each PEM run (usually 2).
+  The script can take an argument:
+      - If there is no argument, then the script initiates a PEM simulation from scratch.
+      - If the argument is 're', then the script relaunches an existing PEM simulation. It will ask for parameters to know the starting point that you want to. 
+
+# liblaunchPEM.sh:
+  Library of bash functions used by the PEM launching script "launchPEM.sh".
+
+# jobPCM.slurm:
+  Bash script file to run the PCM with a SLURM job. The name of the PCM executable file should be adapted. The header corresponds to the ADASTRA supercomputer and should be changed for other machines.
   The path to source the arch file should be adapted to the machine.
 
-# exePCM.sh:
-  Bash script file to run the PCM with a SLURM job. The name of the PCM executable file should be adapted. The header corresponds to the ADASTRA supercomputer and should be changed for other machines.
+# jobPEM.slurm:
+  Bash script file to run the PEM with a SLURM job. The name of the PEM executable file and Reshaping executable file should be adapted. The header corresponds to the ADASTRA supercomputer and should be changed for other machines.
+  The path to source the arch file should be adapted to the machine.
 
 # run_PEM.def
@@ -23 +32 @@
   Bash script file to modify orbital parameters in the file "startfi.nc" (obliquity, eccentricity, Ls perihelion and possibly initial Ls). They should be consistent with Laskar's data in "obl_ecc_lsp.asc" to start a chained simulation at a specific date.
 
+# modify_startfi_var.sh:
+  Bash script file to modify the value of a variable in a file "startfi.nc".
+
+# inipem_orbit.sh:
+  Bash script file to modify the orbital parameters of a file "startfi.nc" according to the date set in the file "run_PEM.def".
+
 # concat_diagpem.sh:
   Bash script file to concatenate along the variable 'Time' all the "diagpem.nc" files of the PEM into one NetCDF file. 'Time' is re-indexed with the numbering of Martian years simulated by the PEM run.
+
+# output_layering.py:
+  Python script file to output the stratification data from the "startpem.nc" files.
 
 Note: