Changes between Initial Version and Version 1 of Doc/Config/LMDZOR_v6.2

Timestamp:

10/11/19 12:12:29 (5 years ago)

Author:

jgipsl

Comment:

--

Doc/Config/LMDZOR_v6.2

@@ +1 @@
+{{{
+#!html
+<h1> The LMDZOR_v6.2 configuration </h1>
+}}}
+[[PageOutline(1-2,Table of contents)]]
+
+
+[[NoteBox(note, LMDZOR_v6.2 is a configuration close the the coupled configuration IPSLCM6.2 , 600px)]]
+Person in charge: Josefine Ghattas
+
+----
+
+
+# Description #
+LMDZOR_v6.2 configuration contains the atmospheric model LMDZ and the land surface model ORCHIDEE. 
+This configuration is under construction and the versions of the models might change without any announcement. If you want to use this version, contact the reference person above.
+
+## Main differences between LMDZOR_v6.2 and LMDZOR_v6.1.10 ##
+LMDZOR_v6.2 :
+ * is adapted to the trunk version of LMDZ and version ORCHIDEE_2_2. These versions are slightly different from the versions used for CMIP6. 
+ * a compilation script is used instead of a makefile in config/LMDZOR_v6 folder.
+ * the configuration is independent of the default module environnement as during compilation a file in config/LMDZOR_v6/ARCH is used
+ * no possibility to use the old 2-bucket hydrology scheme Choisnel in ORCHIDEE
+
+## Compiling ##
+To be done
+
+## Launching ##
+
+The default set up is using 71 MPI * 8 OMP for the gcm.e and 1 MPI for the xios server. Following is set in config.card : 
+{{{
+ATM= (gcm_${ResolAtm}_${OptMode}.e, lmdz.x, 71MPI, 8OMP)
+SRF= ("", "")
+SBG= ("", "")
+IOS= (xios_server_${OptMode}.exe, xios.x, 1MPI)
+}}}
+
+
+
+## XIOS and output control ##
+XIOS is used for output writing. It consists of a library linked to the model and an external server executable (xios_server.exe). It can be launched in attached mode or in server mode. The default set up in LMDZOR_v6.2 is using the server mode with 1 MPI for the server. 2 executables are launched: gcm.e and xios_server.exe. No reconstruction is needed for the output files. The rebuild tool detects automatically that this is not needed. 
+
+The output level and the files to write is set in lmdz.card, orchidee.card and stomate.card. See comments in the corresponding files and read more in [wiki:Doc/Setput chapter Setup]. The !WriteFrequency option in config.card is not used any more. 
+
+## Parameter files ##
+Parameter file are found in PARAM/ directory except the xml files copied directly from the models directory.
+
+In the parameter files, some of the variables will be modified after the job is submitted. This is done by the ''comp.driver'': lmdz.driver, orchidee.driver, stomate.driver and xios.driver. All the variables that might be modified are set equal _AUTO_ or _AUTOBLOCKER_. No variable can be modified without having this key word. The values for these variables are set according to the options from lmdz.card, orchidee.card, stomate.card and config.card. 
+
+A variable which is set to _AUTO_ can also be changed manually in the corresponding file in the PARAM directory. For this case, the driver can not change it again. Some variables are set equal _AUTOBLOCKER_. They cannot be changed. If still they are changed, the job will exit with error message.
+
+
+'''Physics in LMDZ:'''[[BR]]
+Different versions of physics for LMDZ exist in PARAM directory. The choice is done from lmdz.card by setting the variable LMDZ_Physics. The physiq.def and gcm.def files are suffixed by the version of the physics. 
+
+'''CWRR 11-layer hydrology in ORCHIDEE:'''[[BR]]
+Only the multilayer CWRR hydrology scheme is available in ORCHIDEE. 
+
+
+# Quick installation #
+## Extract default version ##
+{{{
+# Install modipsl
+svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
+cd modipsl/util
+
+# Before next command, modify the file mod.def if you want to extract an old version (*)
+
+# Download and compile configuration LMDZOR_v6.2_work
+./model LMDZOR_v6.2_work
+cd ../config/LMDZOR_v6
+./compile_lmdzor.sh [-debug, ...]
+
+# Experiment setup
+cp EXPERIMENT/LMDZOR/clim_pdControl/config.card .     # => modify at least JobName=MyJobname, DateBegin, DateEnd in config.card
+../../libIGCM/ins_job
+cd MyJobname
+
+
+# Modify default setup: 
+# for example change physics in lmdz.card, or hydrology in orchidee.card
+
+# Modify config.card if compilation done for debug mode or another resolution than the default 144x142x79
+vi config.card  => OptMode=debug, ResolAtm=xxx
+
+ccc_msub Job_MyJobname / sbatch Job_MyJobname
+}}}
+
+## Extract a different version ##
+Modify the file util/mod.def if you do not want the default set up. This must be done at step (*) above, before the command ''./model LMDZOR_v6.2_work''. Look for the lines starting with '''#-C- LMDZOR_v6.2_work'''. Each of these lines describes the extraction of one component which is included in the configuration LMDZOR_v6.2. Change the revision number to correspond to the revision you need. 
+
+
+# How to reproduce a coupled simulation with the forced model ? #
+To be reviewed...
+
+
+You have run a simulation with IPSLCM6 and you would like to launch the same with LMDZOR_v6.2 with limit conditions (SST and seaice) coming from the same or another IPSLCM6 simulation. In practice this is needed to estimate radiative forcing from MyIPSLCM6 experiment using SST and sea-ice from the same simulation or from a reference simulation
+
+For this you need to follow all these steps : 
+ * Create limit.nc using sst / sic and land-sea mask from your IPSLCM6 simulation, as described [https://forge.ipsl.jussieu.fr/igcmg_doc/wiki/DocImodelBlmdz#Createlimit.ncfromthedataofapreviousLMDZsimulationcoupledorforced here]
+ * Create your new experiment directory 
+{{{
+cd modipsl/config/IPSLCM6
+cp -r MyIPSLCM6 MyLmdzor6
+cd MyLmdzor6
+rm -rf Script* run.card Job* Debug
+}}}
+ * modify config.card : 
+   * modify the !JobName as you want
+   * modify the !TagName to LMDZOR
+   * modify the Restart section to use Restart from MyIPSLCM6
+   * remove or comment out all lines for the ocean component(OCE, MBG) and the coupler(CPL) in !ListOfCompondents and Executable section :
+{{{
+#========================================================================
+#D-- ListOfComponents -
+[ListOfComponents]
+#D- For each component, Name of component, Tag of component
+ATM= (lmdz, LMDZ4-dev)
+SRF= (orchidee, ORCHIDEE_1_9_5)
+SBG= (stomate, ORCHIDEE_1_9_5)
+#OCE= (opa9, CMIP5_IPSL)
+#ICE= (lim2, CMIP5_IPSL)
+#MBG= (pisces, CMIP5_IPSL)
+#CPL= (oasis, OASIS3-MCT)
+IOS= (xios, XIOS)
+
+#========================================================================
+#D-- Executable -
+[Executable]
+#D- For each component, Real name of executable, Name of executable for oasis
+ATM= (gcm.e, lmdz.x, 32MPI, 4OMP)
+SRF= ("" ,"" )
+SBG= ("" ,"" )
+#OCE= (opa, opa.xx, 31MPI)
+#ICE= ("" ,"" )
+#MBG= ("" ,"" )
+#CPL= ("", "" )
+IOS= (xios_server.exe, xios.x, 1MPI)
+
+}}}
+ * Add the path of your new limit.nc files in [!BoundaryFiles] Section of lmdz.card
+ * (If you are working with IPSLCM5A you need to put "type_ocean=force" in PARAM/run.def)
+ * create your new job 
+{{{
+../../../libIGCM/ins_job
+}}}
+
+