C A N T E R A

                              release 1.5

                               7/30/2004

      Copyright (c) 2001-2004 California Institute of Technology



License information
===================

See the file "License.txt" for information on the terms & conditions
for usage, and a DISCLAIMER OF ALL WARRANTIES.

All trademarks referenced herein are property of their respective
holders.


Installing a Binary Version of Cantera
======================================

Binary installers are available for the Windows and Mac platforms. If
you wish to install from one of these, download the appropriate
installer from the Cantera Sourceforge site and run it. This is the
simplest option if you want a standard installation, and plan to
primarily use Cantera from Python or MATLAB. 



Building Cantera from the source code
=====================================


1) Unix/linux/cygwin/Mac OSX build procedure
--------------------------------------------

Run the 'configure' script to build the Makefiles. 

By default, 'make install' will install under '/usr/local' on
linux/unix, and '/Applications/Cantera' on OS X. If you want to
install Cantera somewhere else, run 'configure' with the 'prefix'
option. For example, to install in directory 'cantera' within your
home directory:

configure --prefix=$HOME/cantera

If necessary, edit 'configure' to set options appropriate for your
system before running it.

After running 'configure', type:

make
make install

The last one may need to be run as super-user.

To test the installation, type

make test

After running 'make install', a script 'setup_cantera' will be written
to your home directory. Run it using 'source'
to configure the environment before using Cantera. You may want to add the line

source ~/setup_cantera

to your login script.

The build process requires a 'make' utility compatible with GNU
'make'.  If this has a different name on your system, define
environment variable MAKE to the name (e.g. 'gmake') before running
'configure'.

This procedure also builds the Python and MATLAB interfaces if 
your system is configured to use them. The requirements are:
    -- Python 2.x + NumPy for the Python interface
    -- MATLAB 13 or 14 for the MATLAB toolbox.
If either is missing or an error occurs, the interface is not installed.

Note that your C++ compiler must be compatible with the compiler used
to compile Python or MATLAB. For MATLAB 14, this means you will need
to build Cantera with g++ 3.x, while for MATLAB 13, you will need to
use g++ 2.95.


2) Windows Build Procedure
--------------------------

Cantera can be built under Windows using Visual C++ 6.0 and Compaq
Visual Fortran 6.0. You need to have cygwin installed, however, so
that you can use 'make' ot set up the directory structure in the
install directory. 

The first step is to run 'configure' from a cygwin shell window. Once
this finishes, start Visual C++, and go to the 'win32' directory and
open workspace 'cantera.dsw'. Set the active project to 'all', and the
active configuration to 'Win32 - Release'. Build the project.

When this completes, return to the cygwin shell, and type 'make win'
to complete the process. At the end, you should have a working
installation in C:\Cantera (or wherever you specified to 'configure').

The Windows build procedure is described in more detail in the 
document **.


Configuring Matlab
---------------------

The Matlab toolbox uses one compiled MEX program written in C++.
Before you can build it, Matlab needs to be configured
for your compiler. In Matlab type:

mex -setup

and enter the number for the compiler you wish to use.

The Matlab toolbox is built automatically by the Cantera build
process, but can also be built manually.  To build the MEX file needed
for the Matlab toolbox, within Matlab go to to the 'cantera' directory
containing the toolbox and type 'buildux' on unix/linux/Mac OS X, or
'buildwin' on Windows.


Configuring Python
---------------------

Before you can build the Python interface from the source, you need to
have Python 2.0 or greater, and the 'Numeric' package must be
installed. Python is available at www.python.org, and Numeric is
available through SourceForge.


Customizing
-----------

Before running configure, the following environment variables may be set:

MAKE                     set to 'make' utility compatible with GNU make

CXX                      C++ compiler

F77                      Fortran 77 compiler

PYTHON_CMD               Python interpreter to use with Cantera 
                         (default: 'python')

MATLAB_CMD               Matlab command (default: 'matlab')

Additional customization can be done by editing the configure script.