Personal tools
User menu

Difference between revisions of "Installing WRF-GC"

From atmoschem

Jump to: navigation, search
(→‎System Requirements)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
== System Requirements ==
+
= System Requirements =
−
WRF-GC requires a set of compilers & libraries that are compatible with the WRF model & the GEOS-Chem High Performance model.
+
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):
 
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.
  
−
- MPI Library: MVAPich2 Version 2.3 (http://mvapich.cse.ohio-state.edu/downloads/)
+
* [http://mvapich.cse.ohio-state.edu/downloads/ MPI Library: MVAPich2 Version 2.3]
  
−
- zlib (http://www.zlib.net/)
+
* [http://www.zlib.net/ zlib]
  
−
- HDF5 1.8 (https://support.hdfgroup.org/HDF5/release/obtainsrc518.html)
+
* [https://support.hdfgroup.org/HDF5/release/obtainsrc518.html HDF5 1.8]
  
−
- NetCDF-C 4.6.1 (https://www.unidata.ucar.edu/downloads/netcdf/index.jsp)
+
* [https://www.unidata.ucar.edu/downloads/netcdf/index.jsp NetCDF-C 4.6.1]
  
−
- NetCDF-Fortran 4.4.4
+
* NetCDF-Fortran 4.4.4
  
−
- JasPer 1.900.29 (https://www.ece.uvic.ca/~frodo/jasper/#download)
+
* [https://www.ece.uvic.ca/~frodo/jasper/#download JasPer 1.900.29]
  
−
It is recommended to 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. 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.
+
  
−
== 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:
−
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
+
* Set the environmental variables WRF_EM_CORE = 1, WRF_NMM_CORE = 0, and WRF_CHEM = 1 in your shell.
  
−
• Choose the distributed-memory parallel (dmpar) version of WRF, with Intel C & Fortran compilers
+
* 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.
  
−
• Before compiling, go into the “chem” subdirectory and install the WRF-GC registry: make install_registry
+
* 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 like WRF-Chem: ./compile em_real
+
* Compile WRF-GC using the ./compile em_real command.
 +
 
 +
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.

Retrieved from "http://atmoschem.org.cn/index.php?title=Installing_WRF-GC&oldid=1607"
  • This page was last modified on 4 January 2019, at 08:28.
  • This page has been accessed 6,166 times.