Changeset 3038 for trunk/LMDZ.MARS/deftank/pem/README

Timestamp:

Sep 8, 2023, 7:26:52 PM (22 months ago)

Author:

jbclement

Message:

Mars PEM:

• New version of scripts (launch_pem.sh and exeGCM.sh) to launch the chained simulation of GCM and PEM runs. It should be simpler and clearer for users;
• Update of README accordingly;
• ob_ex_lsp.asc is now in Earth years like original Laskar's data + rename obl_ecc_lsp.asc;
• Some improvements for the script modify_startfi_orbit.sh;
• Some changes in run_PEM.def and xml files.

JBC

File:

• trunk/LMDZ.MARS/deftank/pem/README (modified) (1 diff)

trunk/LMDZ.MARS/deftank/pem/README

@@ -1 +1 @@
 This folder contains all the files needed to run the Planetary Evolution Model (PEM).
 
-run_pem1:
-  Bash file that runs chained simulation of PEM.
-  The number of PCM simulation in between each PEM run is setup via "nb_GCM_call" variable.
-  It is running using the run0 file from the Mars PCM.
-  The number of PEM simulation to be done is setup via "num_PEM_now" and "num_PEM_end".
-  The path to source the arch file needs to be adapted, as well as the number of MPI/OMP.
-  The resolution and the planet type needs also to be adapted.
-  The header correspond to the IRENE calculator, and should be changed for other machines.
+# launch_pem.sh:
+  Bash script file to launch the chained simulation of PEM and GCM runs.
+  The user has to specify:
+      (i)   n_earth_years -> the number of Earth years to be simulated in total;
+      (ii)  nGCM -> the number of GCM calls between PEM runs (usually nGCM=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.
+  The path to source the arch file should be adapted to the machine.
 
-run_PEM.def
-  All the possible parameter of PEM (read if conf_pem.F90).
-  Nees to be included in run.def with INCLUDEDEF=run_PEM.def
+# exeGCM.sh:
+  Bash script file to run the GCM with a SLURM job. The name of the GCM executable file should be adapted. The header corresponds to the ADASTRA supercomputer and should be changed for other machines.
 
-ob_ex_lsp.asc
-  File containing obliquity, excentricity and ls of perihelion form laskar in Martian year.
+# run_PEM.def
+  All the possible parameters to define a PEM run (read in "conf_pem.F90").
+  It needs to be included in "run_GCM.def" with "INCLUDEDEF=run_PEM.def".
 
-To run the PEM you need to change in context_lmdz_physics.xml the line enabled=".false." to enabled=".true." of Xdiurnalave
+# obl_ecc_lsp.asc
+  File describing orbital parameters for Mars from Laskar data. It contains the Earth year and the corresponding obliquity, eccentricity and Ls of perihelion.
+
+# modify_startfi_orbit.sh:
+  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 data in "obl_ecc_lsp.asc" to start the chained simulation.
+
+Note:
+  To run the chained simulation, be careful to have:
+      (i)   the xml files for XIOS. There should be "iodef.xml", "context_lmdz_physics.xml", "file_def_physics_mars.xml" and "field_def_physics_mars.xml" which can be found in the deftank folder. In "context_lmdz_physics.xml", the line for Xdiurnalave should be activated (enabled=".true.");
+      (ii)  the usual def files to run the GCM with "run.def" renamed in "run_GCM.def";
+      (iii) the "startfi.nc" file modified accordingly thanks to "modify_startfi_orbit.sh";
+      (iv)  "diagfi_PEM.def", "diagfi_GCM.def" and eventually other files...