WPS Install

39
Installing and Running the WPS Michael Duda 2006 WRF-ARW Summer Tutorial

Transcript of WPS Install

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 1/39

Installing and Running the WPS

Michael Duda

2006 WRF-ARW Summer Tutorial

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 2/39

2006 WRF-ARW Summer Tutorial   1

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungrib

c) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 3/39

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 4/39

2006 WRF-ARW Summer Tutorial   3

0) Check system requirements

For the pre-release version of WPS, the onlysupported system configuration is

− Fedora Core 4 (& 5) Linux (32-bit)− Portland Group compilers

Required libraries

−   JasPer (JPEG 2000 “lossy” compression library)

−  PNG (“lossless” compression library)

−   zlib (compression library used by PNG)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 5/39

2006 WRF-ARW Summer Tutorial   4

0) Check system requirements

Required libraries (cont.)

−   NetCDF (needed by WRF and WPS)

−  NCAR Graphics (optional but recommended –

used by graphical utility programs)

Installation of these libraries is not part ofthe WPS installation script

− We recommend having a system administratorinstall the required libraries before installingWRF or WPS

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 6/39

2006 WRF-ARW Summer Tutorial   5

0) Check system requirements

Support for other systems will be addedbefore the official release (September 2006)

  geogrid and metgrid have been successfullycompiled on IBM, OSF, Solaris, and others

Compiling ungrib is trickier because of

required libraries

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 7/39

2006 WRF-ARW Summer Tutorial   6

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungrib

c) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 8/39

2006 WRF-ARW Summer Tutorial   7

1) Download source code

WPS is designed to work with WRF v2.2and later

− Users with earlier versions of WRF should upgrade

After WPS is released (September 2006)

− Download WPS. t ar file through WRFdownload page

− WPS will work with new WRF release (whichmust also be downloaded)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 9/39

2006 WRF-ARW Summer Tutorial   8

1) Download source code

For tutorial:

− Check online tutorial notes for location of source

code (probably / wr f hel p/ SOURCE_CODE)− Tutorial source code is bundled with required

version of WRF in file called WPS+WRFV2. t ar

− Copy the source code to your own directory

> cp / wr f hel p/ SOURCE_CODE/ WPS+WRFV2. t ar ~

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 10/39

2006 WRF-ARW Summer Tutorial   9

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungrib

c) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 11/39

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 12/39

2006 WRF-ARW Summer Tutorial   11

2) Download static terrestrial data

From WRF download page, get full set ofterrestrial data (all fields and resolutions)

Choose either format to download

− geog. t ar . bz2 – bzip2-compressed (242 MB)

(smaller file, but requires bzip2 to uncompress)

− geog. t ar . gz – gzip-compressed (372 MB)

(larger file, but more compatible)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 13/39

2006 WRF-ARW Summer Tutorial   12

2) Download static terrestrial data

The geog. t ar file contains the following:

albedo_ncep – monthly surface albedo

greenfrac – monthly vegetation fraction

islope – slope index

landuse – land use category (30”, 2’, 5’, and 10’

resolutions)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 14/39

2006 WRF-ARW Summer Tutorial   13

2) Download static terrestrial data

maxsnowalb – maximum snow albedo

soiltemp – annual mean deep soil temperature

soiltype_bot – bottom-layer soil type (30”, 2’, 5’,and 10’ resolutions)

soiltype_top – top-layer soil type (30”, 2’, 5’, and10’ resolutions)

topo – topography height (30”, 2’, 5’, and 10’resolutions)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 15/39

2006 WRF-ARW Summer Tutorial   14

2) Download static terrestrial data

For tutorial:

− All terrestrial data are located in a common

directory (check tutorial notes for exactlocation; probably/ wr f hel p/ GEOG_DATA/ WPS_GEOG)

Outside of the tutorial: uncompress thedata into a directory with ~10 GB ofavailable space!

> t ar xzf geog. t ar . gz

> r m –f geog. t ar . gz

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 16/39

2006 WRF-ARW Summer Tutorial   15

2) Download static terrestrial data

After uncompressing geog. t ar . gz

> l s

geog

> l s geog

al bedo_ncep l anduse_30s … …gr eenf r ac l anduse_5m … …

i sl ope maxsnowal b … …

l anduse_10m soi l t emp_1deg … …

l anduse_2m soi l t ype_bot _30s … …

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 17/39

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 18/39

2006 WRF-ARW Summer Tutorial   17

3) Install WRF

WPS requires WRF to be installed

− WPS programs use WRF I/O API libraries to do

file input and output− These I/O libraries are build when WRF is

installed

For information on how to install WRF,see the next lecture: “WRF ARW – How toset up and run?” by Dave Gill

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 19/39

2006 WRF-ARW Summer Tutorial   18

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungrib

c) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 20/39

2006 WRF-ARW Summer Tutorial   19

4) Install WPS

Recall the directory where the WPS sourcecode was downloaded (or copied) to

Change to that directory and un-tar thecode

> t ar xf WPS+WRFV2. t ar> cd WPS+WRFV2

> l s

WPS

WRFV2

Only for tutorial!After release, WRF

must be installedseparately (Step 3)

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 21/39

2006 WRF-ARW Summer Tutorial   20

4) Install WPS

For the tutorial: uncompressing WPSsource code also gives WRF code

− Let us assume that WRF has already beencompiled in Step 3

Change to the WPS directory andconfigure WPS for installation

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 22/39

2006 WRF-ARW Summer Tutorial   21

4) Install WPS

> cd WPS

> . / conf i gur e

