Difference between revisions of "Team:Fudan-TSI/Hardware"

m
m
Line 5: Line 5:
 
We make it compatible on laptop and mobile devices by using Materialize 1.0.0-rc.2.
 
We make it compatible on laptop and mobile devices by using Materialize 1.0.0-rc.2.
 
-->
 
-->
<!-- LC check on 2018-10-18 -->
+
<!-- LC check on 2018-10-25 -->
 
<head>
 
<head>
 
     <meta charset="UTF-8">
 
     <meta charset="UTF-8">
Line 56: Line 56:
 
         /** 重置表格元素 **/
 
         /** 重置表格元素 **/
 
         table { border-collapse: collapse; border-spacing: 0; }
 
         table { border-collapse: collapse; border-spacing: 0; }
 +
#FudanBody .imgNoM img{
 +
    width:100%;
 +
}
 +
#FudanBody .imgNoM{
 +
    text-align:center;
 +
}
 
     </style>
 
     </style>
     <title>2019 Team:Fudan-TSI Hardware</title>
+
     <title>2019 Team:Fudan-TSI Software</title>
 
</head>
 
</head>
  
Line 89: Line 95:
 
                     <div class="background">
 
                     <div class="background">
 
                     </div>
 
                     </div>
                     <p class="flow-text" style="width:100%;text-align:center"><span class="white-text">Hardware</span></p>
+
                     <p class="flow-text" style="width:100%;text-align:center"><span class="white-text">Software</span></p>
 
                 </div></li>
 
                 </div></li>
 
                 <li>
 
                 <li>
 
                     <ul class="collapsible expandable">
 
                     <ul class="collapsible expandable">
                        <li class="onThisPageNav"><span>On this page</span></li>
 
                        <li class="onThisPageNav"><a href="#section1">div with id section1</a></li>
 
                        <li class="onThisPageNav"><a href="#section2">div with id section2</a></li>
 
                        <li class="onThisPageNav"><a href="#section3">div with id section3</a></li>
 
 
                         <li class="onThisPageNav"><span>Team: Fudan-TSI</span></li>
 
                         <li class="onThisPageNav"><span>Team: Fudan-TSI</span></li>
 
<li><div class="collapsible-header"><span>Project</span></div>
 
<li><div class="collapsible-header"><span>Project</span></div>
Line 156: Line 158:
  
 
             <div id="contentBanner" class="figureBanner orangeBg">
 
             <div id="contentBanner" class="figureBanner orangeBg">
                 <div class="row"><!-- below for smaller screen, duplicate h1 and span -->
+
                 <div class="row">
 
                     <div class="col s12 hide-on-med-and-up">
 
                     <div class="col s12 hide-on-med-and-up">
                         <h1>Hardware</h1>
+
                         <h1>Software</h1>
 
                     </div>
 
                     </div>
 
                     <div class="col s12 hide-on-med-and-up">
 
                     <div class="col s12 hide-on-med-and-up">
                         <span>tba tba</span>
+
                         <span>...</span>
 
                     </div>
 
                     </div>
                 </div><!-- above for smaller screen, duplicate h1 and span -->
+
                 </div>
 
                 <div id="figureBannerTitle" class="hide-on-small-only">
 
                 <div id="figureBannerTitle" class="hide-on-small-only">
                     <h1>Hardware</h1>
+
                     <h1>Software</h1>
                     <p class="flow-text"><span>tba tba</span></p>
+
                     <p class="flow-text"><span>...</span></p>
 
                 </div>
 
                 </div>
 
                 <div class="hide-on-small-only">
 
                 <div class="hide-on-small-only">
                     <img alt="2018 team Fudan title attributions" src="https://static.igem.org/mediawiki/2018/5/5f/T--Fudan--title_attri.jpg">
+
                     <img src="https://static.igem.org/mediawiki/2018/2/26/T--Fudan--title_software.jpg">
 
                     <svg width="10" height="10" xmlns="http://www.w3.org/2000/svg" style="position:absolute; left:0;top:0; width: 4%;height: 100%;">
 
                     <svg width="10" height="10" xmlns="http://www.w3.org/2000/svg" style="position:absolute; left:0;top:0; width: 4%;height: 100%;">
 
                         <defs>
 
                         <defs>
Line 198: Line 200:
 
             <div class="container">
 
             <div class="container">
 
                 <!-- side navigator of page content -->
 
                 <!-- side navigator of page content -->
                 <main style="margin: 0;">
+
                 <ul id="pageContentNav" class="hide-on-med-and-down z-depth-0">
                     <div class="section container scrolSpy" id="section1">
+
                    <li><a href="/Team:Fudan-TSI/Addon#ribo">Addon: ribo</a></li>
                         <h2>greatbay 文字</h2>
