[[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 ==
 Trought libIGCM run a great numbers of year of NEMO 3_6_STABLE for configuration ORCA1_LIM3_PISCES
 with INTERANNUAL forcing files COREII
 with output 1Y 
 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 

  downloading configuration ORCA_LIM3 in NEMO v3_6_STABLE implies :

 * 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,
 * with iom_put, (with an example of iodef.xml file),
 * 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 TRY ; cd TRY

}}}
 * Extract modipsl : [[BR]]
{{{
 svn_ano 
}}}
 * Extract NEMOGCM :   (verify NEMOGCM definition in modipsl/util/mod.def file)[[BR]]
{{{
 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]]                         '''                         [[BR]]                         NOTE'''                           : IF YOU WANT TO COMPILE NEMO code that is not the  NEMO directory, you can create MY_NEMO directory and put your NEMO code  into MY_NEMO directory

(for example) and compile it in this way

{{{
cp /PATH/YOUR_NEMO_DIR  NEMOGCM/MY_NEMO

}}}
{{{
cd NEMOGCM/CONFIG
 ./makenemo -n ORCA2_LIM -s MY_NEMO -m x3750_ADA -j0

 -j0 option create only configuration directory but does not compile it
 -j8 compile with 8 proc for compilation phase (but you do not have parallel code compiled)
}}}
  '''        NOTE : control list of cpp keys in '''        NEMOGCM/CONFIG/ORCA2_LIM/cpp_ORCA2_LIM.fcm [[BR]]       '''       you need key_iomput ( choose your output list in iodef.xml)'''

 * Copy executable nemo.exe in modipsl :

 * 
{{{
cd ../../../bin
ln -s ../modeles/NEMOGCM/CONFIG/ORCA2_LIM/BLD/bin/nemo.exe nemo.exe
}}}

 * 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]]