Personal tools
User menu

Difference between revisions of "Installing WRF-GC"

From atmoschem

Jump to: navigation, search
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).  
  
= Setting up WRF-GC =
+
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.
  
'''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.
+
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.
  
Please refer to the following documentation to set up WRF:
+
= Installing up WRF-GC =
  
WRF User's Guide: http://www2.mmm.ucar.edu/wrf/users/docs/user_guide_V3.9/users_guide_chap1.htm
+
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:
  
• Download Page: http://www2.mmm.ucar.edu/wrf/users/downloads.html
+
* Set the environmental variables WRF_EM_CORE = 1, WRF_NMM_CORE = 0, and WRF_CHEM = 1 in your shell.
  
'''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, drop in the WRF-GC code with the bundled GEOS-Chem version in a folder named "chem".
+
* 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.**
  
= Installing WRF-GC =
+
* Compile WRF-GC using the ./compile em_real command.
  
 
+
We suggest you to review the [WRF User's Guide http://www2.mmm.ucar.edu/wrf/users/docs/user_guide_V3.9/users_guide_chap1.htm] for additional installation information.
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 like WRF-Chem: ./compile em_real
+

Revision as of 23:18, 25 December 2018

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.

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

Installing up 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 suggest you to review the [WRF User's Guide http://www2.mmm.ucar.edu/wrf/users/docs/user_guide_V3.9/users_guide_chap1.htm] for additional installation information.