+
                    <li><a href="/Team:Fudan-TSI/Addon#TALE">Addon: TALE</a></li>
 +
                    <li><a href="/Team:Fudan-TSI/Addon#T2">Addon: T2</a></li>
 +
                    <li><a href="/Team:Fudan-TSI/Model#Transcriptional_Amplifer">Model: transcriptional amplifer</a></li>
 +
                    <li><a href="/Team:Fudan-TSI/Model#NotchLigandKinetics">Model: Notch-ligand&nbsp;kinetics</a></li>
 +
                    <li>Software</li>
 +
                    <li class="onThisPageNav"><a href="#section1">Abstract</a></li>
 +
                    <li class="onThisPageNav"><a href="#section2">Introduction</a></li>
 +
                    <li class="onThisPageNav"><a href="#section3">Method</a></li>
 +
                    <li class="onThisPageNav"><a href="#section4">Tutorials</a></li>
 +
                </ul>
 +
                <main>
 +
                     <div id="section1" class="section container scrolSpy">
 +
                        <p class="flow-text">Our software tool was built based on (1) <a href="/Team:Fudan-TSI/Model">modeled parameters</a> characterizing our 3-layer design; (2) populational description of individual cellular behaviors. We found that several cell behaviors and ENABLE signaling have key impact on the evolution of a cell colony with mixed cell types. In an object-oriented-programming and user-friendly style, our software allows users to adjust those key factors and profile the fate of their own mixed cells. Our software bridges a nanoscopic transcriptional design of biological circuits, with microscopic cellular behaviors, up to a macroscopic population output, from which clinical outcome could be predicted, artificial tissue could be assembled, etc.
 +
                        </p>
 +
 
 +
                    </div>
 +
<div class="expFigureHolder" style="width:100%">
 +
    <img class="responsive-img" src="https://static.igem.org/mediawiki/2018/d/d0/T--Fudan--LC-gj-software.png" />
 +
    <p class="flow-text">In our GJ presentation (10/25 Room 311 9:00-9:25), we used the image above to demonstrate a possible clinical outcome with cells having 100-fold granzyme release.</p>
 +
</div>
 +
                    <div id="section2" class="section container scrolSpy">
 +
                         <h2>Introduction
 +
                        </h2>
 
                         <p class="flow-text">
 
                         <p class="flow-text">
Hardware
+
                            Modeling is necessary for quantifying biological processes and designing biological systems for customized function. With the increasingly rapid development of synthetic biology, many models are based on different branches of applied mathematics, as exampled by stochastic process, cellular automaton, dynamic systems, and Boltzmann kinetics for different biological processes. For example, automaton is often used to model birth and death processes, stochastic processes is often used to model transcription factor-DNA binding,dynamic systems is often used in population ecology to predict the evolution of colony, and Boltzmann kinetics is often used to quantitatively describe chemical reactions. Some toolkit based on this model, like <a href="http://www.compucell3d.org/" target=_blank>CompCell3D</a>, has been developed for computational nanotechnology and simulating tissue development.
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            However, there hasn’t a ready single model for our ENABLE project. It is because an overall model for our project should not only consist the 3-layer standard design (for more details please visit <a href="/Team:Fudan-TSI/Results">our Results page</a>) but also the biological mechanism underlying it (for more details please visit <a href="/Team:Fudan-TSI/Model">our Modeling page</a>).
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            Here we present a software (<a href="https://github.com/0vioiano/iGEM2018_Team_Fudan" target=_blank>github.com/0vioiano/iGEM2018_Team_Fudan</a>) using multiscale mathematical tools for different biological processes, which serves as a reusable tool for cell colony design. We use different modules packaged in different <i>Classes</i> to simulate different biological processes. Based on the object-oriented principal, it is easy for users to realize customized Classes and simulate cell colony using our software.
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            A colony is occupied by different populations, a population is unitized by abundant individuals, be it a cell or an ensemble of various cells, and a cell is a network of chemicals, for example, proteins, lipids, nucleotides, etc. To simulate cell colony, our software bridges a nanoscopic transcriptional design of biological circuits, with microscopic cellular behaviors, up to a macroscopic population output, from which clinical outcome could be predicted, artificial tissue could be assembled, etc.
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            A demonstration using our software to simulate the process of our engineered cells collaborating to wipe out cancer cells are offered as <a href="https://github.com/0vioiano/iGEM2018_Team_Fudan/tree/master/demo" target=_blank>a demo</a>.
  
 +
                        </p>
  
Video: This is the last episode of our documentary series. We draw out, model and demonstrate our final design.
+
                    </div>
 +
                    <div id="section3" class="section container scrolSpy">
 +
                        <h2>Method
 +
                        </h2>
 +
                        <p class="flow-text">Our software is built based on OOP algorithm and MATLAB. The workflow of our software is shown below. For more details, please refer to <a href="https://github.com/0vioiano/iGEM2018_Team_Fudan" target=_blank>src and demo folders on GitHub</a>.
 +
                        </p>
 +
                        <div class="expFigureHolder" style="width:100%">
 +
                            <img style="width: 100%" src="https://static.igem.org/mediawiki/2018/5/57/T--Fudan--Software-1.png">
 +
                            <p class="flow-text">Figure.1 UML of our toolbox.
 +
                            </p>
  
GBC Documentary P5
+
                        </div>
 +
                        <div class="expFigureHolder" style="width:100%;margin-top: 23px">
 +
                            <img style="width: 100%" src="https://static.igem.org/mediawiki/2018/1/17/T--Fudan--Software-2.png">
 +
                            <p class="flow-text">Figure.2 Workflow of our software.
 +
                            </p>
  
Last Episode
+
                        </div>