Wi l l use NETCDF i n di r : / st andal one/ l ocal / net cdf - pgi

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Pl ease sel ect f r om among t he f ol l owi ng suppor t ed pl at f or ms.

1. PC Li nux i 486 i 586 i 686, PGI compi l er ser i al

2. PC Li nux i 486 i 586 i 686, PGI compi l er DM par al l el

3. PC Li nux i 486 i 586 i 686, I nt el compi l er ser i al

4. PC Li nux i 486 i 586 i 686, I nt el compi l er DM par al l el

Ent er sel ect i on [ 1- 4] :

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 23/39

2006 WRF-ARW Summer Tutorial   22

4) Install WPS

When prompted by the configure script,select an option

Ent er sel ect i on [ 1- 4] : 1

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Conf i gur at i on successf ul . To bui l d t he WPS, t ype: compi l e

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 24/39

2006 WRF-ARW Summer Tutorial   23

4) Install WPS

If configuration was successful, compile:

> . / compi l e >&! compi l e. out put

After compilation, executables shouldexist in top-level WPS directory:

> l s –L *. exe

geogr i d. exemet gr i d. exe

ungr i b. exe

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 25/39

2006 WRF-ARW Summer Tutorial   24

4) Install WPS

If NCAR Graphics libraries are available:

> . / compi l e ut i l >&! ut i l . out put

After compilation, check for newexecutables:

> l s –L *. exe

geogr i d. exe pl ot f mt . exegr i bpr i nt . exe pl ot gr i ds. exe

met gr i d. exe ungr i b. exe

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 26/39

2006 WRF-ARW Summer Tutorial   25

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data

3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungribc) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 27/39

2006 WRF-ARW Summer Tutorial   26

5) Running WPS

Briefly recall the data flow among programs:

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 28/39

2006 WRF-ARW Summer Tutorial   27

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data

3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungribc) metgrid

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 29/39

2006 WRF-ARW Summer Tutorial   28

5a) Running geogrid 

Basic steps to run geogrid 

1) Edit namel i st . wps in the WPS directory

- define projection and domain locations

- specify path to static terrestrial data

A note about editing namel i st . wps:When running the WPS program<program_name >, it is only necessary to set

variables in the sections &share and&<program_name >

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 30/39

2006 WRF-ARW Summer Tutorial   29

5a) Running geogrid 

2) Run geogrid.exe 

3) Check geogrid output

- Did geogrid run successfully?

! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !

! Successf ul compl et i on of geogr i d. !

! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !

- Do geo_em. d0N. nc files exist?

- Are the domains in their expected

locations?

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 31/39

2006 WRF-ARW Summer Tutorial   30

5a) Running geogrid 

geogrid

ungrib

metgrid

geo_em.d01.ncgeo_em.d02.nc…

real exe

After runninggeogrid, weshould havethese files

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 32/39

2006 WRF-ARW Summer Tutorial   31

Basic Steps

0) Check system requirements1) Download source code

2) Download static terrestrial data

3) Install WRF

4) Install WPS

5) Run

a) geogrid

b) ungribc) metgrid

b) b

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 33/39

2006 WRF-ARW Summer Tutorial   32

5b) Running ungrib 

Basic steps to run ungrib 

1) Edit namel i st . wps

- specify starting and ending times for

domains

- specify interval of available data2) Link the proper Vtable to the file Vt abl e

3) Link first-guess GRIB files toGRI BFI LE. AAA, GRI BFI LE. AAB, …

b) b

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 34/39

2006 WRF-ARW Summer Tutorial   33

5b) Running ungrib 

Basic steps to run ungrib (cont.)4) Run ungrib.exe 

5) Check ungrib output- Did ungrib run successfully?

! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !

! Successf ul compl et i on of ungr i b. !

! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !

- Do FI LE: YYYY - MM - DD _ HH files exist?

- Are all of the expected fields in the

ungrib output files?

b) b

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 35/39

2006 WRF-ARW Summer Tutorial   34

5b) Running ungrib 

geogrid

ungrib

metgrid

geo_em.d01.ncgeo_em.d02.nc…

FILE:2006-07-22_00FILE:2006-07-22_06FILE:2006-07-22_12…

real exe

GRIB files

After runningungrib, we shouldhave files similarto these

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 36/39

5 ) R i id

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 37/39

2006 WRF-ARW Summer Tutorial   36

5c) Running metgrid 

Basic steps to run metgrid 1) Edit namel i st . wps

- specify starting and ending times for all grids- specify path and prefix of ungrib output

2) Run metgrid.exe 3) Check metgrid output

- Did metgrid run successfully?

- Do met _em. d0N. YYYY- MM- DD_HH. nc

files exist?

5 ) R i id

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 38/39

2006 WRF-ARW Summer Tutorial   37

5c) Running metgrid 

geogrid

ungrib

metgrid

geo_em.d01.ncgeo_em.d02.nc…

FILE:2006-07-22_00FILE:2006-07-22_06FILE:2006-07-22_12…

met_em.d01.2006-07-22_00.ncmet_em.d01.2006-07-22_06.ncmet_em.d01.2006-07-22_12.nc

met_em.d02.2006-07-22_00.nc

real exe

GRIB files

After running metgrid,we should have filessimilar to these

5) S

8/11/2019 WPS Install

http://slidepdf.com/reader/full/wps-install 39/39

2006 WRF-ARW Summer Tutorial

5) Summary

The basic steps to running each WPS programcan be summarized as:

− Set variables in the &shar e and &< program name>sections in the namel i st . wps file

E.g., for metgrid, edit &share and &metgrid sections

− For ungrib, link Vt abl e and GRI BFI LE. ??? files

− Run the program executable

− Check that the proper output files exist andcontain good data