updated grid tutorial

docs/iBioSim_Grid_Tutorial.tex

@@ -11,7 +11,6 @@
 
 \author{Jason Stevens}
 
-\date{August 25th, 2011}
 
 \begin{document}
 
@@ -41,15 +40,15 @@ A grid is a structure used for separating components spatially.  So the first th
 
 \begin{enumerate}
 
-\item Below is the Sender 1 model.  It contains two constitutive species, one which will act as an input (SignalA) and the other as an aesthetic reporter (CFP).  Make sure that SignalA is marked as diffusible and that the model is enclosed in a compartment (tick the box on the toolbar).
+\item Below is the Sender 1 model.  It contains two constitutive species, one which will act as an input (SignalA) and the other as an aesthetic reporter (CFP).  Make sure that SignalA is marked as diffusible and degradable. Also, make sure that the model is enclosed in a compartment (uncheck the ``Is Mapped to a Port" on the Compartment Editor). Finally, change the open complex production rate ko to 0.5 as shown below. 
 
-\includegraphics[height=65mm]{screenshots/sender1}
+\includegraphics[height=65mm]{screenshots/newgrid/sender1}
 
 \item For the Sender 2 model, create a model similar to Sender 1 that has a different name (e.g., SignalB) for the diffusible species.
 
-\item Below is the model for the NOR gate cell.  At the left, you can see that two species repress a promoter that leads to production of a GFP species.  If both of the repressing species are marked diffusible and given the same ID as the species in Sender 1/2 (e.g., SignalA/B), then membrane diffusion reactions will be created and any SignalA/B species can come into or diffuse out of the cell.  If these species were not present or not marked diffusible, then no membrane diffusion reactions would be created.  In the figure there is also a species panel which shows custom diffusion rates (0.1/1.0 for kmdiff, 0.35 for kecdiff) that should be used for both SignalA and SignalB.  Also, change Kr to 5 for the two repression influences (by double-clicking on the red repression influences) and ko to 0.025 for the promoter.  Like Sender 1/2, this model needs to be enclosed in a compartment.  Enclosing it in a compartment creates a virtual membrane, which species can be transported through via membrane diffusion reactions.  (Note that membrane diffusion rates are taken from the inner species.  The membrane diffusion rates for the Sender models are kept as default for the sake of simplicity.)
+\item Below is the model for the NOR gate cell.  At the left, you can see that two species repress a promoter that leads to production of a GFP species.  If both of the repressing species are marked diffusible and given the same ID as the species in Sender 1/2 (e.g., SignalA/B), then membrane diffusion reactions will be created and any SignalA/B species can come into or diffuse out of the cell.  If these species were not present or not marked diffusible, then no membrane diffusion reactions would be created.  In the figure there is also a species panel which shows custom diffusion rate (0.01/1.0 for kmdiff) that should be used for both SignalA and SignalB.  Also, on the Constants tab change the value of kecdiff to 0.01.  Like Sender 1/2, this model needs to be enclosed in a compartment.  Enclosing it in a compartment creates a virtual membrane, which species can be transported through via membrane diffusion reactions.  (Note that membrane diffusion rates are taken from the inner species.  The membrane diffusion rates for the Sender models are kept as default for the sake of simplicity.)
 
-\includegraphics[height=60mm]{screenshots/norgate_signala}
+\includegraphics[height=60mm]{screenshots/newgrid/norgate_signala}
 
 \item The grid components are now done, so let's put them onto a grid!
 
@@ -61,21 +60,21 @@ A grid is a structure used for separating components spatially.  So the first th
 
 \begin{enumerate}
 
-\item To create a grid, create a new model and tick the "Make Grid" box when entering the model ID.  You will then be prompted to create a new grid.  Make this grid 6 x 15 and fill it with the NOR gate model.  After a moment, you will see a populated grid in the schematic.  If the grid is too large to fit, you can zoom out by selecting the zoom button in the toolbar, or holding alt or control, and then using the mouse wheel (or whatever you use for vertical scroll).  
+\item Create a grid model using the File $\rightarrow$ New $\rightarrow$ Grid Model menu, and name the new model as you wish. You will then be prompted to create a new grid.  Make this grid 6 x 15 and fill it with the NOR gate model.  After a moment, you will see a populated grid in the schematic.  If the grid is too large to fit, you can zoom out by selecting the zoom button in the toolbar, or holding alt or control, and then using the mouse wheel (or whatever you use for vertical scroll).  
 
-\includegraphics[height=40mm]{screenshots/create_grid}
+\includegraphics[height=40mm]{screenshots/newgrid/create_grid}
 
 \item The grid now only contains the NOR gate model, so we need to add the Sender models to the grid as well.  To do this, left-click on the four corners of the grid (they should appear light-blue if selected), then right-click and choose the "Clear Selected Location(s)" option.  (Placing the Sender models at the corners will allow for a good demonstration of the NOR functionality.)
 
-\includegraphics[height=55mm]{screenshots/clear_locations}
+\includegraphics[height=55mm]{screenshots/newgrid/clear_locations}
 
 \item Now let's add Sender 1 to the top two corners.  De-select the bottom two corners (by single-clicking), then right-click and choose the "Add Component(s) to Non-Occupied Selected Location(s)" option.  Choose the Sender 1 model at the prompt.
 
-\includegraphics[height=55mm]{screenshots/add_sender1}
+\includegraphics[height=55mm]{screenshots/newgrid/add_sender1}
 
 \item Now let's add Sender 2 to the bottom two corners.  To demonstrate another way of adding components, select the component radio button on the toolbar (looks like a square).  Left-click on one of the empty bottom two corners then choose the Sender 2 model at the prompt.  Do the same for the remaining empty corner.
 
-\includegraphics[height=55mm]{screenshots/add_sender2}
+\includegraphics[height=55mm]{screenshots/newgrid/add_sender2}
 
 \item The grid is now complete, so let's simulate it!
 
@@ -89,7 +88,7 @@ A grid is a structure used for separating components spatially.  So the first th
 
 \item Simulating a grid model is no different than simulating a non-grid model.  For my simulation run, I turned on abstraction, used Monte Carlo/Gillespie, and set a time limit of 400.  When you've chosen your simulation options, click the little green play button on the top toolbar.  This will generate the SBML and then simulate the model.  Simulation should take under a minute with the options provided.
 
-\includegraphics[height=55mm]{screenshots/grid_sim_options}
+\includegraphics[height=55mm]{screenshots/newgrid/grid_sim_options}
 
 \item When the simulation has finished, click on the Schematic tab.  If the model is too large to fit on your screen, you can zoom out by holding control or alt and using the mouse wheel (or whatever you use for vertical scroll).  Now click the "Choose Simulation" button and choose the simulation run you would like to use for playback (probably "Run-1.tsd").
 
@@ -99,7 +98,7 @@ A grid is a structure used for separating components spatially.  So the first th
 
 \item The appearance scheme is now complete, so hit the play button and watch the circuit in action!  You can drag the ticker around to see certain spots in the simulation, and if you'd like you can also zoom in/out and pan around while the simulation takes place.  The simulation should show the behavior below.  In the center, where the diffusible species don't reach well (i.e., where both inputs are OFF), there is GFP, indicating ON behavior; everywhere else (i.e., where either or both inputs are ON) there is no GFP, indicating OFF behavior.  By changing diffusion rates and how much of the SignalA/B species are produced, you can tune how large the green spot in the middle will be.
 
-\includegraphics[height=55mm]{screenshots/multicellular_nor_sim}
+\includegraphics[width=150mm]{screenshots/newgrid/multicellular_nor_sim}
 
 \item Hooray!  You have now completed the grid tutorial.  Hopefully this has given you a good sense of how to use {\tt iBioSim} for static spatial modeling.  If you have any questions, comments, suggestions, or issues, you can send an email to atacs-bugs@vlsigroup.ece.utah.edu.  Be sure to include "BUG", "CHANGE", or "FEATURE" (even if it's a question) in the subject line or it will be marked as spam.  Happy modeling!