[[TOC(heading=Using libIGCM library with ORCA2_LIM nemo_v3_6,  depth=2, libIGCM/setupsimupage, libIGCM/change_BC,  libIGCM/postprocessingpage, libIGCM/postalreadyrunpage,  libIGCM_nemo_v_3_4/parallelpage_3_4, libIGCM/common_account,  libIGCM/suggestpage, libIGCM/appendixpage )]]

= '''Using libIGCM library with ORCA2_LIM for nemo_v3_6''' =
== Purposes ==
  Through libIGCM give an example of run of configuration ORCA1_LIM3_PISCES with :

 * INTERANNUAL forcing files COREII  (yeras from 1948 to 2009, repeted 3 times)
 * output 1Y for ocean, 1M for ice
 * RESTARTS every year
 * on Idris ADA machine

Official documentation of Libigcm is :

  https://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc

== Quick start guide : downloading '''nemo_3_6_STABLE: ''' ==
  https://forge.ipsl.jussieu.fr/nemo/browser/branches/2015/nemo_v3_6_STABLE/NEMOGCM

  default setting of ORCA_LIM3 configuration in NEMO v3_6_STABLE are :

 * '''climatological run''', with bulk core forcing, focring files COREII,
 * with calendar type '''noleap'''
 * and ocean output frequency 1Y,1M,5D,1D, ice output frequency 5D,
 * without MONITORING, and ATLAS.

 * Define the following alias to use SVN : [[BR]]
{{{
 alias svn_ano='svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl'

}}}
 * Create and go into working directory : [[BR]]
{{{
 mkdir TP-NEMO-libIGCM ; cd TP-NEMO-libIGCM

}}}
 * Extract modipsl : [[BR]]
{{{
 svn_ano 
}}}
 * Extract NEMOGCM :   (look at  NEMOGCM definition in '''modipsl/util/mod.def '''file which branch you have: 
 * 
 * #---- NEMO in forced mode : [[BR]][[BR]]#-H- NEMOGCM  NEMOGCM  in forced mode   version since v3.4  Compilation using FCM[[BR]]#-H- NEMOGCM  libIGCM tag libIGCM_v2.6[[BR]]#-M- NEMOGCM  Christian.Ethe@ipsl.jussieu.fr[[BR]]#-C- NEMOGCM  tags/libIGCM_v2.6                                                          HEAD  10 libIGCM                 .[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM                                 HEAD  7  .                       modeles[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_LIM/IGCM00         HEAD  7  ORCA2_LIM/IGCM00        config[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_LIM_PISCES/IGCM00  HEAD  7  ORCA2_LIM_PISCES/IGCM00 config[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_OFF_PISCES/IGCM00  HEAD  7  ORCA2_OFF_PISCES/IGCM00 config[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_LIM/EXP00          HEAD  7  PARAM                   config/ORCA2_LIM/IGCM00[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_LIM_PISCES/EXP00   HEAD  7  PARAM                   config/ORCA2_LIM_PISCES/IGCM00[[BR]]#-C- NEMOGCM  '''branches/2012/dev_v3_4_STABLE_2012/'''NEMOGCM/CONFIG/ORCA2_OFF_PISCES/EXP00   HEAD  7  PARAM                   config/ORCA2_OFF_PISCES/IGCM00
 * 
 * change with:[[BR]]#-H- NEMOGCM  NEMOGCM  in forced mode   version since v3.4  Compilation using FCM[[BR]]#-H- NEMOGCM  libIGCM tag libIGCM_v2.6[[BR]]#-M- NEMOGCM  Christian.Ethe@ipsl.jussieu.fr[[BR]]#-C- NEMOGCM  tags/libIGCM_v2.6                                                          HEAD  10 libIGCM                 .[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM                                 HEAD  7  .                       modeles[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_LIM/IGCM00         HEAD  7  ORCA2_LIM/IGCM00        config[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_LIM_PISCES/IGCM00  HEAD  7  ORCA2_LIM_PISCES/IGCM00 config[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_OFF_PISCES/IGCM00  HEAD  7  ORCA2_OFF_PISCES/IGCM00 config[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_LIM/EXP00          HEAD  7  PARAM                   config/ORCA2_LIM/IGCM00[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_LIM_PISCES/EXP00   HEAD  7  PARAM                   config/ORCA2_LIM_PISCES/IGCM00[[BR]]#-C- NEMOGCM  '''branches/2015/dev_v3_6_STABLE/'''NEMOGCM/CONFIG/ORCA2_OFF_PISCES/EXP00   HEAD  7  PARAM                   config/ORCA2_OFF_PISCES/IGCM00[[BR]])[[BR]]
 * modipsl/libIGCM : the latest revision of tags/libIGCM_v2.6 from repository [http://forge.ipsl.jussieu.fr/libigcm/svn ​http://forge.ipsl.jussieu.fr/libigcm/svn]
{{{
 cd modipsl/util 
 ./model NEMOGCM
}}}

 * Choose and compile configuration (for example if you run ORCA2_LIM configuration on "ada" machine at idris) : [[BR]]
{{{
 cd ../modeles/NEMOGCM/CONFIG
 ./makenemo -m x3750_ADA -n ORCA2_LIM -j8

 (executable is created in ORCA2_LIM/BLD/bin directory)
}}}

  Using ./makenemo -h to see help ( to see list of compilers availables, to see options,...) [[BR]]                              '''                              '''

 * Editing at this point config/ORCA2_LIM/IGCM00/'''config.card   (according to iodef.xml file)'''

  '''                            NOTE : for ada ( idris ) machine'''                    starting from revision 2021 of trunk of libigcm it is possible to add in [Post] section of config.card options [[BR]]                   [Post] [[BR]]                   SpaceName                    =PROD   (to have IGCM_OUT on gaya)[[BR]]                    PackFrequency                    =10Y  (to have pack option; i.e. only one tar file)

 * Editing at this point config/ORCA2_LIM/IGCM00/COMP/'''opa9.card'''
 * Editing at this point config/ORCA2_LIM/IGCM00/COMP/'''lim2.card'''

see : [https://forge.ipsl.jussieu.fr/nemo/wiki/libIGCM/setupsimupage setupsimupage]

 * Submit Job : [[BR]]
{{{
cd ../     (back into modipsl directory) 
}}}
{{{
./util/ins_job
 cd ../config/ORCA2_LIM/IGCM00 
 llsubmit Job_Name
}}}

And also see useful remarks: [https://forge.ipsl.jussieu.fr/nemo/wiki/libIGCM/suggestpage suggestpage]

If you want to switch from climatological to interannual see: [https://forge.ipsl.jussieu.fr/nemo/wiki/libIGCM/change_BC change_BC]

  Simona Flavoni last update: [[Timestamp]]