Check Full Playlist
+
                        <p class="flow-text">
 +
                            <b>Initialization:</b> First, initialize the system. Use the formative text as input, then designate the initial state of each cell (life span, type, vitality), properties of each cell type (type of Ligand and Notch, proliferation rate, mean vitality, and special chemical reactions in cells of this type), and relationship between cells (binding affinity between cells, which can be related to cell type and expression of membrane proteins, such as Notch and Ligand).
  
 +
                        </p>
 +
                        <div class="tableHolder">
 +
                            <table>
 +
                                <tr>
 +
                                    <th>Parameter</th>
 +
                                    <th>Meaning</th>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td>T</td>
 +
                                    <td>Temperate, measuring the effect of random move.</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td>E_neighbor</td>
 +
                                    <td>Affinity, measuring the effect of directional movement of cell based on cell-cell recognition.</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td>Nm</td>
 +
                                    <td>Sampling rate in dt, measuring the rate of cell movement.</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td>dt</td>
 +
                                    <td>The step length of Euler method in our simulation.</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td>T</td>
 +
                                    <td>Simulation time, measuring how long we want to simulate with our software.
 +
                                    </td>
 +
                                </tr>
 +
                            </table>
 +
                        </div>
 +
                        <p class="flow-text">
 +
                            <b>Iteration:</b> After initiation, an iteration is made. In a period of &delta;t (very short time, and at the scale at 1-10 seconds), the cell may try to migrate, proliferate, or contact to neighboring cells to gather information for choice making. What is worth noticing is that if the cell moves/divides/dies, the Notch-Ligand kinetics may change abruptly for the changing cell-cell interaction, and a movement is relatively rapid compared with cell size. Therefore, it only takes little time for the switching of cell-cell network, but the process of finding proper movement takes some.
  
Thanks all for watching! The previous episode is about incorporating ‘Value Sensitive Design’ into the safety concerns of this hardware.
+
                        </p>
 +
                        <p class="flow-text">
 +
                            Within the interval of two “cellular movements (proliferation/migration/death included)”, “chemical movements” happens. This refers to the Notch-Ligand kinetics between cell membranes, the amplification of the signal of Notch ICD (intracellular domain) and the combination of augmented signals. Using <a href="https://en.wikipedia.org/wiki/Euler_method" target=_blank>Euler method</a> (for kinetics) and discrete <a href="https://en.wikipedia.org/wiki/Gillespie_algorithm" target="_blank">Gillespie algorithm</a> (for stochastic process), we have predicted how a single cell works in a period within the interval of <b>cellular movements</b> (proliferation/migration/death included) and <b>chemical movements</b>, which refers to the <a href="/Team:Fudan-TSI/Model#NotchLigandKinetics">Notch-Ligand kinetics</a> between cell membranes, the amplification of the signal of Notch intracellular domain and the combination of augmented signals.
  
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            After this prediction, we construct some functions to record the general state of each cell, including index, position, age, and then tendency to die or divide, for further data analysis. A snapshot of our cell colony is taken simultaneously for further simulation visualization. A judgement statement is executed to determine whether to terminate (when &delta;t multiples iteration time is greater than T, the full length of the simulation) or continue to iterate (both cellular movements and chemical movements). Movements in a single iteration seems negligible, but a big number of iterations would show a difference.
  
 +
                        </p>
 +
                        <p class="flow-text">For more details of cellular movement, please refer to the <a href="#">supplementary material</a>; for more details of chemical movement, please refer to our modeling of <a href="/Team:Fudan-TSI/Model#NotchLigandKinetics">Notch-Ligand Kinetics</a>.
 +
                        </p>
 +
                        <p class="flow-text">
 +
                            <b>Data analysis:</b> Upon simulation termination, data will be analyzed using prepared functions. We offer APIs for cell track, cell census and cell network analysis.
  
 +
                        </p>
 +
                        <p class="flow-text"><b>Simulation visualization:</b> Using <i>clips</i> recorded in Iteration step, it’s easy to get our simulation visualized using built-in Matlab function <i>videowrite</i>. Cell colony composition can be checked by watching the output video.
 +
                        </p>
 +
                    </div>
 +
                    <div id="section4" class="section container scrolSpy">
 +
                        <h2>Tutorials (single functions)
 +
                        </h2>
 +
                        <p class="flow-text">To make users familiar to our toolbox, a tutorial is as follows.</p>
 +
                        <h4>Notch-Ligand kinetics (using <i>ChemicalReactions</i> toolkit)
 +
                        </h4>
 +
                        <p class="flow-text"><i>ChemicalReactions</i> toolkit is a toolkit for chemical reaction modeling using <a href="https://en.wikipedia.org/wiki/Petri_net#Mathematical_properties_of_Petri_nets" target=_blank>Petri net</a> and Possion process. Here we demonstrate the usage of <i>ChemicalReactions</i> through an example of Notch-Ligand kinetics modeling.
 +
                        </p>
 +
                        <div class="expFigureHolder" style="width:100%;margin-top: 23px">
 +
                            <img class="responsive-img" src="https://static.igem.org/mediawiki/2018/5/5f/T--Fudan--Software-3.png">
 +
                            <p class="flow-text">
 +
                                Figure 3. Notch-Ligand kinetics analysis using ChemicalReactions toolkit. Code are offered on <a href="https://github.com/0vioiano/iGEM2018_Team_Fudan" target=_blank>Github</a>.
 +
                            </p>
  
Introduction
+
                        </div>
 +
                        <h4>STEP 1</h4>
 +
                        <p class="flow-text">Open MATLAB, and open the file ChemicalReactions.md in folder @ChemicalReactions.</p>
 +
                        <h4>STEP 2</h4>
 +
                        <p class="flow-text">prepare MATLAB variables.<br/>
 +
                            >>[Pre,Post]=Pre_Notch_Ligand(2)<br/>
 +
                                    >>obj= ChemicalReactions(‘’,’’,Post,Pre,@H_Notch_Ligand,zeros(1,12),2)
 +
