Changes between Version 1 and Version 2 of Documentation/UserGuide/CompileMethods

Timestamp:

05/26/14 13:11:30 (7 years ago)

Author:

jgipsl

Comment:

--

Documentation/UserGuide/CompileMethods

@@ -17 +17 @@
 
 
-== How to compile ORCHIDEE using with FCM methode ==
+== How to compile ORCHIDEE using with FCM method ==
+=== Main makefile in modipsl/config/ORCHIDEE_OL ===
+A main makefile is found in modipsl/config/ORCHIDEE_OL directory. This makefile will first compile IOIPSL and then ORCHIDEE using the script makeorchidee_fcm. 
+
+
+The default set up compiles ORCHIDEE for MPI parallel run mode. The default options for compiling ORCHIDEE can be changed in AA_make in the following section(regenerate makefiles using the script ins_make in modipsl/util after modification) : 
+{{{
+# driver : Only compiling ORCHIDEE (with fcm method)
+driver :
+        (cd ../../modeles/ORCHIDEE ; ./makeorchidee_fcm        -j 8 -parallel mpi -prod -arch ${FCM_ARCH} -driver ; )
+}}}
+
+Example 1 : compile the ORCHIDEE offline model :
+{{{
+cd modipsl/config/ORCHIDEE_OL
+gmake
+}}}
+
+Example 2 : Clean temporary files created during compilation of IOIPSL and ORCHIDEE (the executable is not deleted) : 
+{{{
+cd modipsl/config/ORCHIDEE_OL
+gmake clean
+}}}
+
+Example 3 : Compile using debug compile options
+{{{
+cd modipsl/config/ORCHIDEE_OL
+vi AA_make                       => add -debug(or -dev):  ./makeorchidee_fcm -debug -j 8 -parallel mpi -prod -arch ${FCM_ARCH} -driver 
+../../util/ins_make
+gmake
+}}}
+
+
 === makeorchidee_fcm === 
 The script [https://forge.ipsl.jussieu.fr/orchidee/browser/trunk/ORCHIDEE/makeorchidee_fcm makeorchidee_fcm] compiles ORCHIDEE using the FCM, a software developed by the Hadley Centre. 
-makeorchidee_fcm determines the dependencies between fortran source files. 
+While using this script the dependencies between fortran modules do not need to be set in advance. Fcm determines the dependencies. 
 
 Compile options for different target machines or compilers are defined in the directory ''arch/''. For each target machine two files must exist : archname.fcm and archname.path. Use ''./makeorchidee_fcm -h'' to get information about available arguments. See here the main arguments are [[BR]]
@@ -55 +87 @@
  
 
-Using fcm, the dependencies between the modules are not predefined. fcm will determine the correct order to compile. makeorchidee_fcm to not compile IOIPSL. This must be done in advance. 
+Using fcm, the dependencies between the modules are not predefined. fcm will determine the correct order to compile. makeorchidee_fcm do not compile IOIPSL. This must be done in advance. [[BR]]
+
 Example 1 : compile at curie for MPI parallel run mode 
 {{{
@@ -67 +100 @@
 
 
-Example 3 : compile using gfortran compiler for sequential run mode (make sure that the files arch/gfortran.fcm and arch/gfortran.path are suitable for the environement)
+Example 3 : compile using gfortran compiler for sequential run mode (make sure that the files arch/gfortran.fcm and arch/gfortran.path are suitable for your environement especially the path to netcdf library)
 {{{
 ./makeorchidee_fcm -parallel seq -arch gfortran -driver
@@ -73 +106 @@
 
 
-=== Compile configuration ORCHIDEE_OL ===
-Compiling is done from the directory modipsl/config/ORCHIDEE_OL using the main Makefile. 
-
+Example 4 : clean files created during previous compilation
 {{{
-cd modipsl/config/ORCHIDEE_OL
-gmake
+./makeorchidee_fcm -clean
 }}}
-
-The main makefile will first compile IOIPSL. Then it'ill launch the script makeorchidee_fcm (see description below). The default options for makeorchidee_fcm are set to 
-
-
-
-The script [https://forge.ipsl.jussieu.fr/orchidee/browser/trunk/ORCHIDEE/makeorchidee_fcm makeorchidee_fcm] compiles ORCHIDEE using the FCM, a software developed by the Hadley Centre. 
-
-makeorchidee_fcm 
-
-Test done :
-gfortran at local PC
-obelix in queue