BUILDING FROM SOURCE

1) The pyVolution Visualizer has several dependencies. 

   OpenThreads, Producer, OpenSceneGraph:
            - http://openscenegraph.sourceforge.net
            - available as a bundle, OSG_OP_OT-0.9.8, that contains
              OpenThreads, (Open)Producer and OpenSceneGraph as 
              subdirectories.  
            - OpenSceneGraph has 3rd party dependencies, these are
              available as a downloadable .zip for Windows.  Extracted
              .zip directory (3rdParty) lives alongside other three
              subdirectories.
            - Build "release" versions in above order
            - ensure you can run the examples that come with OSG
              prior to building the viewer (these live in the 
              OpenSceneGraph/bin directory on Windows).

   NetCDF   - a self-describing binary file format I/O library
            - http://my.unidata.ucar.edu/content/software/netcdf/index.html
            - require the header file netcdf.h and the library proper to
              link against

   cppUnit  - a unit testing framework for C++
            - http://cppunit.sourceforge.net
            - this is optional


2) Set environment variables:

   OSG_ROOT :  root of your OpenSceneGraph installation
               conforming to following layout

               OSG_ROOT
                 /OpenThreads
                    /lib
                       /win32 (for VisualStudio builds)
                    /include
                 /Producer
                    /lib
                    /include
                 /OpenSceneGraph
                    /lib
                    /include
                 /3rdParty (Windows only)

   NETCDF_DIR :  root of NetCDF binary package with needed subdirs 
                 /lib and /include

   CPPUNIT :  root of c++ unit testing framework with needed subdirs 
              /lib and /include (optional) 


3) Compilation


   WINDOWS

      (i) Within VisualStudio, Open the solution in Swollen visualstudio subdirectory
     (ii) Open Menu Tools|Options|Projects|VC++Directories and add a
          path to $(NETCDF_DIR)/bin and $(OSG_ROOT)/bin.
     (iii) Build the solution


   Mac OSX

          Run make in top-level OSG_ROOT directory.


   Linux

          Makefiles not yet written



4) The binary swollen (swollen.exe on Windows) lives in the distribution's
   bin directory.  Test the build with any of the sample datasets in the
   distribution's data subdirectory, e.g., 
         "cd bin; ./swollen ../data/laminar.sww"