Difference between revisions of "Team:Bordeaux/Software"

Line 76: Line 76:
 
                 src="https://static.igem.org/mediawiki/2016/2/29/T--Bordeaux--user_interface.png"  
 
                 src="https://static.igem.org/mediawiki/2016/2/29/T--Bordeaux--user_interface.png"  
 
                 title="user interface">  
 
                 title="user interface">  
                 <figcaption>Figure 1 A caption of the user interface with the different parameters</figcaption>
+
                 <figcaption><b>Figure 1: A caption of the user interface with the different parameters</b></figcaption>
 
             </figure>
 
             </figure>
 
</center>
 
</center>
Line 102: Line 102:
 
                 src= "https://static.igem.org/mediawiki/2016/d/d4/Indisim_sim_10e4_init.png"
 
                 src= "https://static.igem.org/mediawiki/2016/d/d4/Indisim_sim_10e4_init.png"
 
                 title= "Exemple of a plot obtained">
 
                 title= "Exemple of a plot obtained">
                 <figcaption>Figure 2 Example of a plot obtained after a simulation.</figcaption>
+
                 <figcaption><b>Figure 2: Example of a plot obtained after a simulation</b></figcaption>
 
             </figure>
 
             </figure>
 
</center>
 
</center>

Revision as of 00:30, 20 October 2016

Sleep with EpiC elegans

Overview

As iGEMers we have the responsibility to use safe practices during our lab work in order to reduce the risks linked to harmful chemicals or organisms. These risks are often linked to the bacteria used almost all of the time to engineer bio-bricks. The release of such bacteria in the environment is a risk that can currently be prevented by using suicide genes and other methods. The iGEM team of Bordeaux thought of an alternative method to help tackle this problem. This is the simulation of the growth of transformed bacteria in the laboratory. In fact our objective has been to create a software that can allow users to simulate the growth of transformed bacteria on a certain area of a solid surface for a given set of parameters.

The simulation

Our tool runs an agent-based simulation. The agents are bacteria which can possess or not a plasmid and the environment is a grid of squares representing a solid surface. Each square corresponds to a 1µm² area and can contain one bacterial cell directly in contact with the surface or piled up on another bacterium. The piling up is limited by the user. A certain concentration of an energy source for the bacteria can be present on the grid. Time is concrete so bacteria repeat a schedule of actions at each time step. These actions are consuming nutrients, metabolizing them, and dividing or dying if certain conditions are met.

To simulate the growth of bacteria we used two different approaches that are explained in the section model. In this section we will concentrate on the use of the software.

The installation

You can find the source code of our software on github at https://github.com/igemsoftware2016/iGEM-Bordeaux-modeling. The dependencies are the g++ compiler, the C++ boost library, the gtkmm library and and the matplotlib library. You need to compile the sources (of one of the two versions) with the command make so you can run the application with the executable interface. You can also run the simulation directly with the executable run by passing the necessary parameters as arguments.

The user interface

We opted for a simple user interface (figure 1) written with gtkmm since the language we used for the simulation is C++.

Figure 1: A caption of the user interface with the different parameters

The parameters the user can define are linked to experimental conditions but also to the mechanics of the simulation itself. These parameters are explained below.

  • The simulation time is the time that will be simulated.
  • The simulation step is the interval of time at which the system will be updated. It can be changed if users find it necessary to add more precision or make the simulation faster.
  • The initial number of bacteria is the total number of transformed (donors) and not transformed (recipient) bacteria.
  • The percentage of donor bacteria is the number of bacteria that possess a plasmid and can conjugate with other bacteria.
  • The height and length of the grid (the simulation environment) are the number of squares that occupy the grid's height and length. By default it is 1000x1000 but for very large bacteria numbers it has to be extended.
  • The conjugation rate is the probability by which a donor will give a copy of its plasmid to a bacterium close to it (in the distance of one square).
  • The segregation loss is the probability that a donor cell will not pass its plasmid to its daughter cell during division.
  • The plasmid cost is the probability of death of a transformed bacterium because of the absence of selection pressure. This parameter could be useful to simulate bacteria with antibiotic-resistance plasmids in an antibiotic-free environment.

After the launch of the simulation the user has to wait some seconds or minutes for the simulation to run. The result is a plot of the evolution of the number of bacteria in the time (one exemple is figure 2). This plot can also be found in the directory of the executable as a png and the data it's based on can be found in a csv file containing the time step, the total number of bacteria and the total number of donor bacteria at each time step.

Figure 2: Example of a plot obtained after a simulation