[[ParentLinkage(=)]]
[[BR]]
[[PageOutline]]

= '''Using libIGCM(v1_1) library with ORCA2_LIM''' = 


== A - Purposes: ==

[[BR]]

    * Document the using of libIGCM for NEMO, in configuration ORCA2_LIM 
[[BR]]
[[BR]]

== B - Quick start guide: ==

[[BR]]

    * Define the following alias to use SVN : [[BR]]

{{{
 alias svn_ano='svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl'
 alias svn_libigcm='svn co http://forge.ipsl.jussieu.fr/libigcm/svn/tags/libIGCM_v1_1 libIGCM'
 alias svn_nemoligcm='svn co http://forge.ipsl.jussieu.fr/nemo/svn/branches/libIGCM/ORCA2_LIM/IGCM00 IGCM00'
}}}

    * Create and go into working directory : [[BR]]

{{{
 mkdir TRY ; cd TRY
}}}

    * Extract modipsl : [[BR]]

{{{
 svn_ano 
}}}

    * Extract NEMO : [[BR]]

{{{
 cd modipsl/util 
 ./model NEMO 
}}}
   
    * Extract libigcm : [[BR]]

{{{ 
 cd ../ 
 svn_libigcm
}}}
   
    * Extract card for NEMO for libIGCM : [[BR]]

{{{ 
 cd config/ORCA2_LIM 
 svn_nemoligcm
}}}

   * Choosing ORCA2_LIM configuration : [[BR]]

{{{
 cd ../../modeles/UTIL
 ./fait_config ORCA2_LIM
}}}
    
    * Install the makefiles : [[BR]]

{{{
 cd ../../util 
 ./ins_make
}}}

    * Compile : [[BR]]

{{{
 cd ../config/ORCA2_LIM 
 gmake
}}}

    * Submit Job : [[BR]]

{{{

 ( Editing at this point modipsl/config/ORCA2_LIM/IGCM00/config.card )

 ../../util/ins_job
 cd IGCM00 
 qsub Job_NL1  (on brodie.idris.fr)
}}}
[[BR]]
[[BR]]

== C - List of possible errors : ==

[[BR]]

=== C.1 Errors in modipsl/config/ORCA2_LIM/IGCM00/Script_Output_''!JobName'' ===

[[BR]]

    * '''Error : TERM = (vt100) ${HOME:-.}/.profile: .bashrc:  not found'''
    * '''Error : ksh: D--------------------------------------------------------------------==:  not found'''


 it can depends on your '''.profile''' file.

 To solve it::
 .profile file it can be like:

 «# .profile  (idris) [[BR]]
 # Fichier d environnement a charger sur la frontale TX7 unix LINUX [[BR]]
 # Vous pouvez mettre a jour le fichier .profile_tx [[BR]]
 if [ `hostname` = "brodie" -a -f $HOME/.profile_tx ]; then [[BR]]
 . $HOME/.profile_tx [[BR]]
 # Fichier d environnement a charger sur les noeuds SX8 unix SUPER-UX [[BR]]
 # Vous pouvez mettre a jour le fichier .profile_sx [[BR]]
 elif [ `hostname` != "brodie" -a -f $HOME/.profile_sx ]; then [[BR]]
 . $HOME/.profile_sx [[BR]]
 else [[BR]]
 echo [[BR]]
 fi »

    * '''Error :  cat: cannot open ........./modipsl/config/ORCA2_LIM/IGCM00/../.resol ''' :


 it is due to modipsl/libIGCM/AA_job file.

 To solve it::
 change in this way:

 #-- Resolution FLAG for oasis input [[BR]]
 #RESOL=$(cat ${SUBMIT_DIR}/../.resol) [[BR]]
 RESOL=

 
 go in modipsl/config/ORCA2_LIM/IGCM00 directory 

 cancel '''run.card.init''' and '''Job_''Name''' files
 
 and then do an '''ins_job''' again.

 (does not still fixed in libIGCM_v1_1)


    * '''Error : Input files and BC for NEMO DO NOT EXIST (i.e. sst_data.nc, sss_data.nc, geothermal_heating.nc, bathy_level.nc, etc...)'''

 IGCM_sys_Get, ERROR : regular file ...../OCE/ORCA2_LIM/bathy_level.nc DOES NOT EXIST .

 To solve it::
 In this moment we've still to download on gaya.idris.fr:~/!reee512/NEMO/ORCA2_LIM_nemo_v3.tar file, and to untar it into the directory:

 ${R_BC}/OCE/ORCA2_LIM

 and where  ${R_BC} is a variable that can be changed in modipsl/config/ORCA2_LIM/IGCM00/config.card file.

    * '''Error : IGCM_debug_Exit :  IGCM_config_Initialize Error !PeriodState :  Fatal '''

 To solve it::  
 change line in modipsl/config/ORCA2_LIM/IGCM00/run.card

 !PeriodState=Fatal [[BR]]
 in  [[BR]]
 !PeriodState=

 or rm modipsl/config/ORCA2_LIM/IGCM00/run.card

[[BR]]
[[BR]]

== D - List of possible remarks and suggestions ==

[[BR]]
  
    * '''Every time that we change modipsl/config/ORCA2_LIM/IGCM00/config.card'''

 we have to cancel modipsl/config/ORCA2_LIM/IGCM00/run.card.init

 cancel modipsl/config/ORCA2_LIM/IGCM00/Job_''Name'' 

 and run ./modipsl/util/ns_job script 

    * '''To perform a second simulation after a run with !PeriodState=Fatal''' 

 cancel modipsl/config/ORCA2_LIM/IGCM00/stack_error, modipsl/config/ORCA2_LIM/IGCM00/Script_Output_''!JobName''

 but do not cancel modipsl/config/ORCA2_LIM/IGCM00/run.card.init file, if not run.card file is not re-created.

 ( File run.card.init il created with ins_job script )

 * '''Does it exists a caption file for run.card.init options?''' 

 In to run.card.init file who can we undesrtand syntax of? :

 !MonitoringRunning=n [[BR]]
 !MonitoringCompleted= [[BR]]

 !TimeSeriesRunning=n [[BR]]
 !TimeSeriesCompleted= [[BR]]

 !SeasonalRunning=n  [[BR]]
 !SeasonalCompleted= 

 Is there a reference file?

[[BR]]
[[BR]]

== E - To do list ==


[[BR]]
[[BR]]

 * test with trunk/libIGCM: is it impossible to have run.card??? control Post Treatment status!!!
 * doing run on CCRT machines
 * solve "test argument expected problem"
 * test restart
 * test mpi

[[BR]]
[[BR]]

Simona Flavoni, 15/01/2009