</p><p class="flow-text">
 +
                                    Here Pre_Notch_Ligand() is a function to generate transition matrix for chemical reactions, @H_Notch_Ligand is a function handle for calculation of reaction possibilities, zeros(1,12) designates the initial condition of the system, and 2 refers to 2 kinds of Notch/Ligand exist.
  
Having noticed it is the difficulty in capturing cats that largely impeded the executive of TNR (Trap, Neuter, Release), we realized that the feline-attracting characteristic of nepetalactone could be of great help (For more details on why nepetalactone appeals felines, see Project Background). Compared to cage traps and usual food lure, the pleasant scent of nepetalactone in catnip would appear to cats less of a pitfall, therefore more easily let down the guard of stray cats. With this need clearly identified, we devised a brand new hardware, which can attract and seize stray cats when needed, provides cats with comfortable and secure shelter, and contains an auto-feeder to reduce the workload of the volunteered caregivers. With a beautiful wish that this device would be the promised land for the roaming cats, we named it ‘Kitty Wonderland’.
 
 
 
Most of the features and their corresponding functions of the Kitty Wonderland are identified in Figures 1, which demonstrate the final version and the separate sections of our Kitty Wonderland. The functions and adaptations of every component will be discussed and explained comprehensively later in the Design.
 
 
Figure 1. The 3D Modeling Figure of the whole structure, The Base, The House and The Roof of Kitty Wonderland.
 
 
 
Before we came up with the idea of the design of this final version, we gathered and analyzed information and advice from specialists, officials and residence. Corresponding evaluations and modifications have been done to compare our hardware with the existing solutions and improve the possible performance of our design, as explained in the next section.
 
 
Evaluations and Improvements
 
 
Animal lovers in various communities have installed many simple shelters with food and water supplies under their apartments. The price of these simple shelters are cheap (Most of the shelters are made of paperboard plastics) and these shelters are tiny and light so it is very easy to transport and carry them. However, they are not waterproof and therefore could only be placed under the roof where only a confined space is available (Figure 2). Since these shelters only serve to provide stray cats with foods, no cat will be captured and therefore no sterilization could be done. In order to solve the stray cats problem thoroughly, capture and neuter are the priorities and certain number of cats needs to be sterilized to inhibit the surge of stray cats population before further measures are undertaken.
 
 
In addition, many rescue parties of cats and dogs have already adopted modified cages which serve purely to trap stray cats and dogs (Figure 2). However, this method presents issues and concerns due to the fact that those cages don’t actually offer any benefits to cats and dogs but trap anything enters the cage immediately. Therefore, cats and dogs are becoming increasingly indifferent to those steel cages, which not only fail to demonstrate their functions but also pose threats to the animal. Besides, the sharp and harsh appearance of those steel cages doesn’t appeal to cat and dog at all. Pedestrian and residence will also find those cages very abrupt and unattractive, thus having negative attitudes towards the actions of the rescue team. None of these is helpful in taking care of cats and dogs and rescuing them effectively, not to mention the aim of emphasizing the problem of stray cats and dogs to the public and encouraging every citizen to get involve in the rescue.
 
 
 
Figure 2. The investigation of the current solutions of stray cats problem.
 
 
 
Design
 
 
Our Kitty Wonderland is made of wooden boards and some extra components like the camera and electric fan which enhance the functionality of the Kitty Wonderland. We select wooden boards instead of plastics or steels because wood is more nature and intimate to cat and it also has outstanding properties like relatively light and heat-insulated. Paintings, drawings and crafts could also be applied easily to the wooden boards to improve the appearance of our hardware. During the construction of the Kitty Wonderland, we simply nail all the components and wooden boards together.
 
 
The design of Kitty Wonderland is quiet complex, so the whole structure is broken down into three individual parts which are further explained. We name these three parts The Base, The House and The Roof respectively.
 
 
The pictures of The Base and The House are shown in Figure 3. The Base is consists of a wooden box with a lid, a 3D printed pedestal and a PVC tube of 90 cm long. In consideration of the protection and safety of battery and other appliance, we make the wooden box and cover the bottom of it with plastic, so the box is made waterproof and can protect the electric appliance inside the box. This wooden box could also provide a foundation and elevation for the main house which is placed on top of it, so our design could be placed on the streets where no shelter against rain is present and the House will not be submerged by heavy rain or flood. The plastic pedestal in nailed at the bottom of the Base and it is designed for the consolidation of the PVC tube, which runs all the way to the top of The House. The PVC pipe has two functions: To immobilized the house and to protect the wiring. Electrical appliance like the camera and the electric fan are installed on the top of the House. In order to connect the wires between the battery and the appliance without imposing potential danger on the cats and damaging the appearance of Kitty Wonderland, we apply this PVC tube into our design to allow wires go through it. Since the PVC tube runs through The Base and The House (The lid of The Base and the bottom of The House both have a hole with the diameter of the PVC tube in the middle), it connects and stabilizes the whole structure.
 
 
 
Figure 3. Demonstration of the appearance and design of The Base and The House of Kitty Wonderland
 
 
 
