Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Download & build process of wrf model with all dependencies
Shell Emacs Lisp
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
apps Fix WRFDA link.
build * build/WRF.sh: don't copy but link executables.
doc Cleanup the horrible README. may need more revisions.
gcc * gcc/compiler.env: add more compilar options
intel * intel/compiler.env: (-xP) remove deprecated flag.
lib minor enhancement to last commit.
pgi * pgi/compiler.env: update compiler options
playbooks * playbooks/vm.yml: change name to trusty64
sgi * sgi/intel.env: latest intel has different folder structure.
test add colour functions
tools * AUTHORS: new file
ubuntu Added auto selection files for gcc
xl * .dir-locals.el: clean up file local variables
.dir-locals.el * .dir-locals.el: fix dir-locals to get env file to sh-mode.
.gitignore .gitignore: cleanup; ignore .vagrant
AUTHORS * AUTHORS: new file
COPYING Put license file.
README.rst github bailed out in rendering. trail and error.
SOURCEME * SOURCEME: don't use readlink since mac os has very old version.
Vagrantfile Optional URL boxes added in the Vagrantfile
build_app.sh build_app.sh: Comment out LIBPNG and NCVIEW as they are optional.
dev.org Cleanup the horrible README. may need more revisions.
download_app.sh mkdir base directories if not available.

README.rst

Website: https://github.com/yyr/wrf_install


Introduction
============

Building WRF model is tedious. `wrf_install` is a collection of shell
scripts(to be precise bash shell) that let you automate the downloading and
building processes. `wrf_install` is first written by Rick Morgans, so first
thanks to Rick.


How to use?
===========

*First suggestion is try to read and understand the scripts.*,

.. DANGER::
   **Go slow for the first time**

That said, here is very sketchy walk through:

Start with sourcing the SOURCEME file. By default, the build will take place
in "~/wrf" directory. Edit SOURCEME file if you want to change the location of
the installation(`WRF_BASE` variable). Set the compiler Option as well and
source that file.


Lets begin by building one dependency first. As mentioned open the SOURCEME
file with your editor, look for customization options.

Customize if you feel necessary:

-  `WRF_BASE` variable. i.e., Directory in which
   downloads/installation should take place. By default it is "~/wrf".

-  Which compilers you want to use. Again by default it is GNU gcc. if
   you have intel instead of gcc compilers. change them accordingly
   (There are comments in that file,it must be easy).


Okay now lets build `zilb` now.

.. code:: bash

   source SOURCEME # this is where you start
   ./download_app.sh ZLIB # download zlib and decompress it
   ./build_app.sh ZLIB


That's it. If everything has gone well as it supposed to be, you have just
downloaded and built & installed `zlib` successfully . See in the
$`WRF_BASE`/$compiler directory.

I strongly **suggest** you to install the components one by one for the
first time around. So its easy for you to see what is going on and
understand how `wrf_install` work.

The following list of components you can install right now.

-  zlib
-  szip
-  jpeg
-  jasper
-  hdf5
-  udunits2
-  netcdf4
-  ncview
-  mpich
-  wrf
-  wps


**Note**: The above order is important. Don't ignore previous errors and go
ahead with next component unless of course you know what you are doing.


Little details on How it works?
------------------------------

`wrf_install` is meant to bring consistency in setting up environment
variables and compiler options. When SOURCEME file is sourced, it will set
`WRF_BASE` variable and compiler options. The sourcing also gives you feedback
what are the compiler options has been set.

Each app has env file which contains few properties(eg., *url* from where that
app can be downloaded) of that app. for eg., zlib has a property file called
``apps/ZLIB.env`` and a build file called ``build/ZLIB.sh``.

Same way, each app has a associated `APP.env` file and a `APP.sh` file in apps
and build directories respectively.  `APP.sh` in build directory which takes
care of building and installation process while learning about app's
properties from `APP.env` file.. luckily most of the apps that need for WRF
just use GNU autotools. So just autoconf, configure and make. So almost no
manual interventions are needed.

Finally building WRF/WPS is tricky because these won't use make directly. So
some compiler options and path need to be changed for the machines you are
building on. For this also I have used perl one liners. This is where you need
to really understand WRF.sh and WPS.sh files. I believe as someone who is
going to use WRF soon, you will be able to easily understand those two
scripts.


How to customize then?
======================

Compiler options
----------------

As it is said in the previous section when you source the file it
invokes to get compiler setting. for gcc you need to customize file.


Configure options
-----------------

Build directory contains individual build scripts. customize them
accordingly.


WRF & WPS
---------

Selection of different build options for wrf/wps configure script is
automated by feeding to the stdin. so customize them to your need, they
also live in the directory. by default serial built is configured. Also
reading the comments in the and can be helpful.


Compilers tested by `wrf_install`
====================================

For now *gcc* and *intel*. *xl* and *pgi* will be supported in the later
versions of `wrf_install`.

+------------+-----------+---------+--------------------------+
| Compiler   | system    | state   | remarks                  |
+============+===========+=========+==========================+
| gcc        | linux     | ✔       | may need minor changes   |
+------------+-----------+---------+--------------------------+
| intel      | linux     | ✔       | may need minor changes   |
+------------+-----------+---------+--------------------------+
| pgi        | linux     | ✖       |                          |
+------------+-----------+---------+--------------------------+
| xl         | Ibm aix   | ✖       |                          |
+------------+-----------+---------+--------------------------+


After first successful installation, go full scale.
--------------------------------------------------

As usual first source the SOURCEME file.

.. code:: bash

    source SOURCEME               # it also spits some useful information, read it
    ./download_app.sh all

(This assumes you have figured out by now, how to automate WRF.sh, WPS.sh.)

Good luck.

===
FAQ
===

SOURCEME problems
-----------------

Source command not found.?
~~~~~~~~~~~~~~~~~~~~~~~~~

Change your shell to bash.


Model Run
---------

error loading so libnetcdff.so.5
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Error message looks like this ./wrf.exe: error while loading shared
  libraries: libnetcdff.so.5: cannot open shared object file: No such file
  or directory


  Set/add path of netcdf in linker directory path export

  .. code:: bash

     export LD_LIBRARY_PATH=/path/to/netcdf/lib:$LD_LIBRARY_PATH


Contributing
============

Any patches/reports/suggestions are most welcome. Drop `me
<mailto:hi◎yagnesh.org>`__ a mail (replace unicode character) or preferably
report on github `issues <https://github.com/yyr/wrf_install/issues>`__ page.


TODO
====

Check dev.org file.


License
=======
GPL 3 (or later); see COPYING file.
Something went wrong with that request. Please try again.