Changes between Version 58 and Version 59 of Doc/Setup

Timestamp:

10/10/19 15:22:21 (5 years ago)

Author:

falletti

Comment:

--

Doc/Setup

@@ -15 +15 @@
 # Create submission directory and main job #
 ## Create submission directory ##
-The configuration directory (`modipsl/config/`) contains tools to compile (Makefile and AA_make files) and tools to run a simulation, i.e. two directories (EXPERIMENTS and GENERAL) allow you to create submission directories for your model configuration. [[BR]]
-If one or several submission directories (e.g. EXP00, LMDZOR01, historical, OOL_SEC, MyJobTest etc...) have already been created, you can directly go to the [#Contentsofthesubmissiondirectory next step]. 
-
-* EXPERIMENTS : In this directory you will find several sub-directories for each experiment you can produce with the same executable. For example : 
+The configuration directory (`modipsl/config/`) contains tools to compile (Makefile and AA_make files) and tools to run a simulation (two directories (EXPERIMENTS and GENERAL) that allow you to create submission directories for your model configuration). [[BR]]
+If one or several submission directories (e.g. EXP00, LMDZOR01, historical, OOL_SEC, etc...) have already been created, you can directly go to the [#Contentsofthesubmissiondirectory next step]. 
+
+* '''EXPERIMENTS''' : In this directory you will find several sub-directories for each experiment you can produce with the same executable. For example : 
   * for IPSLCM6 you can choose experiments between LMDZ, LMDZOR and IPSLCM;
   * for LMDZOR_v6 you can choose experiments between LMDZOR et LMDZ;
   * for LMDZORINCA_v6 you can choose experiments between LMDZ, LMDZOR and LMDZORINCA.
-* GENERAL : In this directory you will find scripts and parameters files independent of the experiment (divided into 3 directories POST, PARAM and DRIVER).
-
-Each of the sub-directories in EXPERIMENTS may contain a reference experiment (e.g. ''clim'', ''amip''... for LMDZOR, ''NMHC_AER'', ''AER'' and ''GES''... for LMDZORINCA, ''piControl'', ''historical''... for IPSLCM) and the file '''config.card''' which will be your simulation's initial setup. 
-
-Before preparing the working directory you must know which kind of simulation you want to perform. Then, you must copy the ''config.card'' file at the same level as the main ''Makefile''. 
-[[BR]] For example, to perform a '''clim''' experiment with LMDZOR_v5:
-{{{
-#!sh 
-cd modipsl/config/LMDZOR_v5
-cp EXPERIMENTS/LMDZOR/clim/config.card . 
-}}}
-
-[[Image(creation_exp_v5.jpg, 50%)]] 
-
-The header of ''config.card'' contains the '''!JobName''' field for which you must specify your simulation's  name. Then run the '''`ins_job`''' script that will in first time ask you, if you are working on TGCC, your id group, and then create a directory for your experiment. If you are working on IDRIS it will directly create a directory for your experiment. 
-[[BR]] In the previous example, a simulation called ''DIADEME'' is created:
+* '''GENERAL''' : In this directory you will find scripts and parameters files independent of the experiment (divided into 3 directories POST, PARAM and DRIVER).
+
+Each of the sub-directories in EXPERIMENTS will contain a reference experiment (e.g. ''clim'', ''amip''... for LMDZOR, ''NMHC_AER'', ''AER'' and ''GES''... for LMDZORINCA, ''piControl'', ''historical''... for IPSLCM) and the file '''config.card''' which will be your simulation's initial setup. 
+
+To prepare your working directory you must know what kind of simulation you want to perform (i.e. choose a predefined experiment). Then, you must copy its own '''`config.card`''' file at the same level as the main ''Makefile''. 
+[[BR]] 
+For example, to perform a '''clim_360d''' experiment with '''LMDZOR_v6''' configuration:
+{{{
+cd modipsl/config/LMDZOR_v6
+cp EXPERIMENTS/LMDZOR/clim_360d/config.card . 
+ls 
+  AA_Make Makefile EXPERIMENTS GENERAL config.card
+}}}
+
+[[Image(creation_exp_v6.jpg, 50%)]] 
+
+When you have copied the ''config.card'', you must change at least '''!JobName''' field (your simulation's name) and check the '''Parallelization''' option (dependant of your resolution). In the following example, a simulation called ''!MyJobTest'' is created:
+
+{{{
+#D-- UserChoices -
+[UserChoices]
+#============================
+JobName=MyJobTest
+
+#D- For each component,
+ATM= (gcm.e, gcm.e, 71MPI, 8OMP)
+SRF= ("", "")
+SBG= ("", "")
+IOS= (xios_server.exe, xios.x, 1MPI)
+}}}
+
+[[NoteBox(note, The standard parallelization options are: \\ - '''144x142x79''' => 71 MPI x 8 OMP + 1 MPI \\ - '''96x95x39''' => 31 MPI x 4 OMP + 1 MPI, 600px)]]
+
+The header of ''config.card'' contains the '''!JobName''' field for which you must specify your simulation's name. Then run the '''`ins_job`''' script that will in first time ask you, if you are working on TGCC, your id group, and then create a directory for your experiment. If you are working on IDRIS it will directly create a directory for your experiment. 
+[[BR]] In the previous example, a simulation called ''!MyJobTest'' is created:
 {{{
 #!sh