# $Id: INSTALL,v 1.3 2007/02/12 00:18:37 gosselin_a Exp $
# $Name:  $
# $Log: INSTALL,v $
# Revision 1.3  2007/02/12 00:18:37  gosselin_a
# Posted new release of the pycdf documentation.
#
# Revision 1.3  2006/01/02 20:37:56  gosselin_a
# New pycdf-0.6-0 release.
#
# Revision 1.2  2005/07/16 17:01:18  gosselin_a
# pycdf-0.5-3
#   pycdf classes are now 'new-style' classes (they derive from 'object').
#   Updated documentation and admin files.
#

Installing the pycdf python package.

pycdf has been successfully installed under python 2.2 and above on
the following platforms:
  -Linux, kernel 2.4.19 and above
  -Tru64 4.0.f and above
  -Solaris 8
  -AIX 4

pycdf is compatible with all current releases of Numeric (last tested: 24.0),
numarray (last tested: 1.3.3), and netcdf (last tested: 3.6.1).

Please inform the author (gosselina@dfo-mpo.gc.ca) of any
successfull installation on a different platform, and of
problems encountered.

To install, follow these steps.

1-Install the Python 'devel' package, holding the python libraries and header
  files.

2-Install the netcdf library. Source code is available at:
  http://www.unidata.ucar.edu/software/netcdf . Binary packages
  are available for most popular environments.

3-Install one of the python Numeric or numarray packages. 
  Numeric source code is available at: numpy.sourceforge.net, 
  and numarray source code at http://sourceforge.net/projects/numpy .
  Binary packages are available for most popular environments.

4-Uncompress and untar the pycdf tar ball, then cd to the
  pycdf-xxx directory just created.

5-Edit the 'setup.py' file, and locate the line reading "USE = ...".
  Set "USE = NUMERIC" to create a Numeric-based version of pycdf. 
  Set "USE = NUMARRAY" to create a numarray-based version.

5-If your netcdf library lives in a non-standard directory
  (eg not on the standard library search path),
  edit the `setup.py' file and locate the line reading:

    #library_dirs=["non standard path where libs live"],

  Remove the pound sign to uncomment the line, and enter the non-
  standard path in quotes between the square brackets. For ex.:

    library_dirs = ["/usr/local/netcdf-3.5.0/lib"],

6-As root, execute the command:

    python setup.py install

Enjoy!