|
|
Line 1: |
Line 1: |
| [[Category: WRF]] | | [[Category: WRF]] |
− | This version is from 2015. Look for the latest version available at NCI at [[WRF | this page]]. | + | This version is from 2015. Look for the latest version available at NCI on [[WRF | this page]]. |
− | ='''Foreword'''= | + | =Foreword= |
− | ----
| + | This document is intended to serve as a handy reference for new users in building and running the WRF and WPS on the Gadi cluster at NCI without the need of making site-specific modifications to WRF and WPS. |
− | This document is intended to serve as a handy reference for new users in building and running the WRF and WPS on the RAIJIN cluster at NCI without the need of making site-specific modification to WRF and WPS. | |
− | This document is only valid from version 3.7.1 of WRF. Please refer to the [[WRF Installation | old installation page]] for older versions.
| |
| | | |
− | =Source Code=
| + | This document is only valid for version 3.7.1 of WRF. Please refer to the other version pages for other instructions. |
− | ----
| |
− | The source code tar files of WRF and WPS (V3.7.1) have been downloaded and placed in the subdirectory /projects/WRF/Downloads on the RAIJIN cluster. The uncompressed source code for V3.7.1 of WRF and WPS, which have been ported to build on RAIJIN cluster, is located in the subdirectory /projects/WRF/WRFV_3.7.1.
| |
| | | |
− | ='''Prerequisites'''= | + | =Source code= |
− | ----
| + | The source code ported to Gadi can be found [https://github.com/coecms/WRF/tree/V3.7.1 on Github] |
− | Get an NCI account, please refer to the [[Induction | Induction page]] of this wiki for instructions.
| |
− | Check the loaded modules and you should already have the Intel compilers and OpenMPI loaded, run:
| |
− | <syntaxhighlight>
| |
− | module list -l
| |
− | - Package -----------------------------+- Versions -+- Last mod. ------
| |
− | Currently Loaded Modulefiles:
| |
− | pbs 2013/05/13 0:17:55
| |
− | dot 2008/11/25 19:24:19
| |
− | intel-fc/12.1.9.293 2013/08/02 3:40:39
| |
− | intel-cc/12.1.9.293 2013/08/02 3:47:33
| |
− | openmpi/1.6.3 2013/04/02 4:20:55
| |
− | </syntaxhighlight>
| |
− | Load the required netcdf module if missing, run:
| |
− | <syntaxhighlight>
| |
− | module load netcdf/4.3.3.1
| |
− | </syntaxhighlight>
| |
− | If configuring to build GRIB2 support, run (tcsh):
| |
− | <syntaxhighlight>
| |
− | setenv JASPERINC /usr/include
| |
− | setenv JASPERLIB /usr/lib64
| |
− | </syntaxhighlight>
| |
− | or in bash
| |
− | <syntaxhighlight>
| |
− | export JASPERINC=/usr/include
| |
− | export JASPERLIB=/usr/lib64
| |
− | </syntaxhighlight>
| |
− | To enable large file support in NetCDF (This installation of NetCDF supports large file support), run(tcsh):
| |
− | <syntaxhighlight>
| |
− | setenv WRFIO_NCD_LARGE_FILE_SUPPORT 1
| |
− | </syntaxhighlight>
| |
− | or in bash:
| |
− | <syntaxhighlight>
| |
− | export WRFIO_NCD_LARGE_FILE_SUPPORT=1
| |
− | </syntaxhighlight>
| |
− | Clone the WRF repository to your own space under /short:
| |
− | <syntaxhighlight>
| |
− | cd /short/$PROJECT/$USER/
| |
− | git clone /projects/WRF/WRFV_3.7.1
| |
− | </syntaxhighlight>
| |
− | ='''Building WRF (ARW)'''=
| |
− | ----
| |
− | Go to the WRFV3/ subdirectory, run:
| |
− | <syntaxhighlight>
| |
− | cd /short/$PROJECT/$USER/WRFV_3.7.1/WRFV3/
| |
− | </syntaxhighlight>
| |
− | Start with a clean installation before compiling WRF, run:
| |
− | <syntaxhighlight>
| |
− | ./clean -a
| |
− | </syntaxhighlight>
| |
− | Configure and compile WRF, run:
| |
− | <syntaxhighlight>
| |
− | ./run_compile
| |
− | </syntaxhighlight>
| |
− | You will be given four choices using Intel compiler. These choices range from compiling for a single processor job (serial), OpenMP shared-memory (smpar), to using distributed-memory (dmpar) or distributed Memory with shared memory (dm+sm).
| |
− | <syntaxhighlight>
| |
− | Please select from among the following Linux x86_64 options:
| |
− | 1. (serial) 2. (smpar) 3. (dmpar) 4. (dm+sm) INTEL (ifort/icc)
| |
− | Enter selection [1-4] :
| |
− | </syntaxhighlight>
| |
− | Once an option is selected from above, a choice of what type of nesting (no nesting (0), basic (1), pre-set moves (2), or vortex following (3)) will be given.
| |
− | <syntaxhighlight>
| |
− | Compile for nesting? (1=basic, 2=preset moves, 3=vortex following) [default 1]:
| |
− | </syntaxhighlight>
| |
− | A file configure.wrf should be created after configuring has completed.
| |
− | Then a compilation script, called wrf_compile, is submitted to the job queue by the run_compile script.
| |
| | | |
− | After a successful build, one should see the following executable files for WRF (the ARW core):
| + | For installation and compilation, please follow the instructions in the README on the home page on Github for the V3.7.1 branch. |
− | <syntaxhighlight>
| |
− | [abc123@raijin3 WRFV3]$ ls -l main/*.exe
| |
| | | |
− | -rwx------ 1 abc123 wrf 35559897 Aug 22 17:14 main/ndown.exe
| + | =How to run= |
− | -rwx------ 1 abc123 wrf 35471615 Aug 22 17:14 main/real.exe
| + | Please refer to [[How_to_run_WRF|this page]] |
− | -rwx------ 1 abc123 wrf 35081246 Aug 22 17:14 main/tc.exe
| |
− | -rwx------ 1 abc123 wrf 38763058 Aug 22 17:13 main/wrf.exe
| |
− | </syntaxhighlight>
| |
− | ='''Building WPS'''= | |
− | ----
| |
− | Go to the WPS/ subdirectory, run:
| |
− | <syntaxhighlight>
| |
− | cd /short/$PROJECT/$USER/WRF/WRFV_3.7.1/WPS/
| |
− | </syntaxhighlight>
| |
− | Start with a clean installation before compiling WPS, run:
| |
− | <syntaxhighlight>
| |
− | clean -a
| |
− | </syntaxhighlight>
| |
− | Run run_compile:
| |
− | <syntaxhighlight>
| |
− | ./run_compile
| |
− | </syntaxhighlight>
| |
− | You will be given four choices using Intel compiler.
| |
− | <syntaxhighlight>
| |
− | Please select from among the following build methods. | |
− | 1. Linux x86_64, Intel compiler (serial)
| |
− | 2. Linux x86_64, Intel compiler (serial_NO_GRIB2)
| |
− | 3. Linux x86_64, Intel compiler (dmpar)
| |
− | 4. Linux x86_64, Intel compiler (dmpar_NO_GRIB2)
| |
− | Enter selection [1-4] :
| |
− | </syntaxhighlight>
| |
− | Choose one of options from above.
| |
| | | |
− | A file configure.wps should be created after configuring has completed. Then the run_compile script will send a compilation job, called wps_compile, to the queue.
| + | =Tests= |
− | After a successful build, one should see the following executable files:
| + | This version has only been tested for compilation. No run has been performed. |
− | <syntaxhighlight>
| |
− | [abc123@raijin3 WPS]$ ls -l *.exe
| |
| | | |
− | lrwxrwxrwx 1 abc123 wrf 23 Aug 23 10:19 geogrid.exe -> geogrid/src/geogrid.exe
| + | [[Category:WRF versions]] |
− | lrwxrwxrwx 1 abc123 wrf 23 Aug 23 10:20 metgrid.exe -> metgrid/src/metgrid.exe
| |
− | lrwxrwxrwx 1 abc123 wrf 21 Aug 23 10:20 ungrib.exe -> ungrib/src/ungrib.exe
| |
− | </syntaxhighlight>
| |
− | <syntaxhighlight>
| |
− | [abc123@raijin3 WPS]$ ls -l */src/*.exe | |
− | | |
− | -rwx------ 1 abc123 wrf 3412782 Aug 23 10:19 geogrid/src/geogrid.exe
| |
− | -rwx------ 1 abc123 wrf 3206974 Aug 23 10:20 metgrid/src/metgrid.exe
| |
− | -rwx------ 1 abc123 wrf 1209622 Aug 23 10:20 ungrib/src/g1print.exe
| |
− | -rwx------ 1 abc123 wrf 1407507 Aug 23 10:20 ungrib/src/g2print.exe
| |
− | -rwx------ 1 abc123 wrf 2169010 Aug 23 10:20 ungrib/src/ungrib.exe
| |
− | -rwx------ 1 abc123 wrf 1184660 Aug 23 10:20 util/src/avg_tsfc.exe
| |
− | -rwx------ 1 abc123 wrf 1250303 Aug 23 10:20 util/src/calc_ecmwf_p.exe
| |
− | -rwx------ 1 abc123 wrf 1217842 Aug 23 10:20 util/src/height_ukmo.exe
| |
− | -rwx------ 1 abc123 wrf 953821 Aug 23 10:20 util/src/int2nc.exe
| |
− | -rwx------ 1 abc123 wrf 1118699 Aug 23 10:20 util/src/mod_levs.exe
| |
− | -rwx------ 1 abc123 wrf 3704627 Aug 23 10:20 util/src/plotfmt.exe
| |
− | -rwx------ 1 abc123 wrf 3409302 Aug 23 10:20 util/src/plotgrids.exe
| |
− | -rwx------ 1 abc123 wrf 916613 Aug 23 10:20 util/src/rd_intermediate.exe
| |
− | </syntaxhighlight>
| |
− | Note that there are some warnings in the build output like warning: overriding commands for target `.c.o'. These are harmless and can be ignored.
| |
− | | |
− | =<span style="background-color: #ffffff;">Tests run</span>=
| |
− | ----
| |
− | ==<span style="background-color: #ffffff;"><span id="Tests run-Compilation"></span>Compilation</span>==
| |
− | * <span style="background-color: #ffffff;">WRF compilation with dmpar</span>
| |
− | * <span style="background-color: #ffffff;">WRF compilation with dm+sm</span>
| |
− | * <span style="background-color: #ffffff;">WRF-Chem compilation with dmpar</span>
| |
− | * <span style="background-color: #ffffff;">WPS compilation with dmpar_NO_GRIB2 with dmpar compilation of WRF</span>
| |
− | * <span style="background-color: #ffffff;">WPS compilation with dmpar_NO_GRIB2 with dm+sm compilation of WRF</span>
| |
− | ==<span style="background-color: #ffffff;"><span id="Tests run-Tests simulations"></span>Tests simulations</span>==
| |
− | * <span style="background-color: #ffffff;">First tutorial case (Jan 00) with 1 nest</span>
| |
− | * <span style="background-color: #ffffff;">First tutorial case (Jan 00) with 2 nests</span>
| |