CC3D Files

--------------------------------------------------
CompuCell 3D (CC3D) version 3.7.0
  32 bit intel binaries for Mac OS X (10.5 - 10.8)
--------------------------------------------------


This is a 32 bit binary distribution of CompuCell 3D 3.7.0 for Mac OS X.

CompuCell 3D 3.7.0 is provided in two separate binary distributions for Mac OS X:

* the "32bit" distribution runs on Mac OS X 10.5.8 (Leopard) and newer,
  including Mac OS X 10.6 (Snow Leopard), Mac OS X 10.7 (Lion), and OS X 10.8
  (Mountain Lion), in 32bit mode.
  It does not support CC3D OpenCL-accelerated code.

* the "10.8" distribution runs on OS X 10.8.0 (Mountain Lion) and newer,
  in 64 bit mode, and supports CC3D OpenCL-accelerated code.


A CompuCell3D binary distribution for PowerPC-based systems is not provided, but
can be built from source code.


---- how to run CC3D on Mac OS X systems ----

Download the file:   CC3D_3.7.0_MacOSX_vvvvv_yyyymmdd.zip
where vvvvv is the Mac OS X operating system version ("10.8" or "32bit",
depending on your system) and yyyymmdd is the date of the last build update.

An installer is not required for CC3D on Mac systems: just double-click
the .zip file and place the resulting "CC3D_3.7.0_MacOSX_32bit" directory
anywhere you want.
A good place is your computer's /Applications/ directory.

Or, for example if you don't have administrative-level permissions on
your system (such as on a public lab machine), you can simply create a
directory called "Applications" in your user/home directory, and place
the "CC3D_3.7.0_MacOSX_32bit" directory in that "Applications" directory.


To start the CompuCell 3D player application from the Finder,
double-click the compucell3d.command file. The very first time you run
CC3D, you may get a system warning 'this application has been downloaded
from the internet'. On OS X 10.8 and newer, you may get a system warning
'"compucell3d.command" can't be opened because it is from an unidentified
developer.' In that case, control-click on the "compucell3d.command" file
and select "open" from the pop-up menu, then authorize with administrator
username and password.



To run CompuCell 3D from the Terminal, cd to the "CC3D_3.7.0_MacOSX"
directory and type:
./compucell3d.command <return>


CompuCell 3D is self-contained: all the required dependencies and
third-party libraries are included, such as Qt, PyQt, VTK, etc.
CompuCell 3D relies on the Python 2.5 distribution included by default
on Mac OS X 10.5, 10.6, 10.7 and 10.8 systems.



---- current release notes ----


Important note: starting with release 3.7.0, CompuCell 3D includes the
"RoadRunner" SBML solver software library, which comes with its own additional
requirements:

RoadRunner requirement 1: to run RoadRunner-based simulations, such as the demos
in the SBMLSolverExamples/ directory, currently Xcode needs to be installed on
your system. Xcode for OS X 10.8 (Mountain Lion) is available for free from the
Mac App Store. If using Xcode 4.3 or newer, first install gcc etc. as command
line tools, from within Xcode.app -> "Preferences" -> "Downloads".

RoadRunner requirement 2: currently, RoadRunner-based simulations only run when
"Language & Text" OS X system preferences are set to English language default
values.

The above requirements are only necessary when running simulations requiring the
SBML solver library.


---- previous release notes ----

Starting with release 3.6.0, build update 1885, the binary distribution of
CompuCell 3D compiled for Mac OS X includes the BionetSolver 0.0.6 library.

Starting with release 3.5.0, CompuCell 3D provides parallel execution of
simulation computations, implemented using the OpenMP shared memory
multiprocessing software library.