Right on top of The Base is The House. The House is the place where cats enjoy their lives. Two sliding electric doors are installed on the inner opposite sides of the House, and each door is controlled by a motor. After a cat enters the House, what happens is the sensor above the door detects the cat and the sensor sends signal to the central controller in The Roof or in The Base, which then activates the motors and closes the door. The door could also be adjusted to remain open, so the Kitty Wonderland becomes a habitat of cats and will not capture the cats if necessary. An inverted camera is also installed at one top corner of The House to monitor the conditions inside the House for recording and safety purposes (For more detailed safety considerations, see Application and Safety below). The chemical of our final production, the nepetalactol, and the foods inside the auto-feeder are used to further attract and entertain the cats. The nepetalactol is placed inside the essence oil container which is situated on the top of The House. The wooden board of the top is processed so that a total of 49 ventilation holes with diameter of 2 cm are created. These holes allow gas exchange to occur, and they also allow the wires from the motors and sensors inside The House to reach The Roof safely and easily. Through the ventilation holes, the fragrance of nepetalactol could easily diffuse down into The House where its enthusiastic consumers live and play. The foods and water inside the House also allow cats to stay for a long period of time. All together, these treats will make our design a paradise for cats.
 
 
The final section of our design is The Roof, as shown with the whole structure in Figure 4. In the 3D Modeling Figure, the demonstration on the left is the bottom view of The Roof. An inverted electric fan is fixed on the roof. Its function is to strengthen the air flow though our design and facilitate the diffusion of nepetalactol inside the essence oil container, so distant stray cats are also guided by the fragrance of the oil to our Kitty Wonderland. Since there are electric wires and appliance under the Roof, the lateral sides of the Roof are sealed in consideration of the safety of cats as well as the appearance of the design. Thirteen ventilation pores are made on two sealed sides to allow air flow through our design. The Roof is fixed on the top of The House by bolts and nuts, which allow us to remove The Roof and add nepetalactol quiet easily.
 
 
 
Figure 4. 3D Modeling Figure of The roof (Picture 1) and the demonstration of the detailed design of The Roof. The final structure of our Hardware in shown in picture 4
 
 
 
All sections are combined to produce the complete structure of our hardware. In practise, the Base Lid will be placed on top of The Base under The House to provide an extra shielding for the electric appliance (Figure 4).
 
 
After recognizing the functions of each component of our design, a brief description of the scenario of implementing our Kitty Wonderland is written below for your further understanding.
 
 
 
Application and Safety
 
 
Our design will be placed on flat ground. Direct exposure to intense sunshine or heavy rain should be avoided as much as possible in consideration of the conditions of battery and other electrical appliance in the Base, in spite of the heat insulation and waterproof properties of the Base. The electric fan under the roof will spread the fragrance of the essence oil, which would fascinate the cats and guide them to our design. Foods and water will be placed inside the House in advance to treat and ease the cats. After a cat enters the House, the motion of the cat will be detected immediately by the sensor which then sends a signal to the electric door through the controller. If necessary, the electric door will shut down so that the cat is remained in our design and awaits the arrival of professionals. The whole process will be recorded by the camera inside the house for future reference and safety consideration. If there is an emergency, the workers nearby will be acknowledged through the camera immediately and they could then remotely control the electric door and release the cats.
 
 
Apart from the camera, the electric fan and the nepetalactol under the roof is completely isolated from the range of activity of the cats. Two sealed sides of The Roof mainly serve to keep the cats away from these potential danger, even though the fan is working at very low power and the wires are sealed. The wiring inside the House, as well as the gears and racks of the electric door, are also covered with tapes and metal shielding to prevent cat from touching these components. The tapes and metal shielding are removed in the pictures and 3D Modeling Figures above for explicit demonstration of our design. The position of the hardware should also be away from places with crowds and harsh weather. Long-term heating by sunlight might result in battery failure, so we place the battery under the structure and insulate it by using another wooden box. Our recommended position of the hardware is place where vegetation and shades are available, like a park or sides of a trail, and definitely where cats are playing.
 
 
                         </p>
 
                         </p>
 
+
                        <h4>STEP 3</h4>
                         <h2>title</h2>
+
                         <p class="flow-text"> Enter in the command line window<br/>
 +
                            >>XMat=obj.iteration(100,1)<br>
 +
                            >>for i =1:12<br>
 +
                            >>plot(XMat(:,i));<br>
 +
                            >>hold on<br>
 +
                            >>end
 +
                        </p><p class="flow-text">
 +
                            Here iteration() is a method of class <i>ChemicalReactions</i> for predicting the state of the system. (100, 1) is the setting step for data recording, and XMat is for data storage.
 +
                        </p><p class="flow-text">
 +
                            To repeat the results of Figure 3, please refer to <a href="https://github.com/0vioiano/iGEM2018_Team_Fudan" target=_blank>Github</a> for code.
 +
                        </p>
 +
                        <h3>War predictor (using <i>Cell2DProl</i> toolkit)
 +
                        </h3>
 
                         <p class="flow-text">
 
                         <p class="flow-text">
                             Fangfei Ye is responsible for all <a href="/Team:Fudan-TSI/Design_Intention" target="_blank">art design</a>, which includes our team logo, team flag, team uniform (Dr. Cai gave comments), team name card, brochures, our posters, as well as materials related to our human practice events.
+
                             <i>Cell2DProl</i> toolkit is a toolkit for Cell colony simulation. For more details, please refer to the <a href="#">supplementary material at the end of this page</a> or <a href="https://github.com/0vioiano/iGEM2018_Team_Fudan" target=_blank>Github</a>.
 +
                            Here we demonstrate the usage of <i>Cell2DProl</i> through an example of therapeutic engineered cell design.
 
                         </p>
 
                         </p>
                    </div>
