[[TOC(heading=Using libIGCM library with ORCA2_LIM nemo_v3_3, depth=2, libIGCM/setupsimupage, libIGCM/change_BC, libIGCM/postprocessingpage,  libIGCM/postalreadyrunpage, libIGCM_nemo_v_3_3/parallelpage_3_3, libIGCM/common_account, libIGCM/suggestpage, libIGCM/appendixpage )]]

= '''Using libIGCM library with ORCA2_LIM for nemo_v3_3''' =
[[BR]]

== Purposes ==

[[BR]]

    * Document the using of Libigcm for NEMO version 3_3, in configuration ORCA2_LIM 

    * Official documentation of Libigcm is :
    
      http://forge.ipsl.jussieu.fr/libigcm/wiki/WikiStart

[[BR]]
[[BR]]

== Quick start guide : downloading '''nemo_3_3_beta''' ==

 1/2/2011 downloading NEMO trunk default configuration is:  [[BR]]
 climatological run, with bulk core forcing, focring files COREII, [[BR]]
 with calendar type noleap [[BR]]
 and ocean output frequency 1Y,1M,5D,1D, ice output frequency 5D, [[BR]]
 with iom_put, (with an example of iodef.xml file), [[BR]]
 without MONITORING, and ATLAS.
 
    * Create and go into working directory : [[BR]]
{{{
 mkdir TRY ; cd TRY
}}}
    * Extract NEMOGCM : [[BR]]
{{{
 svn co http://forge.ipsl.jussieu.fr/nemo/svn/tags/nemo_v3_3/NEMOGCM
    ( If you want to extract even Documentation: 
    svn co http://forge.ipsl.jussieu.fr/nemo/svn/tags/nemo_v3_3 )
}}}

    * Choose and compile configuration (for example if you run ORCA2_LIM configuration on "brodie" machine at idris) : [[BR]]
{{{
 cd NEMOGCM/CONFIG
 ./makenemo -m SX8_BRODIE -n ORCA2_LIM 
   (executable is created in ORCA2_LIM/BLD/bin directory)
}}}
  
  Using ./makenemo -h to see help ( to see list of compilers availables, to see options,...)

    * Example of a mono-processor run : [[BR]]
{{{
 ./makenemo -m SX8_BRODIE -n ORCA2_LIM 
}}}

    * Example of a multi-processor run (decomposition 2x4) : [[BR]]
{{{
 ./makenemo -m SX8_BRODIE -n ORCA2_LIM add_key "key_mpp_mpi key_nproci=2 key_nprocj=4" 
}}}

    * Create PARAM directory for ORCA2_LIM configuration : [[BR]]
{{{
 cp -R ORCA2_LIM/EXP00 ORCA2_LIM/IGCM00/PARAM
}}}

   * Download Libigcm in EXTERNAL directory : [[BR]]
{{{
 cd ../EXTERNAL
 svn co http://forge.ipsl.jussieu.fr/libigcm/svn/tags/libIGCM_v1_9 libIGCM
 svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk/util
}}}

 * Change PATH in ins_job script : [[BR]]
{{{
 vi util/ins_job ; line 106
 replace  for i in $(find ${d_n}/.. -name ${F_CFG} -print)
 by       for i in $(find ${d_n}/../.. -name ${F_CFG} -print)
}}}

 * Create bin in EXTERNAL directory, and create link to nemo.exe : [[BR]]
{{{
 mkdir bin 
 cd bin 
 ln -s ../../CONFIG/ORCA2_LIM/BLD/bin/nemo.exe nemo.exe
 (because libIGCM looks for executable in ${MODIPSL}/bin ; in our case ${MODIPSL}=EXTERNAL/)
}}}

Editing at this point NEMOGCM/CONFIG/ORCA2_LIM/IGCM00/config.card    [[BR]]
Editing at this point NEMOGCM/CONFIG/ORCA2_LIM/IGCM00/COMP/opa9.card [[BR]]
Editing at this point NEMOGCM/CONFIG/ORCA2_LIM/IGCM00/COMP/lim2.card [[BR]]
see : [https://forge.ipsl.jussieu.fr/nemo/wiki/libIGCM/setupsimupage setupsimupage]


   * Submit Job : [[BR]]
{{{
 ./util/ins_job
 cd ../CONFIG/ORCA2_LIM/IGCM00 
 qsub 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]

[[BR]]
[[BR]]

 Simona Flavoni last update:  [[Timestamp]]