hh This page is meant to provide gu

hh

This page is meant to provide guidance through the steps of compiling WRF. It will take a beginning user through the processes of ensuring the computer environment is set up correctly, to testing the components and their compatibility with each other, then to installing WRFV3 and WPS, and finally to some guidance for preparing to run WPS and then WRFV3.

Click on a tab below for quick navigation. If you are a beginner, it is recommended to start at the beginning and follow through each step.






**IMPORTANT NOTES: PLEASE READ BEFORE CONTINUING!

In order to use personal machines, you must have all the pre-required programs and compilers built, as well as their functionality/compatibility verified through testing. We cannot be responsible or provide assistance for the installation of Linux, Linux utilities, or the compilers.

We are attempting to walk you through the steps for building necessary libraries (netCDF, MPICH, JasPer, Libpng, and Zlib); however, if you experience errors, we cannot be responsible for helping to correct the errors, as these are related to your particular system, and are not supported by our wrfhelp group. You will need to contact someone in your systems administation office, or go to the library websites to contact someone in their support group for assistance.

All of the examples given here are in tcsh. If you are very familiar with another shell (e.g., bash), and feel comfortable making the necessary alterations to the commands, then feel free to use your other shell. If not, however, we recommend using tcsh.



System Environment Tests

First and foremost, it is very important to have a gfortran compiler, as well as gcc and cpp. To test whether these exist on the system, type the following:

which gfortran
which cpp
which gcc

If you have these installed, you should be given a path for the location of each.

We recommend using gfortran version 4.4.0 or later. To determine the version of gfortran you have, type:

gcc --version


Create a new, clean directory called Build_WRF, and another one called TESTS.


There are a few simple tests that can be run to verify that the fortran compiler is built properly, and that it is compatible with the C compiler. Below is a tar file that contains the tests. Download the tar file and place it in the TESTS directory.

Fortran and C Tests Tar File

To unpack the tar file, type:

tar -xf Fortran_C_tests.tar

There are 7 tests available, so start at the top and run through them, one at a time.

Test #1: Fixed Format Fortran Test: TEST_1_fortran_only_fixed.f

Type the following in the command line:

gfortran TEST_1_fortran_only_fixed.f

Now type:

./a.out

The following should print out to the screen:

SUCCESS test 1 fortran only fixed format



Test #2: Free Format Fortran: TEST_2_fortran_only_free.f90

Type the following in the command line:

gfortran TEST_2_fortran_only_free.f90

and then type:

./a.out

The following should print out to the screen:

Assume Fortran 2003: has FLUSH, ALLOCATABLE, derived type, and ISO C Binding
SUCCESS test 2 fortran only free format



Test #3: C: TEST_3_c_only.c

Type the following in the command line:

gcc TEST_3_c_only.c

and then type:

./a.out

The following should print out to the screen:

SUCCESS test 3 c only



Test #4: Fortran Calling a C Function (our gcc and gfortran have different defaults, so we force both to always use 64 bit [-m64] when combining them): TEST_4_fortran+c_c.c, and TEST_4_fortran+x_f.f90

Type the following in the command line:

gcc -c -m64 TEST_4_fortran+c_c.c

and then type:

gfortran -c -m64 TEST_4_fortran+c_f.f90

and then:

gfortran -m64 TEST_4_fortran+c_f.o TEST_4_fortran+c_c.o

and then issue:

./a.out

The following should print out to the screen:

C function called by Fortran
Values are xx = 2.00 and ii = 1
SUCCESS test 4 fortran calling c


In addition to the compilers required to manufacture the WRF executables, the WRF build system has scripts as the top level for the user interface. The WRF scripting system uses, and therefore having the following is necessary:

csh
perl
sh

To test whether these scripting languages are working properly on the system, there are 3 tests to run. These tests were included in the "Fortran and C Tests Tar File".

Test #5:csh In the command line, type:

./TEST_csh.csh

The result should be:

SUCCESS csh test



Test #6:perl In the command line, type:

./TEST_perl.pl

The result should be:

SUCCESS perl test



Test #7:sh In the command line, type:

./TEST_sh.sh

The result should be:

SUCCESS sh test


