Changes between Version 3 and Version 4 of Doc/ComputingCenters/LocalPC
- Timestamp:
- 10/11/19 15:46:04 (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Doc/ComputingCenters/LocalPC
v3 v4 9 9 # Compiling # 10 10 ## Test installation of XIOS ## 11 It is recommended to first make a test installation of XIOS following the guide here: http://forge.ipsl.jussieu.fr/ioserver/wiki/documentation12 Then use the same libraries and compiler versions for all components as for XIOS.11 It is recommended to first make a test installation of [wiki:Doc/Tools#XIOS XIOS] following the guide here: http://forge.ipsl.jussieu.fr/ioserver/wiki/documentation. [[BR]] 12 Then use the same libraries and compiler versions for all components as for [wiki:Doc/Tools#XIOS XIOS]. 13 13 14 Note: the netcdf4 library can be parallel or sequential, depending on the version. If the sequential netcdf4 library is used, some functionalities in XIOS can not be used such us using several servers. To link XIOS to the sequential library, the argument --netcdf_lib netcdf4_seq must be set when compiling XIOS. This is added in the main makefile or the main script for compilaton just after ./make_xios --netcdf_lib netcdf4_seq...14 Note: the netcdf4 library can be parallel or sequential, depending on the version. If the sequential netcdf4 library is used, some functionalities in [wiki:Doc/Tools#XIOS XIOS] can not be used such as using several servers. To link [wiki:Doc/Tools#XIOS XIOS] to the sequential library, the argument `--netcdf_lib netcdf4_seq` must be set when compiling [wiki:Doc/Tools#XIOS XIOS]. This is added in the main Makefile or the main script for compilaton just after `./make_xios --netcdf_lib netcdf4_seq` ... 15 15 16 16 17 Some configurations can be installed without XIOS.17 Some configurations can be installed without [wiki:Doc/Tools#XIOS XIOS]. 18 18 19 19 ## Choose a target in AA_make.gdef ## 20 The ins_make script from modipsl will not recognize your local PC to create makefiles. You must specify an existing target or create a new target in the util/AA_make.gdef file. Adapt this target to your computing environment (compiler, options, path to netcdf, etc), and create a new makefile specifying this target:20 The `ins_make` script from modipsl will not recognize your local PC to create makefiles. You must specify an existing target or create a new target in the `util/AA_make`.gdef file. Adapt this target to your computing environment (compiler, options, path to netcdf, etc), and create a new makefile specifying this target: 21 21 {{{ 22 22 ./ins_make -t new_target 23 23 }}} 24 24 25 One of the important variables given is FCM_ARCH. Set for example FCM_ARCH=NEW-ARCH. FCM_ARCHgives the name of the arch files used for the different models, see next section.25 One of the important variables given is `FCM_ARCH`. Set for example `FCM_ARCH=NEW-ARCH`. `FCM_ARCH` gives the name of the arch files used for the different models, see next section. 26 26 27 27 ## Adapt compilation for each model ## 28 28 Please refer to the model managers of your model configuration to learn more about how to compile the IPSL models on a local PC and which compilers can be used with the specific models you need. See some information here below. 29 29 30 Most of the IPSL models uses compilation based on fcm ([wiki:Doc/Compile#Compilingenvironment for more informations on fcm]) and the compiling options are set in arch files. Depending on the version of the models and between the models the file arch-target.path might have different syntaxes. For each model, take as example one existing target machine and adapt for your PC. The files are stored in the folder modipsl/modeles/MODEL/arch/arch-NEW_ARCH.fcm/.path/.env. The name NEW_ARCHcan be changed but must be the same for all modeles and set in AA_make.gdef.30 Most of the IPSL models uses compilation based on fcm ([wiki:Doc/Compile#Compilingenvironment for more informations on fcm]) and the compiling options are set in arch files. Depending on the version of the models and between the models the file `arch-target.path` might have different syntaxes. For each model, take as example one existing target machine and adapt for your PC. The files are stored in the folder `modipsl/modeles/MODEL/arch/arch-NEW_ARCH.fcm/.path/.env`. The name `NEW_ARCH` can be changed but must be the same for all modeles and set in AA_make.gdef. 31 31 32 32 ## Example for installing ORCHIDEE offline ## 33 Before installing ORCHIDEE, make a test installation of XIOS, see guide here: http://forge.ipsl.jussieu.fr/ioserver/wiki/documentation . If this fails, it is still possible to install ORCHIDEE without XIOS, see notes below.33 Before installing [wiki:Doc/Models/ORCHIDEE ORCHIDEE], make a test installation of [wiki:Doc/Tools#XIOS XIOS], see guide here: http://forge.ipsl.jussieu.fr/ioserver/wiki/documentation . If this fails, it is still possible to install [wiki:Doc/Models/ORCHIDEE ORCHIDEE] without [wiki:Doc/Tools#XIOS XIOS], see notes below. 34 34 35 35 {{{ … … 57 57 modipsl/modeles/XIOS/arch/arch_NEW_ARCH.env 58 58 59 # Note: the netcdf4 library can be parallel or sequential, depending on the version. If the sequential netcdf4 library is used, some functionalities in XIOS can not be used such us using several servers. To link XIOS to the sequantial library, the argument --netcdf_lib netcdf4_seq when compiling XIOS. This should be added in modipsl/config/ORCHIDEE_OL/AA_make just after ./make_xios --netcdf_lib netcdf4_seq ... 59 # Note: the netcdf4 library can be parallel or sequential, depending on the version. If the sequential netcdf4 library is used, 60 # some functionalities in XIOS can not be used such us using several servers. To link XIOS to the sequantial library, the 61 # argument --netcdf_lib netcdf4_seq when compiling XIOS. This should be added in modipsl/config/ORCHIDEE_OL/AA_make just 62 # after ./make_xios --netcdf_lib netcdf4_seq ... 60 63 61 64 … … 77 80 }}} 78 81 Notes: 79 * The name NEW_ARCHcan be changed to another name but needs to be same everywhere80 * All arch_NEW_ARCH.* files and AA_make.gdefmust be coherent for the libraries and options choosen81 * It is still possible to install without XIOS. For that case, you do not need to do 3b above and the compilation is done using '''gmake without_xios'''82 * The name `NEW_ARCH` can be changed to another name but needs to be same everywhere 83 * All `arch_NEW_ARCH.*` files and `AA_make.gdef` must be coherent for the libraries and options choosen 84 * It is still possible to install without [wiki:Doc/Tools#XIOS XIOS]. For that case, you do not need to do 3b above and the compilation is done using '''gmake without_xios''' 82 85 83 86 … … 107 110 108 111 109 Note 1: for installing in parallel mode with MPI, do as above but adapt the files arch-gfortran.path, arch-gfortran.fcm and AA_make.gef with suitable compile options. You can use target gfortran_CICLAD in AA_make.gdefas example. Do not do point 3 above. [[BR]]112 Note 1: for installing in parallel mode with MPI, do as above but adapt the files `arch-gfortran.path`, `arch-gfortran.fcm` and `AA_make.gef` with suitable compile options. You can use target `gfortran_CICLAD` in `AA_make.gdef` as example. Do not do point 3 above. [[BR]] 110 113 111 Note 2: for older version of ORCHIDEE, such as in LMDZOR_v5, the files in modeles/ORCHIDEE/arch do not exist. Compile options in AA_make.gdef is used for ORCHIDEEin this case.114 Note 2: for older version of [wiki:Doc/Models/ORCHIDEE ORCHIDEE], such as in LMDZOR_v5, the files in modeles/ORCHIDEE/arch do not exist. Compile options in `AA_make.gdef` is used for [wiki:Doc/Models/ORCHIDEE ORCHIDEE] in this case. 112 115 113 [[NoteBox(note,The v6 configurations cannot be compiled in sequential mode because XIOSdo not compile or run without the MPI library., 600px)]]116 [[NoteBox(note,The v6 configurations cannot be compiled in sequential mode because [wiki:Doc/Tools#XIOS XIOS] do not compile or run without the MPI library., 600px)]] 114 117 115 118 116 119 # Simulation with libIGCM # 117 When using libIGCM on a local PC, the parameters of the default system described in the libIGCM_sys/libIGCM_sys_default.kshfile will be used. You may have to change this file to match your system. [[BR]]120 When using [wiki:Doc/Tools#libIGCM libIGCM] on a local PC, the parameters of the default system described in the `libIGCM_sys/libIGCM_sys_default.ksh` file will be used. You may have to change this file to match your system. [[BR]] 118 121 119 A minimum subset of files located on the shared IGCM account must be downloaded and installed. This directory is called R_IN in libIGCM_sys_default.ksh and it has the default path /home/${LOGIN}/IGCM.122 A minimum subset of files located on the shared IGCM account must be downloaded and installed. This directory is called `R_IN` in `libIGCM_sys_default.ksh` and it has the default path `/home/${LOGIN}/IGCM`. 120 123 121 124 # Installing rebuild # 122 125 The output of old version of the models (ORCHIDEE, LMDZ, INCA, REPROBUS) must be recombined to the total horizontal domain when simulation is done in parallel mode. 123 126 124 The tool for this is called ''rebuild''. The rebuild tool is called in the post-processing phase by libIGCM. rebuild is a fortran code included in IOIPSL. rebuild must be installed and compiled on the local machine. The rebuild can then be used interactively outside libIGCM or in the post-processing phase.127 The tool for this is called ''rebuild''. The rebuild tool is called in the post-processing phase by [wiki:Doc/Tools#libIGCM libIGCM]. Rebuild is a Fortran code included in [wiki:Doc/Tools#IOIPSLandREBUILD IOIPSL]. rebuild must be installed and compiled on the local machine. The rebuild can then be used interactively outside libIGCM or in the post-processing phase. 125 128 126 129 '''Installation''' … … 136 139 137 140 138 For use with libIGCM, add the path to your rebuild in libIGCM_sys/libIGCM_sys_default.ksh.141 For use with [wiki:Doc/Tools#libIGCM libIGCM], add the path to your rebuild in `libIGCM_sys/libIGCM_sys_default.ksh`. 139 142 140 143 '''Use in interactive mode'''[[BR]] 141 144 142 rebuild can also be used interactively. For example create the global file sechiba_history.ncas following :145 rebuild can also be used interactively. For example create the global file `sechiba_history.nc` as following : 143 146 144 147 {{{