CompuCell3D (Dev)
Building CompuCell3D on FedoraCore Linux
Building CompuCell3D from source on Unix/Linux systems is fairly straightforward once all of it's dependencies have been satisfied. The following commands should build and install CC3D on FedoraCore systems.
Prerequisites
Hardware
CompuCell3D may build and run with less capable hardware, but has been tested with the following:
- 1024MB RAM
- Hardware 3D Graphics Acceleration (most modern graphics cards)
Build Tools and Dependencies
In addition to the common Unix/Linux build tools, interpreters and, libraries, building and running CompuCell3D requires:
- Qt (version 4.6 or higher recommended)
PyQt (with OpenGL modules)
- SWIG (version 2.x recommended)
- VTK (with Python wrappers, version 5.4 or higher recommended)
Qwt (and PyQwt, version 4.2 or higher recommended)
- QScintilla (version 1.7 or higher recommended)
- CMake (CMake-GUI is recommended)
- Python (version 2.6 or higher recommended)
On Fedora-based distributions the following command should install all the required dependencies (make sure you are root before executing yum commands. Othrwise you will geet notification abuot insufficient priviliges):
yum install qt4-devel PyQt4 vtk-devel vtk-qt qwt-devel qwt5-qt4-devel PyQwt-devel swig qscintilla-devel cmake-gui PyOpenGL vtk-python python2-devel libxml2-devel qscintilla-python gcc-c++ git
Source Code
Once the dependencies have been satisfied make directory where you want to store source code, in my case it is in /home/m/CC3D_GIT
mkdir /home/m/CC3D_GIT cd /home/m/CC3D_GIT
Once the directory has been created, obtain the source code from our GIT repository using the following command:
git clone https://github.com/CompuCell3D/CompuCell3D.git .
This will clone CC3D Git repository into current directory (remember about the . at the end of last command - it is important)
Build Configuration: Starting CMake
CompuCell3D is configured using the CMake build system. The following command starts the CMake GUI:
cmake-gui
That will start the build system, click Browse Source... and select the CompuCell3D source directory from the CompuCell3D GIT directory we have created above - in my case the CompuCell3D source directory is located in /home/m/CC3D_GIT/CompuCell3D:
in addition to specifying source directory we also specify the location of the build directory i.e. a directory where compilation files will be stored. in my case it is /home/m/CC3D_GIT_build/CompuCell3D
Build Configuration: Selecting Build System
We are ready to click Configure. A dialog box asking to create the build directory will appear:
and then one asking about the build system:
Select Unix Makefiles for the generator, select Use default native compilers and then click Finish. CMake will begin the configuration process. CMake will attempt to locate all of the dependencies installed above. If the following error occurs, ignore it:
CMake Error: Could not open file for write in copy operation /usr/local/pythonSetupScripts/Version.py.tmp CMake Error: : System Error: No such file or directory CMake Error at core/post_install_tasks/CMakeLists.txt:134 (configure_file): configure_file Problem configuring file
After the initial configuration has completed select Grouped and Advanced to make entering configuration values easier.
Build Configuration: CMAKE
In CMAKE confirm that CMake has located all the build tools. In the CMAKE_BUILD_TYPE field you may enter Debug, RelWithDebInfo or Release to specify the type of the binary you want to have - if you are developing extra modules compiling in the Debug or RelWithDebInfo can be helpful. By default Compucell3D build type is set to Release:
In the CMAKE_INSTALL_PREFIX field enter the directory you would like to install CompuCell3D into - this is important. We recommend that unless necessary you shold install CC3D into local directory - in my case it is /home/m/CC3D_install, .
Click on Configure to have all the values updated. Click on Configure and then click on Generate to generate the Makefiles, ignore any warnings. Exit CMake
Building
To begin compiling CompuCell3D enter the build directory specified in the Where to build the binaries field of CMake earlier and use the following command:
In my case I type:
cd /home/m/CC3D_GIT_build/CompuCell3D make
After the build begins you may see screen like this one:
Installing
Once compiling has completed CompuCell3D can be installed into the directory specified in the CMAKE_INSTALL_PREFIX field earlier by issuing the following command:
make install
Running
After CompuCell3D has finished installing you can start CompuCell3D by entering the installation directory (in my case it is in /home/m/CC3D_install):
cd /home/m/CC3D_install
and issuing the following command:
./compucell3d.sh