+
                        <div class="expFigureHolder" style="width:100%;margin-top: 23px">
 +
                            <img class="responsive-img" src="https://static.igem.org/mediawiki/2018/1/1d/T--Fudan--Software-4.png">
 +
                            <p class="flow-text">
 +
                                Figure 4. Demo - visualization function in the <i>Cell2DProl</i> toolkit
 +
                            </p>
  
                    <div class="section container scrolSpy" id="section2">
+
                        </div>
                      <div class="figureHolder">
+
                        <div class="expFigureHolder" style="width:100%;margin-top: 23px">
                          <p class="flow-text">PCR and subcloning were performed using standard methods. Detailed primer sequences are <a href="/Team:Fudan-TSI/Primers">provided</a>. All constructs were verified by Sanger sequencing.
+
                            <img class="responsive-img" src="https://static.igem.org/mediawiki/2018/b/be/T--Fudan--Software-5.png">
                          </p>
+
                            <p class="flow-text">
                          <p class="flow-text">Cells were cultured in DMEM supplemented with 10% FBS (HyClone), 100 U/ml penicillin, 100 μg/ml streptomycin and 1x GlutaMax (Gibco). Transient transfections were performed using Lipofectamine 2000 (Invitrogen) and Opti-MEM (Gibco). Viral packaging, infection and fluorescence-activated cell sorting were performed using standard methods.
+
                                Figure 5. Demo - Data analysis functions in <i>Cell2DProl</i> toolkit
                          </p>
+
                            </p>
                          <p class="flow-text">Images, unless otherwise indicated, were captured using an inverted epifluorescence microscope (IX-81, Olympus) and a sCMOS camera (pixel size = 0.3222 &mu;m; Zyla 5.5, Andor; 20x objective N.A.  0.75) and were controlled by <a href="http://www.micro-manager.org/" target=_blank>Micro-Manager software</a>.
+
                          </p>
+
                          <p class="flow-text">All statistical analysis was performed using Prism (Graphpad) and <a href="http://rsbweb.nih.gov/ij/developer/macro/macros.html" target=_blank>ImageJ</a>. All experiments were independently performed in triplicates; unless otherwise indicated. Images were combined and annotated in Powerpoint for presentation. Representative images are shown.
+
                          </p>
+
                      </div>
+
-
+
                      <div class="tableHolder">
+
                          <table>
+
                              <tr>
+
                                  <th>Our protocols as PDF files</th><th>&nbsp;</th>
+
                                  <th>Download</th>
+
                              </tr>
+
                              <tr>
+
                                  <td>Be a Good Lab Member</td><td><i>GoodLabPractices.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--GoodLabPractices.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Molecular Cloning</td><td><i>MolecularCloning.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--MolecularCloning.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Tissue Culture</td><td><i>CellCulture.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--CellCulture.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Make a Stable Cell Line</td><td><i>MakeStableCellLine.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--MakeStableCellLine.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Cell Sorting</td><td><i>FACS.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--FACS.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Cell Staining</td><td><i>FixStain.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--FixStain.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                              <tr>
+
                                  <td>Time-lapse Live-cell Imaging</td><td><i>TimeLapseImaging.pdf</i></td>
+
                                  <td><a href="https://2018.igem.org/File:T--Fudan--TimeLapseImaging.pdf" target="_blank"><i class="fa fa-download"></i></a></td>
+
                              </tr>
+
                          </table>
+
                      </div>
+
                      <p style="color:grey">
+
                          For practical reasons, all full-length protocols are in Chinese.
+
                      </p>
+
                  </div>
+
  
                    <div class="section container scrolSpy" id="section3">
+
                        </div>
                         <h2>title</h2>
+
                        <h4>STEP 1</h4><p class="flow-text">Open MATLAB, and open the file Cell2DShadeProl.md in your folder.</p>
                         <p class="flow-text">
+
                         <h4>STEP 2</h4><p class="flow-text">Click the ‘run’ on the panel.</p>
                            content content
+
                         <p class="flow-text">Here all the parameters are set proper previously. For more details on parameters, please refer to the supplementary PDF below. If your simulation results are visualized successfully, a video called 1_6_1_6 can be found in your current folder.
 
                         </p>
 
                         </p>
 +
                        <h4>STEP 3</h4><p class="flow-text">The left Figure in Figure 5 will be plotted automatically. To get the right figure, Enter in the command line window<br/>
 +
                            >> res1 = -Culture.*(Culture&lt;-1);<br/>
 +
                            >> res2 = res1(:);<br/>
 +
                            >> ecdf(res2);</p>
 +
                        <h3>OOP-based AND gate design (using <i>Cell</i> toolkit)</h3>
 +
                        <p class="flow-text"><i>Cell</i> toolkit is a toolkit to design combinational circuits by linking user-defined cellular movement (element) together. Here we show you how to use our toolkit <i>Cell</i> by an example of AND gate circuit design.
 +
                        </p>
 +
                        <div class="expFigureHolder" style="width:100%;margin-top: 23px">
 +
                            <img class="responsive-img" src="https://static.igem.org/mediawiki/2018/8/84/T--Fudan--Software-6.png">
 +
                            <p class="flow-text">
 +
                                Figure 6. Demo - Simulation of 3-layer ENABLE using <i>Cell</i> toolkit
 +
                            </p>
  
                         <h2>title</h2>
+
                         </div>
                         <p class="flow-text">
+
                         <h4>STEP 1</h4><p class="flow-text">Open MATLAB, and open the folder with subfolder @Cell.
                            Fangfei Ye is responsible for all <a href="/Team:Fudan-TSI/Design_Intention" target="_blank">art design</a>, which includes our team logo, team flag, team uniform (Dr. Cai gave comments), team name card, brochures, our posters, as well as materials related to our human practice events.
