-------------------------
Installation Instructions
-------------------------

Introduction
------------

This document contains instructions for those who have downloaded the
ncweb source code and want to install it on their system.  

Supported Platforms
-------------------

The development platform for ncweb is Linux, but ncweb is written in 
Python so it should be portable to other systems.

Installation
------------

To install from source do the following:

  # Unpack source code in a directory of your choice. If you downloaded 
  the .tar.gz file on a Unix/Linux machine

    tar zxvf ncweb.tar.gz

  or if you downloaded the .zip file

    unzip ncweb.zip

  If you downloaded one of the files on another operating system
  please use the tool you normally use for extracting compressed
  files.

  After unpacking ncweb you should change to the ncweb directory. If you
  want to do a standard install (which normally requires root or
  administrator privileges) simply type:

    python setup.py install

Usage
-----

Please see the README file.

Required Libraries
---------------------

First you need a Python installation from:

http://python.org/

Ncweb also uses numpy:

http://sourceforge.net/projects/numpy

To handle NetCDF files you must install the PyNIO library:

http://www.pyngl.ucar.edu/download.shtml

To take care of date and time conversions you must install
the netcdftime module from the netcdf4-python package (you do not
need to install the entire netcdf4-python package - see the
README file in the package):

http://code.google.com/p/netcdf4-python/

You will also need the plotting package matplotlib:

http://sourceforge.net/projects/matplotlib

To run the webserver you will also need the
TurboGears package:

http://www.turbogears.org/