Finally, inside the scripts are quite a few UNIX commands that are available regardless of which shell is used. The following standard UNIX commands are mandatory:

ar head sed
awk hostname sleep
cat ln sort
cd ls tar
cp make touch
cut mkdir tr
expr mv uname
file nm wc
grep printf which
gzip rm m4

Go to top of page



<

Building Libraries

Before getting started, you need to make another directory. Go inside your Build_WRF directory:

cd Build_WRF

and then make a directory called "LIBRARIES"

mkdir LIBRARIES

Depending on the type of run you wish to make, there are various libraries that should be installed. Below are 5 libraries. Download all 5 tar files and place them in the LIBRARIES directory.

mpich-3.0.4
netcdf-4.1.3
Jasper-1.900.1
libpng-1.2.50
zlib-1.2.7

It is important to note that these libraries must all be installed with the same compilers as will be used to install WRFV3 and WPS.


NetCDF: This library is always necessary!

setenv DIR path_to_directory/Build_WRF/LIBRARIES
setenv CC gcc
setenv CXX g++
setenv FC gfortran
setenv FCFLAGS -m64
setenv F77 gfortran
setenv FFLAGS -m64

tar xzvf netcdf-4.1.3.tar.gz #or just .tar if no .gz present
cd netcdf-4.1.3
./configure --prefix=$DIR/netcdf --disable-dap
--disable-netcdf-4 --disable-shared
make
make install
setenv PATH $DIR/netcdf/bin:$PATH
setenv NETCDF $DIR/netcdf
cd ..


MPICH: This library is necessary if you are planning to build WRF in parallel. If your machine does not have more than 1 processor, or if you have no need to run WRF with multiple processors, you can skip installing MPICH.

In principle, any implementation of the MPI-2 standard should work with WRF; however, we have the most experience with MPICH, and therefore, that is what will be described here.

Assuming all the 'setenv' commands were already issued while setting up NetCDF, you can continue on to install MPICH, issuing each of the following commands:


tar xzvf mpich-3.0.4.tar.gz #or just .tar if no .gz present
cd mpich-3.0.4
./configure --prefix=$DIR/mpich
make
make install
setenv PATH $DIR/mpich/bin:$PATH
cd ..


zlib: This is a compression library necessary for compiling WPS (specifically ungrib) with GRIB2 capability
Assuming all the "setenv" commands from the NetCDF install are already set, you can move on to the commands to install zlib.

setenv LDFLAGS -L$DIR/grib2/lib
setenv CPPFLAGS -I$DIR/grib2/include

tar xzvf zlib-1.2.7.tar.gz #or just .tar if no .gz present
cd zlib-1.2.7
./configure --prefix=$DIR/grib2
make
make install
cd ..


libpng: This is a compression library necessary for compiling WPS (specifically ungrib) with GRIB2 capability
Assuming all the "setenv" commands from the NetCDF install are already set, you can move on to the commands to install zlib.

tar xzvf libpng-1.2.50.tar.gz #or just .tar if no .gz present
cd libpng-1.2.50
./configure --prefix=$DIR/grib2
make
make install
cd ..


JasPer: This is a compression library necessary

結果 (日本語) 1:

