User Tools

Site Tools


tools:run_1st_exp

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tools:run_1st_exp [2016/12/20 11:43]
dmanuben
tools:run_1st_exp [2021/10/15 09:41] (current)
etourign
Line 1: Line 1:
-**Running an experiment at BSC**+**Running an EC-Earth experiment at BSC**
  
 The idea of this documentation is to provide information for people running climate models at BSC. The goal is not to replace the autosubmit documentation, it is to provide a more local information, in particular to help new people in the climate prediction group to run EC-Earth simulations. The idea of this documentation is to provide information for people running climate models at BSC. The goal is not to replace the autosubmit documentation, it is to provide a more local information, in particular to help new people in the climate prediction group to run EC-Earth simulations.
  
 ** Please, feel free to fill and/or correct this documentation ** \\ ** Please, feel free to fill and/or correct this documentation ** \\
-Documentation to be checked and completed (Martin Ménégoz; 31/05/2016). It should be good that people include in this page some **synthesised** information about how to debug climate models at BSC. The part concerning the post-processing of experiment also need to be completed. \\+Documentation to be checked and completed. It should be good that people include in this page some **synthesised** information about how to debug climate models at BSC. The part concerning the post-processing of experiment also need to be completed. \\ 
 +Modification History: \\ 
 +Martin Ménégoz, 31/05/2016 \\ 
 +Simon Wild, 09/04/2018 \\ 
 + 
 +This user guide below is rather obsolete - it contains some helpful overview information and is worth reading through, but for a working tutorial and an updated userguide you should look here: [[https://earth.bsc.es/gitlab/es/auto-ecearth3/wikis/userguide]] 
 + 
 +There is also a tutorial on changing branches, and making changes to the EC-Earth code here: 
 + [[https://earth.bsc.es/gitlab/es/auto-ecearth3/wikis/tutorials]]
  
 ** First step: Use autosubmit** ** First step: Use autosubmit**
  
-To launch an experiment at BSC, for example a simulation with the ocean-atmosphere coupled version of EC-Earth, we have at our disposal **autosubmit**, a tools designed to run any models, and in particular climate models, on any machines. Use the documentation of autosubmit to get an experiment ID, create an experiment with the model version that you need, and to launch your experiment: [[http://autosubmit.readthedocs.io/en/latest/index.html]]. Autosubmit will provide you a name for your new experiment.+To launch an experiment at BSC, for example a simulation with the ocean-atmosphere coupled version of EC-Earth, we have at our disposal **autosubmit**, a tools designed to run any models, and in particular climate models, on any machines. Use the documentation of autosubmit to get an experiment ID, create an experiment with the model version that you need, and to launch your experiment: [[http://autosubmit.readthedocs.io/en/latest/index.html]]. Autosubmit will provide you a name for your new experiment. \\ 
 +**Using the tutorial under the above link is NOT recommended** as numerous updates are necessary (e.g. HPC name should be changed to 'marenostrum4' and 
 +the gitlab url needs to be updated to 'https://earth.bsc.es/gitlab/es/auto-ecearth3'). For a tutorial, you should go here: [[https://earth.bsc.es/gitlab/es/auto-ecearth3/wikis/userguide]] 
 + 
 +To load autosubmit in Earth infrastructure, 
 +  module load autosubmit
  
 NB1: the information needed by autosubmit to prepare an experiment (model version, HPC, etc...) is set up in the file expdef_${exp}.conf. In particular, you have to indicate which model sources you want to use. At BSC, each model version appears generally under a git project: for example: https://earth.bsc.es/gitlab/es/auto-ecearth3 for the 2016 version. NB1: the information needed by autosubmit to prepare an experiment (model version, HPC, etc...) is set up in the file expdef_${exp}.conf. In particular, you have to indicate which model sources you want to use. At BSC, each model version appears generally under a git project: for example: https://earth.bsc.es/gitlab/es/auto-ecearth3 for the 2016 version.
Line 18: Line 31:
   HostName mn1.bsc.es   HostName mn1.bsc.es
   User bsc32704   User bsc32704
-  IdentityFile ~/.ssh/id_rsa+  IdentityFile ~/.ssh/id_rsa   
 +Make sure you add all MN login nodes to the config file. See also here: [[https://earth.bsc.es/gitlab/es/auto-ecearth3/wikis/ssh]].  
 + 
 +NB4: When creating an experiment and you receive the error that some template/repository etc from gitlab is not found it is likely a permission issue.  
  
 **Second step: configuration** **Second step: configuration**
Line 40: Line 56:
 * **proj:** contains the directory model/ with all the source files of your climate model. This directory also contains the templates files. There is a version of templates for each HPC and each model version, since these files are used to transmit the information from the configuration files (that are in the conf/ directory) to the code during a simulation. You will find the different namelists defining the values of the flags or variables used by the different components of EC-Earth. For example, the following file set up the cloud physical properties needed by the physical parametrisations in IFS: \\ * **proj:** contains the directory model/ with all the source files of your climate model. This directory also contains the templates files. There is a version of templates for each HPC and each model version, since these files are used to transmit the information from the configuration files (that are in the conf/ directory) to the code during a simulation. You will find the different namelists defining the values of the flags or variables used by the different components of EC-Earth. For example, the following file set up the cloud physical properties needed by the physical parametrisations in IFS: \\
 /esnas/autosubmit/[exp]/git/model/sources/sources/ifs-36r4/src/ifs/phys_ec/sucldp.F90 /esnas/autosubmit/[exp]/git/model/sources/sources/ifs-36r4/src/ifs/phys_ec/sucldp.F90
 +
 +**Test Suite**
 +
 +For a first attempt it might be worth considering to copy the .conf files from a test experiment with bsc_trunk [[https://earth.bsc.es/gitlab/es/auto-ecearth3/wikis/bsc_trunk]]. 
  
 ** Small configuration issues - May 2016 ** ** Small configuration issues - May 2016 **
tools/run_1st_exp.1482234182.txt.gz · Last modified: 2016/12/20 11:43 by dmanuben