Personal tools
User menu

Difference between revisions of "Installing WRF-GC"

From atmoschem

Jump to: navigation, search
 
(6 intermediate revisions by one other user not shown)
Line 4: Line 4:
 
Recommended system setup (as tested):
 
Recommended system setup (as tested):
  
* Compiler: Intel 15.
+
* Compiler: [https://software.intel.com/en-us/intel-compilers Intel 15]. There is limited support for the PGI and gfortran compilers.
  
 
* [http://mvapich.cse.ohio-state.edu/downloads/ MPI Library: MVAPich2 Version 2.3]
 
* [http://mvapich.cse.ohio-state.edu/downloads/ MPI Library: MVAPich2 Version 2.3]
Line 18: Line 18:
 
* [https://www.ece.uvic.ca/~frodo/jasper/#download JasPer 1.900.29]
 
* [https://www.ece.uvic.ca/~frodo/jasper/#download JasPer 1.900.29]
  
It is recommended that you install all libraries in the same location (using the --prefix=/your/directory/here when calling the configure script). For WRF to correctly find those libraries, you need to set the HDF5 & NETCDF environmental variables to point to the directory (which includes the bin, lib, include directories) where those libraries are installed.
+
It is recommended that you install all libraries in the same location (using the --prefix=/your/directory/here when calling the configure script).  
  
'''Obtain the WRF model and the WPS pre-processing system.''' Recommended version is WRF v3.9.1.1. At present, only WRF version 3.9+ is supported as it provides the hybrid sigma-eta vertical grid functionality required by GEOS-Chem. Version 4.0 is supported but requires modifications to the code.
+
For WRF to correctly find those libraries, you need to set the HDF5 & NETCDF environmental variables to point to the directory (which includes the bin, lib, include directories) where those libraries are installed.  
  
Please refer to:
+
For example, if you have used /your/directory/here below, you should be able to see bin, lib and include directories under this directory and point the necessary environmental variables to them:
  
• WRF User’s Guide: http://www2.mmm.ucar.edu/wrf/users/docs/user_guide_V3.9/users_guide_chap1.htm
+
    $ ls /your/directory/here
 +
    bin  lib  share  include
  
• Download Page: http://www2.mmm.ucar.edu/wrf/users/downloads.html
+
    $ export HDF5="/your/directory/here"
 +
    $ export NETCDF=$HDF5
  
'''Obtain the GEOS-Chem model and WRF-GC interface.''' After downloading the WRF model, go into the WRF or WRFV3 directory (depending on your WRF version). In the folder where arch, dyn_em, main … folders are located in, use the following command to check-out the WRF-GC source code repository into the “chem” folder:
+
You are also recommended to review the [http://wiki.seas.harvard.edu/geos-chem/index.php/Installing_libraries_for_GEOS-Chem GEOS-Chem library installation] guide.
  
```
+
= Installing WRF-GC =
to be available soon
+
```
+
+
As of time of writing, the WRF-GC interface’s bundled version of GEOS-Chem is GEOS-Chem 12.2.0.
+
  
 +
After obtaining the WRF and WRF-GC code in the [[Downloading WRF-GC]] step, you will need to set up the compile environment as follows:
  
 +
* Set the environmental variables WRF_EM_CORE = 1, WRF_NMM_CORE = 0, and WRF_CHEM = 1 in your shell.
  
 +
* Configure WRF using the hybrid sigma-eta grid option using the configure script, setting the distributed-memory parallel (dmpar) version of WRF with the Intel C and Fortran compilers. There is limited support for PGI and gfortran compilers, but they are not recommended for this alpha build.
  
= Installing WRF-GC =
+
* After configuration please navigate to the WRF-GC "chem" directory, and issue the following command: make install_registry. '''This step is critical and must be done manually before compilation.'''
Please refer to the WRF User’s Guide for installation, taking note that:
+
• Set the NETCDF, HDF5 environment variables, JASPERLIB and JASPERINC to the respective “lib” and “include” directories, and WRF_EM_CORE to 1, WRF_NMM_CORE to 0, WRF_CHEM to 1.
+
 
+
• The configure command must include the hybrid grid option: ./configure -hyb
+
 
+
• Choose the distributed-memory parallel (dmpar) version of WRF, with Intel C & Fortran compilers
+
  
• Before compiling, go into the “chem” subdirectory and install the WRF-GC registry: make install_registry
+
* Compile WRF-GC using the ./compile em_real command.
  
• Compile WRF-GC like WRF-Chem: ./compile em_real
+
We recommend that you review the [http://www2.mmm.ucar.edu/wrf/users/docs/user_guide_V3.9/users_guide_chap1.htm WRF User's Guide (v3.9)] for additional installation information.

Latest revision as of 08:28, 4 January 2019

System Requirements

WRF-GC requires a set of compilers and libraries that are compatible with the WRF model and the GEOS-Chem High Performance model.

Recommended system setup (as tested):

  • Compiler: Intel 15. There is limited support for the PGI and gfortran compilers.
  • NetCDF-Fortran 4.4.4

It is recommended that you install all libraries in the same location (using the --prefix=/your/directory/here when calling the configure script).

For WRF to correctly find those libraries, you need to set the HDF5 & NETCDF environmental variables to point to the directory (which includes the bin, lib, include directories) where those libraries are installed.

For example, if you have used /your/directory/here below, you should be able to see bin, lib and include directories under this directory and point the necessary environmental variables to them:

   $ ls /your/directory/here
   bin  lib  share  include
   $ export HDF5="/your/directory/here"
   $ export NETCDF=$HDF5

You are also recommended to review the GEOS-Chem library installation guide.

Installing WRF-GC

After obtaining the WRF and WRF-GC code in the Downloading WRF-GC step, you will need to set up the compile environment as follows:

  • Set the environmental variables WRF_EM_CORE = 1, WRF_NMM_CORE = 0, and WRF_CHEM = 1 in your shell.
  • Configure WRF using the hybrid sigma-eta grid option using the configure script, setting the distributed-memory parallel (dmpar) version of WRF with the Intel C and Fortran compilers. There is limited support for PGI and gfortran compilers, but they are not recommended for this alpha build.
  • After configuration please navigate to the WRF-GC "chem" directory, and issue the following command: make install_registry. This step is critical and must be done manually before compilation.
  • Compile WRF-GC using the ./compile em_real command.

We recommend that you review the WRF User's Guide (v3.9) for additional installation information.

  • This page was last modified on 4 January 2019, at 08:28.
  • This page has been accessed 6,174 times.