HH このページは、WRFのコンパイル段階を通してガイダンスを提供することを意味します。これは、コンポーネントと互いとの互換性をテストするには、正しく設定されているコンピュータ環境を確保する過程を経て始めてユーザーがかかります、その後WRFV3とWPSをインストールすると、最終的にはWPS、その後WRFV3を実行するために調製するためのいくつかのガイダンスへ。迅速なナビゲーションのための以下のタブをクリックします。あなたが初心者であれば、先頭から開始し、各工程を経て従うことをお勧めします。**重要事項：続行する前にお読みください個人的なマシンを使用するためには、必要なすべての事前に構築されたプログラムやコンパイラを持っている必要があり、だけでなく、テストによって確認され、それらの機能性/互換性。当社は責任を負うことやLinux、Linuxユーティリティ、またはコンパイラのインストールのための支援を提供することはできません。私たちは建物のライブラリ（NetCDFファイル、MPICH、ジャスパー、libpngは、およびZlibの）ために必要な手順を順を追ってしようとしています。あなたは、エラーが発生した場合しかし、我々はこれらがあなたの特定のシステムに関連しているとして、エラーを訂正するのを助けるために責任を負うことはできません、と私たちのwrfhelpグループによってサポートされていません。あなたは、あなたのシステムのadministationオフィスで誰かに連絡する必要がある、または支援のための彼らのサポートグループの誰かに連絡して、ライブラリのウェブサイトに移動します。ここに挙げた例はすべてのtcshです。あなたが別のシェル（例えば、bashの）に精通しており、コマンドに必要な変更を作る快適に感じる場合は、あなたの他のシェルを使用して自由に感じます。そうでない場合は、しかし、我々はtcshを使用してお勧めします。システム環境は、テストまず第一に、それはのgfortranコンパイラと同様に、gccとCPPを持っていることは非常に重要です。これらがシステムに存在するかどうかをテストするには、次のように入力します。これのgfortranするCPPいるgccの。あなたはこれらがインストールされている場合は、それぞれの場所のパスを指定する必要があります私たちはのgfortranバージョン4.4.0以降を使用することをお勧めします。あなたは、タイプ持っているのgfortranのバージョンを確認するには：--versionのgccを。Build_WRFと呼ばれる新しい、クリーンなディレクトリを作成し、及び試験と呼ばれる別のものをFORTRANコンパイラが適切に構築されていることを確認するために実行することができますいくつかの簡単なテストがありますが、それは、Cコンパイラと互換性があること。以下のテストが含まれているtarファイルです。tarファイルをダウンロードし、ディレクトリテストに配置します。FortranとCはtarファイルをテストし、tarファイルを解凍するには、次のように入力しますFortran_C_tests.tar -xfタール7テストが利用可能がありますので、上部に開始し、で、それらを介していずれかを実行します。。時間テスト＃1：固定形式のFortranテスト：TEST_1_fortran_only_fixed.fコマンドラインで次のように入力します。のgfortran TEST_1_fortran_only_fixed.fは今入力します。./a.out画面にプリントアウトする必要があり、以下：SUCCESS試験1 FORTRANのみ固定フォーマットテスト＃2：無料フォーマットFortranは：TEST_2_fortran_only_free.f90 ：コマンドラインに次のように入力のgfortran TEST_2_fortran_only_free.f90 ：[種類を./a.out 画面にプリントアウトする必要があり、次のFortran 2003のを想定します、割り当て可能なフラッシュを持っています、派生型、およびISO Cバインディング成功テスト2 FORTRANのみフリーフォーマットテスト＃3：C：TEST_3_c_only.cコマンドラインで次のように入力します。GCC TEST_3_c_only.c：し入力./a.out以下は、プリントアウトする必要があります画面に：SUCCESSテスト3 Cのみテスト＃4：Fortranの（私たちのgccとのgfortranは異なるデフォルト値を持っているので、我々はそれらを組み合わせたときに64ビット[-m64]を使用して、常に両方に強制）は、C関数を呼び出す：TEST_4_fortran + c_c.cそして、TEST_4_fortranは+ x_f.f90 ：コマンドラインに次のように入力のgcc -c -m64 TEST_4_fortran + c_c.c [種類：-c -m64のgfortran TEST_4_fortran + c_f.f90 、その後：のgfortran -m64 TEST_4_fortran + c_f.oをTEST_4_fortran + c_c.oし、問題：./a.out次の画面にプリントアウトする必要があります。Fortranが呼び出されるC関数の値は、x = 2.00とI = 1であり、Cを呼び出す成功テスト4 FORTRANに必要なコンパイラに加えて、 WRFの実行可能ファイルを製造、WRFのビルドシステムは、ユーザインタフェースの最上位としてスクリプトを持っています。WRFスクリプティングシステムが使用するため、次を持つことが必要です：cshの真珠SHこれらは、システム上のスクリプト言語で正しく動作しているかどうかをテストするには、実行するための3つのテストがあります。これらのテストは、中に含まれていた「FortranとCはtarファイルをテストします」。テスト＃5：cshのコマンドラインで、次のように入力します./TEST_csh.csh結果は次のようになります。SUCCESS cshのテスト、コマンドラインでのperl：テスト＃6 タイプ：./TEST_perl.pl結果は次のようになります。SUCCESS Perlのテストテスト＃7：コマンドラインではSH、タイプ：./TEST_sh.sh結果は次のようになります。SUCCESS shのテスト最後に、スクリプトはかなりの数のUNIXです内側関係なく、シェルの使用可能なコマンドが使用されます。次の標準のUNIXコマンドは必須です。ARヘッドのsed awkのホスト名の睡眠猫のソートLN LS CDのtar CPは、タッチ作るカットをTRます。mkdir MV式exprのuname nmのWCファイルのgrep printf関数のgzip RM M4ページのトップへ戻る<ライブラリの構築始める前に、あなたは別のディレクトリを作成する必要があります。あなたのBuild_WRFディレクトリ内行く：CD Build_WRFし、「ライブラリ」というディレクトリ作ります。mkdirライブラリはあなたが作るしたいランの種類に応じて、インストールする必要があり、様々なライブラリがあります。以下は5ライブラリがあります。すべての5 tarファイルをダウンロードして、ライブラリディレクトリに配置します。MPICH-3.0.4 のNetCDF-4.1.3 ジャスパー-1.900.1 のlibpng-1.2.50 のzlib-1.2.7 これは、これらのライブラリをすべてインストールする必要があることに注意することが重要です。WRFV3とWPSをインストールするために使用されるのと同じコンパイラで！このライブラリは常に必要です：NetCDFファイルのsetenv path_to_directory DIR / Build_WRF /ライブラリのsetenv CC gccのCXX G ++のsetenvのsetenv FCのgfortranのsetenv FCFLAGS -m64 F77のgfortranのsetenvのsetenv FFLAGS -m64タールxzvfのNetCDF-4.1.3.tar.gz #orだけの.tar .gzの存在がない場合は、CDのNetCDFファイル-4.1.3に./configure --prefix = $ DIR / NetCDFの--disable-DAP --disable-のnetCDF-4 --disable-共有makeがmake installを$ PATHの場合setenv PATH $ DIR / NetCDFファイル/ binがのsetenvのNetCDF $ DIR / NetCDFのCD .. MPICH：このライブラリを必要とするあなたは、並列にWRFを建設することを計画している場合。あなたのマシンに複数のプロセッサを持っていない場合は、複数のプロセッサを搭載したWRFを実行する必要がない場合、または、あなたはMPICHのインストールをスキップすることができます。基本的には、MPI-2標準のいずれかの実装では、WRFで動作するはずです。。しかし、私たちは、MPICHで最も経験を持っているので、それはここで説明するものである次の各コマンドを発行し、NetCDFファイルを設定しながら、すべての「のsetenv "コマンドが既に発行された、あなたはMPICHをインストールするに続けることができると仮定すると、 ：ちょうど#or存在する場合の.tarなしの.gz xzvf MPICH-3.0.4.tar.gzタールCDのMPICH-3.0.4に./configure --prefix = $ DIR / MPICHを作るmake installをのsetenv PATH $ DIR / MPICH / binが：$パスCD .. ZLIB：これはGRIB2機能を備えたWPS（特にungrib）コンパイルするために必要な圧縮ライブラリであるNetCDFのインストールからすべての "のsetenv"コマンドがすでに設定されていると仮定し、あなたがZLIBをインストールするためのコマンドに進むことができます。 setenv LDFLAGS -L $ DIR / GRIB2 / libののsetenv CPPFLAGS -I $ DIR / GRIB2 /含めるだけ#orがない場合は.gzというの.tar存在xzvfのzlib-1.2.7.tar.gzタールのCDのzlib-1.2.7 に./configureを--prefix = $ DIR / GRIB2作るmake installを.. CDをのlibpng：これは、WPSをコンパイルするために必要な圧縮ライブラリである（具体的にungrib）GRIB2機能を持つのNetCDFインストールからすべて"のsetenv"コマンドを想定すると、すでに設定されている、あなたが移動することができますコマンドへのzlibモジュールをインストールする。xzvfのlibpngタール-1.2.50.tar.gz #orだけの.tar .gzの存在なした場合、CDのlibpng-2.1.50に./configure --prefix = $ DIR / GRIB2は行いませんmake installをCDに.. ジャスパー：これは、必要な圧縮ライブラリであります