== CellDraw Status ==

Starting with CC3D 3.7.6 version, the main part of CC3D interface was ported from !PyQt4 to !PyQt5. However !CellDraw was not a part of this code translation and as result current versions of CC3D do not ship with CellDraw run script. this may cause an  inconvenience to users who rely on !CellDraw. We will port !CellDraw to !PyQt5 but meanwhile we would like to suggest the following two solutions

=== Solution 1 ===

You may install older version of CC3D  for the sole purpose of using !CellDraw. This way on your system you may have two CC3D installations - 3.7.5 supporting !CellDraw and newer version of CC3D (e.g. 3.7.7.) where !CellDraw is not supported. Keep in mind that PIFF files generated with cell draw will work with newer versions of CC3D.

=== Solution 2 ===

This solution involves installing miniconda (Python distribution/python package manager developed by Continuum Analytics) , creating virtual environment and running !CellDraw directly from the  command line. Here are the steps:

1. Install miniconda2  - [[https://conda.io/miniconda.html|Miniconda download page]]
2. Create Virtual Python Environment.

After you installed miniconda you need to create virtual python environment using the following command:
{{{
conda create -n cell_draw_env python
}}}

''cell_draw_env'' is a name of the python virtual environment but you can name it however you like. I called it ''cell_draw_env'' because it indicates that we created this python virtual environment to run !CellDraw

3. Activate new environment:

On Mac/Linux:

{{{
source activate cell_draw_env
}}}

on Windows

{{{
activate cell_draw_env
}}}

4. install !PyQt4, numpy and vtk :

{{{
conda install pyqt=4.11 numpy vtk
}}}

5. Clone CC3D Source code :

{{{
mkdir /Users/m/CC3D_CELLDRAW_GIT
cd CC3D_CELLDRAW_GIT
git clone https://github.com/CompuCell3D/CompuCell3D.git .

git checkout 3.7.9
}}}

Keep in mind that in your case you will need to change ''/Users/m'' prefix to the path to your home directory
6. Run !CellDraw:

Go to the directory with the !CellDraw code - in our example it means executing the following command
{{{
cd ~/CC3D_CELLDRAW_GIT/CellDraw/1.5.2/src
}}}

Now add two environment variables that !CellDraw expects to see (''PREFIX_CELLDRAW'', ''PREFIX_CC3D''):

{{{
export PREFIX_CELLDRAW=/Users/m/CC3D_CELLDRAW_GIT/CellDraw/1.5.2/src
export PREFIX_CC3D=/Users/m/Demo2/CC3D_3.7.7/
}}}

'''Note''': I have set the path to CC3D installation directory in such a away that it point to 3.7.7. version of CC3D

At this point you should be able to run !CellDraw:

{{{
cd /Users/m/CC3D_CELLDRAW_GIT/CellDraw/1.5.2/src
python cellDrawMain.pyw
}}}

Note that you can create a bash script that automates all those steps. Here is an example of such script:


{{{

#!/bin/bash

cd "${0%/*}"

export PREFIX_CELLDRAW=/Users/m/CC3D_CELLDRAW_GIT/CellDraw/1.5.2/src
current_directory=$(pwd)

cd $PREFIX_CELLDRAW

export PREFIX_CC3D=/Users/m/Demo2/CC3D_3.7.7


export CELLDRAW_MAJOR_VERSION=1
export CELLDRAW_MINOR_VERSION=5
export CELLDRAW_BUILD_VERSION=2

python ${PREFIX_CELLDRAW}/cellDrawMain.pyw.

cd ${current_directory}
}}}

Keep in mind that you will ned to specify correct paths for ''PREFIX_CELLDRAW'' and for ''PREFIX_CC3D'' 

Save the script as ''celldraw_custom.sh'' and make it executable:

{{{
chmod +x  celldraw_custom.sh
}}}


Now to run !CellDraw all you need is to type:

{{{
./celldraw_custom.sh
}}}

and I assumed that this last command is executed from the directory where you stored the script