Dumpgeo version 0.01
====================

This program provides a mechanism to dump a WRF binary file. It needs
to be linked againts the WRF IO Int (libwrfio_int.a) library.


1. Prerequisites
----------------

You will need a working Fortran compiler.

You will also need WRF with binary IO capabilities.
(http://www.wrf-model.org/)

Once WRF has been built, you need to set the environment variable
WRF_DIR to the toplevel WRF directory.
In bash:
	% export WRF_DIR=/some/path/to/WRFV3
In csh:
	% setenv WRF_DIR '/some/path/to/WRFV3'

2. Building / Installation
--------------------------

To build and install WBDump with your default fortran compiler:
	% make
	% make install

If you want to override the compiler set the environment variable
F90 to your prefered compiler. Please note, WRF should be built with
this same compiler.

Currently WBDump will be installed in "../bin" and the manpage
into "../man". This is assuming the WBDump source still resides
within the HWRF-Contrib repository. If you want to override this
installation location set the environment variable DESTDIR
	% make DESTDIR=${HOME} install

3. Usage
--------

To dump the contents of a geogrid file, call WBDump with the filename.
	% WBDump geo_nmm.d01.int
This will print the meta information of geo_nmm.d01.int (a geogrid parent
domain file) to the standard output.

If you only want to print one variable the option "-v" will do this. While
the option "-d" will dump all of its data.
	% WBDump -v HCNVX -d geo_nmm.d01.int
Will print all the information and data of HCNVX contained in the file
geo_nmm.d01.int to the standard output. This will not print the meta
information for the file.


Copyright
---------

Copyright (c) Timothy Brown <Timothy.P.Brown@noaa.gov>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.