Team:HUST-China/Modeling/CAL/manual

From 2012.igem.org

logo

HUST CHINA


Get a copy of CAL(for Windows users)


1.Download a .exe file from https://code.google.com/p/caliteral/.
2.Download source codes from https://code.google.com/p/caliteral/.
Qt SDK and Qt add-in is needed. It's all free and available on the Internet. We recommend you to compile with VS2010 since that's the only environment we use to build CAL. But we heard that Qt can also work with GCC.
We have to say sorry to Linux users and Mac users, for we didn't provide a Linux or Mac version. Nevertheless, you can get CAL running by compiling it using Qt SDK and addin. You will need to make a few adjustments on the source code in order to get CAL running under Linux and Mac environment.
For more information, please visit project on Google Code.

How to use it

First, let's meet the interface of CAL. GUI of CAL

Initializing states of cells

In the "Options" combobox shown in red box, there are two options concerning initializing states of cells.
"Random" together with "Density" will initialize the states of cells randomly, creating a given cell density. Density ranges from 0 to 1, with a precision of 1/2500
"From File" options will initialize with a .txt file, in which there's a 50X50 matrix with "0" indicating a dead cell and "1" indicating a living cell. An example of such a .txt file is given in the source code pack, "data.txt".

Parameters

Shown in pink box.
"Density" works with "Random" mode.
"AHLThreshold" define the AHL Threshold.Once the intracellular AHL reach such a threshold, the CcdB concentrations will be high enough to kill a cell.
"HThreshold" define the Proton Threshold. Once such threshold is reached, the cell will automatically moving towards the place with higher proton concentration.

Sensitivity correction

"Sensitivity Correction" option shown in blue box decides whether CcdB sensitivity correction is applied or not.Once applied, a $X \sim N(1.0,0.1^2)$ coefficient will be added. This option only works in "Combined Rules" and "Quorum Sensing" mode.

NSGs Setting

"NSGs" are acronym for Next-State Generators, which is equivalent to rules of CA.
"Quorum Sensing" is equivalent to AHL-CcdB, Sensitivity Correction and Production rules.
"Aggregation" is equivalent to Proton Concentrations-driven Chemotaxis rules.
"Combines Rules" are all rules stated above.

Print a file

Print a report when "Stop" button is pressed or CAL reach a steady state. The report file includes initial cell states, final cell states and parameters and settings.

Runtime information

"Init.Cell(s)" shows the initial number of cells.
"Current Cell(s)" shows the current number of cells.
"Generations(s)" shows the current generations of simulation.

FAQ

If you have any problem concerning the compiling or using CAL, please contact Li Chen.Email Li Chen.