+
                        </p >
 +
                        <h4>STEP 2</h4><p class="flow-text">Run kinetic_notch_test.m, kinetic_addgate_test_signal.m, kinetic_addgate_test.m<br/>
 +
                        Here we use kinetic model for Notch activation and signal amplification, and 3-step kinetics for intein kinetics to validate the function of our toolkit.
 +
                        </p>
 +
                        <h4>STEP 3</h4><p class="flow-text">Figure 6 will be output automatically.
 
                         </p>
 
                         </p>
 
                     </div>
 
                     </div>
 
+
                    <div class="section container">
 +
                        <h4>Supplementary PDF with references
 +
                        </h4>
 +
                        <p class="flow-text"><a href="https://static.igem.org/mediawiki/2018/c/c1/T--Fudan--model-cell-colony.pdf" target="_blank">Model_cell_colony</a></p>
 +
                    </div>
 
                 </main>
 
                 </main>
 
             </div>
 
             </div>
 +
            <!-- end of main content of the page -->
  
            <!--Abstract on content page-->
+
<!--Abstract on content page-->
 
             <div id="abstractContent" class="z-depth-2">
 
             <div id="abstractContent" class="z-depth-2">
 
                 <a href="#!"><img alt="project summary" src="https://static.igem.org/mediawiki/2018/9/96/T--Fudan--X.svg"></a>
 
                 <a href="#!"><img alt="project summary" src="https://static.igem.org/mediawiki/2018/9/96/T--Fudan--X.svg"></a>

Revision as of 07:13, 17 September 2019

<script src="https://code.jquery.com/jquery-1.11.3.min.js"></script> 2019 Team:Fudan-TSI Software

Software

...

Software

...

Our software tool was built based on (1) modeled parameters characterizing our 3-layer design; (2) populational description of individual cellular behaviors. We found that several cell behaviors and ENABLE signaling have key impact on the evolution of a cell colony with mixed cell types. In an object-oriented-programming and user-friendly style, our software allows users to adjust those key factors and profile the fate of their own mixed cells. Our software bridges a nanoscopic transcriptional design of biological circuits, with microscopic cellular behaviors, up to a macroscopic population output, from which clinical outcome could be predicted, artificial tissue could be assembled, etc.

In our GJ presentation (10/25 Room 311 9:00-9:25), we used the image above to demonstrate a possible clinical outcome with cells having 100-fold granzyme release.

Introduction

Modeling is necessary for quantifying biological processes and designing biological systems for customized function. With the increasingly rapid development of synthetic biology, many models are based on different branches of applied mathematics, as exampled by stochastic process, cellular automaton, dynamic systems, and Boltzmann kinetics for different biological processes. For example, automaton is often used to model birth and death processes, stochastic processes is often used to model transcription factor-DNA binding,dynamic systems is often used in population ecology to predict the evolution of colony, and Boltzmann kinetics is often used to quantitatively describe chemical reactions. Some toolkit based on this model, like CompCell3D, has been developed for computational nanotechnology and simulating tissue development.

However, there hasn’t a ready single model for our ENABLE project. It is because an overall model for our project should not only consist the 3-layer standard design (for more details please visit our Results page) but also the biological mechanism underlying it (for more details please visit our Modeling page).

Here we present a software (github.com/0vioiano/iGEM2018_Team_Fudan) using multiscale mathematical tools for different biological processes, which serves as a reusable tool for cell colony design. We use different modules packaged in different Classes to simulate different biological processes. Based on the object-oriented principal, it is easy for users to realize customized Classes and simulate cell colony using our software.

A colony is occupied by different populations, a population is unitized by abundant individuals, be it a cell or an ensemble of various cells, and a cell is a network of chemicals, for example, proteins, lipids, nucleotides, etc. To simulate cell colony, our software bridges a nanoscopic transcriptional design of biological circuits, with microscopic cellular behaviors, up to a macroscopic population output, from which clinical outcome could be predicted, artificial tissue could be assembled, etc.

A demonstration using our software to simulate the process of our engineered cells collaborating to wipe out cancer cells are offered as a demo.

Method

Our software is built based on OOP algorithm and MATLAB. The workflow of our software is shown below. For more details, please refer to src and demo folders on GitHub.

Figure.1 UML of our toolbox.

Figure.2 Workflow of our software.

Initialization: First, initialize the system. Use the formative text as input, then designate the initial state of each cell (life span, type, vitality), properties of each cell type (type of Ligand and Notch, proliferation rate, mean vitality, and special chemical reactions in cells of this type), and relationship between cells (binding affinity between cells, which can be related to cell type and expression of membrane proteins, such as Notch and Ligand).

Parameter Meaning
T Temperate, measuring the effect of random move.
E_neighbor Affinity, measuring the effect of directional movement of cell based on cell-cell recognition.
Nm Sampling rate in dt, measuring the rate of cell movement.
dt The step length of Euler method in our simulation.
T Simulation time, measuring how long we want to simulate with our software.

Iteration: After initiation, an iteration is made. In a period of δt (very short time, and at the scale at 1-10 seconds), the cell may try to migrate, proliferate, or contact to neighboring cells to gather information for choice making. What is worth noticing is that if the cell moves/divides/dies, the Notch-Ligand kinetics may change abruptly for the changing cell-cell interaction, and a movement is relatively rapid compared with cell size. Therefore, it only takes little time for the switching of cell-cell network, but the process of finding proper movement takes some.

