This guide is intended to help build WRF Version 3.2.1 on Linux with PGI 2011 compilers.

Version Information

This guide was created for WRF version 3.2.1 release and the PGI 2011 release. This information is for both x64 processors running 64-bit Linux or x86 processors running 32-bit Linux.

Application Notes

Information about The Weather Research and Forecasting (WRF) Model can be found at the WRF home page.

Obtaining the Source Code

You may obtain the source for WRF Version 3.2.1 from the WRF Users Page after filling in the registration information at the bottom of the page. While the source is freely available, you will be asked to register if you are a new user.


A netCDF package built using the same major version of the PGI compilers is required. Please refer to the PGI Guide to netCDF for more information on building netCDF.

Configuration and Set-up Information

  1. Unzip and untar your WRF package and cd to the created WRFV3 directory.
  2. Please review chapter 2 of the WRF user's guide and the README file included with your WRF source.
  3. Set the environmental variable NETCDF to the location of your netCDF installation. NetCDF must be installed before you can continue. See PGI Guide to netCDF for informantion on how to build netCDF.
  4. Run:


    and select the configuration type, Serial, OpenMP, or MPI.

Building WRF

To build WRFV3, use

./compile <case_name>

where <case_name> is one of the following: em_b_wave, em_hill2d_x, em_grav2d_x, em_quarter_ss, em_squall2d_x, em_squall2d_y, or em_real. All but em_real are idealized test cases. We suggest you separately build and run each test case to ensure your installation is correct. If all the test cases are correct, then build the em_real case.

Running WRF

Please refer to the WRF user's guide for more information about running a real case. For the idealized cases, please refer to the README_test_cases file located in the root of your WRFV3 directory.

To run each idealized case,

  1. cd to the test case directory, WRFV3/test/<case_name>
  2. Run the file run_me_first.csh, if it exsists.
  3. Run ideal.exe
  4. Run wrf.exe

Verifying Correctness

Each test case should print "SUCCESS" upon completion.

Known Issues and Limitations


Click me