5/2012                     General Installation 


Edit the file "makefile" and select the desired options:

# netcdf3: write netcdf files with netcdf-3 library
# netcdf4: write netcdf files with netcdf-4 library
#  only one netcdf library can be installed. do not choose netcdf3 and ncdf4
# regex: regular expression package used by (match,not), POSIX-2
# tigge: enable -tigge option for tigge names
# mysql: write to mysql files
# ipolates: fortran interpolation library
# udf: user defined functions
# openmp: use OpemMP to thread the code
#
# the flags are stored in wgrib2/config.h
#

Default options

USE_NETCDF3=1
USE_NETCDF4=0
USE_REGEX=1
USE_TIGGE=1
USE_MYSQL=0
USE_IPOLATES=0
USE_UDF=0
USE_OPENMP=0

In the default configuration, all the code is compiled
using the C compiler.  The libraries are also compiled at
the same time.


On some machines, you will have to define the C compiler
and C preprocessor.  On the NCEP's AIX, I have to define
them by

	export CC=/usr/vacpp/bin/xlc_r
	export CPP=/usr/bin/cpp

Then you have to run gnu make.  (gmake on some machines, make on others)

	make		- on linux
	gmake		- on AIX
	

                        Optional Packages

You can edit the makefile to include optional packages.
1 means include the package and 0 means don't include the package.


                          Comments on Netcdf

The makefile is set up to use either netcdf v3 or netcdf v4.  Netcdf-4
makes wgrib2 much bigger, so don't install it unless you really have to.
The source code for netcdf-4 (and necessary hdf5) is also very big
and will have to be downloaded separately.

The netcdf-3 library is included with this distribution.  The library is
compiled in enable-C-only mode which is not be that useful for
fortran code.  Don't use try to link other codes to this library.

The netcdf-4 library has to be downloaded with the HDF5 library and
the shell variable FC has to be set to the default fortran compiler.


                  IPOLATES, interpolation library

IPOLATES is the interpolation library used by the -new_grid options.
In order to use this library, you must have a newer fortran compiler
(f90, f95) available.  In order to enable the -new_grid options,
the makefile has to have USE_IPOLATES enabled and the shell variable, FC,
must have the name of the fortran compiler. You will have to change
the source code if you are not using g95, gfortran, openf95 or xlf.



                     INSTALLING on windows XP

The code include the IPOLATES option compiles in the cygwin development 
system.  You'll have to install extra packages such as the C, gfortran 
compilers and various scripting utilities. 

    Before you compile, you set the default compilers.

    export CC gcc
    export FC gfortran
    make

                        INSTALLING on FreeBSD

Setup appropriate CC and FC environment variables and try make.


                        INSTALLING on Apple OS-X

Has been done. No details.


                        INSTALLING on NCEP's AIX

Define default C, C preprocessor and fortran

   export CC=/usr/vacpp/bin/xlc_r
   export CPP=/usr/bin/cpp
   export FC=xlf_r
   gmake


			Static vs Dynamic Libraries

The various libraries can be created in both dynamic and static versions.  
I've tried to make the add-on libraries static.  

                           Testing Package

Have a testing script that tests an known-good version with a test
version. For new machines, I use the gcc compiled version as the 
"known-good" version.  Not ideal.

                             Problems

Some optional packages require changes to makefile