Within the interval of two “cellular movements (proliferation/migration/death included)”, “chemical movements” happens. This refers to the Notch-Ligand kinetics between cell membranes, the amplification of the signal of Notch ICD (intracellular domain) and the combination of augmented signals. Using Euler method (for kinetics) and discrete Gillespie algorithm (for stochastic process), we have predicted how a single cell works in a period within the interval of cellular movements (proliferation/migration/death included) and chemical movements, which refers to the Notch-Ligand kinetics between cell membranes, the amplification of the signal of Notch intracellular domain and the combination of augmented signals.

After this prediction, we construct some functions to record the general state of each cell, including index, position, age, and then tendency to die or divide, for further data analysis. A snapshot of our cell colony is taken simultaneously for further simulation visualization. A judgement statement is executed to determine whether to terminate (when δt multiples iteration time is greater than T, the full length of the simulation) or continue to iterate (both cellular movements and chemical movements). Movements in a single iteration seems negligible, but a big number of iterations would show a difference.

For more details of cellular movement, please refer to the supplementary material; for more details of chemical movement, please refer to our modeling of Notch-Ligand Kinetics.

Data analysis: Upon simulation termination, data will be analyzed using prepared functions. We offer APIs for cell track, cell census and cell network analysis.

Simulation visualization: Using clips recorded in Iteration step, it’s easy to get our simulation visualized using built-in Matlab function videowrite. Cell colony composition can be checked by watching the output video.

Tutorials (single functions)

To make users familiar to our toolbox, a tutorial is as follows.

Notch-Ligand kinetics (using ChemicalReactions toolkit)

ChemicalReactions toolkit is a toolkit for chemical reaction modeling using Petri net and Possion process. Here we demonstrate the usage of ChemicalReactions through an example of Notch-Ligand kinetics modeling.

Figure 3. Notch-Ligand kinetics analysis using ChemicalReactions toolkit. Code are offered on Github.

STEP 1

Open MATLAB, and open the file ChemicalReactions.md in folder @ChemicalReactions.

STEP 2

prepare MATLAB variables.
>>[Pre,Post]=Pre_Notch_Ligand(2)
>>obj= ChemicalReactions(‘’,’’,Post,Pre,@H_Notch_Ligand,zeros(1,12),2)

Here Pre_Notch_Ligand() is a function to generate transition matrix for chemical reactions, @H_Notch_Ligand is a function handle for calculation of reaction possibilities, zeros(1,12) designates the initial condition of the system, and 2 refers to 2 kinds of Notch/Ligand exist.

STEP 3

Enter in the command line window
>>XMat=obj.iteration(100,1)
>>for i =1:12
>>plot(XMat(:,i));
>>hold on
>>end

Here iteration() is a method of class ChemicalReactions for predicting the state of the system. (100, 1) is the setting step for data recording, and XMat is for data storage.

To repeat the results of Figure 3, please refer to Github for code.

War predictor (using Cell2DProl toolkit)

Cell2DProl toolkit is a toolkit for Cell colony simulation. For more details, please refer to the supplementary material at the end of this page or Github. Here we demonstrate the usage of Cell2DProl through an example of therapeutic engineered cell design.

Figure 4. Demo - visualization function in the Cell2DProl toolkit

Figure 5. Demo - Data analysis functions in Cell2DProl toolkit

STEP 1

Open MATLAB, and open the file Cell2DShadeProl.md in your folder.

STEP 2

Click the ‘run’ on the panel.

Here all the parameters are set proper previously. For more details on parameters, please refer to the supplementary PDF below. If your simulation results are visualized successfully, a video called 1_6_1_6 can be found in your current folder.

STEP 3

The left Figure in Figure 5 will be plotted automatically. To get the right figure, Enter in the command line window
>> res1 = -Culture.*(Culture<-1);
>> res2 = res1(:);
>> ecdf(res2);

OOP-based AND gate design (using Cell toolkit)

Cell toolkit is a toolkit to design combinational circuits by linking user-defined cellular movement (element) together. Here we show you how to use our toolkit Cell by an example of AND gate circuit design.

Figure 6. Demo - Simulation of 3-layer ENABLE using Cell toolkit

STEP 1

Open MATLAB, and open the folder with subfolder @Cell.

STEP 2

Run kinetic_notch_test.m, kinetic_addgate_test_signal.m, kinetic_addgate_test.m
Here we use kinetic model for Notch activation and signal amplification, and 3-step kinetics for intein kinetics to validate the function of our toolkit.

STEP 3

Figure 6 will be output automatically.

Supplementary PDF with references

Model_cell_colony

project summary

Project Summary

Mutation library generation is critical for biological and medical research, but current methods cannot mutate a specific sequence continuously without manual intervention. Here we present a toolbox for in vivo continuous mutation library construction. First, the target DNA is transcribed into RNA. Next, our reverse transcriptase reverts RNA into cDNA, during which the target is randomly mutated by enhanced error-prone reverse transcription. Finally, the mutated version replaces the original sequence through recombination. These steps will be carried out iteratively, generating a random mutation library of the target with high efficiency as mutations accumulate along with bacterial growth. Our toolbox is orthogonal and provides a wide range of applications among various species. R-Evolution could mutate coding sequences and regulatory sequences, which enables the in vivo evolution of individual proteins or multiple targets at a time, promotes high-throughput research, and serves as a foundational advance to synthetic biology.