<title>Installation on Mac OS X</title>
<h1>Installation on Mac OS X</h1>
To install Cain, download the disk image and drag the application bundle to
your Applications folder (or wherever you want to place it). The example data
files are in the <tt>examples</tt> folder in the application bundle. They
are also packaged separately in the <tt>CainExamples</tt>
folder. You can drag this to a folder where you store data or documents.
To uninstall Cain, simply drag the <tt>Cain</tt> application to the Trash.
To use Cain you will need
<a href="http://matplotlib.sourceforge.net/">matplotlib</a>, and
Unfortunately, Mac OS X comes with rather old versions of the first
three and does not have matplotlib or SymPy.
There are several ways of obtaining the
necessary software to run Cain. The easiest solution is to install the
<a href="http://www.enthought.com/products/epd.php">Enthought Python
Distribution</a>. Alternatively, you can install the appropriate
packages yourself. We consider these two alternatives below.
<b>Enthought Python Distribution.</b>
As mentioned above the easiest way to get appropriate versions of
python and the required packages is to
the Enthought Python Distribution.
The EPD is designed for those working in scientific
computing and comes with all of the packages that Cain needs. It is a
commercial product, but is free for educational use
if you are associated with a degree-granting institution. (Click on
the "Academic" button at the bottom of the download page.)
Note that you will need the 32-bit version; the 64-bit version does
not have support for the wxPython package.
<b>Installing Python packages yourself.</b>
The other option is to download and install the packages.
Get the software from the sites indicated above.
Just download the binaries; installation is a snap. For example, one could
download and install the following packages.
Then follow the installation instructions on the SymPy web page.
If you do not have the necessary packages installed, Cain will show an error
message when you attempt to launch the application.
<b>Lion or Snow Leopard.</b>
There is a complication with using the system version of Python.
The default version of Python is a 64-bit
application and the wxPython libraries will only work with the 32-bit
version. The easiest solution is to install the Enthought Python
Distribution. Otherwise you can either install a 32-bit version of
Python from the <a href="http://www.python.org/">Python web site</a>,
or you can configure the system version of Python to run in 32-bit
mode. For instructions on the latter search for
"wxpython snow leopard."
In order to compile custom executables (either for kinetic laws that are
not mass-action or to speed up simulations that use mass-action kinetics)
you will need a C++ compiler. The <a href="http://gcc.gnu.org/">GNU GCC</a>
compiler is freely available, but it is not installed by default. You can
get it by installing Xcode, which is a free download in the App Store.
By installing Xcode, you get the compilers as well
as Apple's integrated development environment.