In the beginning Uniform: Difference between revisions

From BanghamLab
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
[[GFtbox Tutorial pages|Back to Tutorial pages]]<br><br>
[[GFtbox Tutorial pages|Back to Tutorial pages]]<br><br>
We start with a number of very large screenshots (they are just here to orient you). They show the ''GFtbox'' graphical interface.
 
 
 
=Modelling uniform growth using the GUI alone=
=Modelling uniform growth using the GUI alone=
==First view==
==First view==
At first view the interface is daunting but try not to dispair. Some people, us at least, think it has a logic. It is divided into a set of panels. The largest is the plotting window on the right. Just to the left is a column of buttons, tick boxes, drop-down lists and buttons that control the plotting window.<br><br>
The GUI controls are organised into a number of panels. The largest is the plotting window on the right. Just to the left is a column of buttons, tick boxes, drop-down lists and buttons that control what appears in the plotting window.<br><br>
Top left is a panel for loading and saving projects. (one of the most used is Reset. If you have made a programming mistake in the interaction function it is necessary to Reset the GUI).<br><br>
At the top left is a panel for loading and saving projects.<br><br>
Below this is a Panel for selecting tools. These buttons select what Panel will be visible below, e.g. Mesh Editor, or Factors (for adding morphogens), etc.<br><br>
Below this is a panel for selecting tools. These buttons select what panel will be visible below, e.g. Mesh Editor, Factor, etc.<br><br>
At the bottom left are controls for running the model: Step, run for a specified number of steps, for a specified (model) time, run to a certain area (e.g. 2 times starting area). Above the Run Panel is a Panel for electing to Edit the interaction function, call the interaction function without actually growing.<br><br>
At the bottom left the Run panel contains controls for running the model: Step, run for a specified number of steps, for a specified (model) time, run to a certain area (e.g. 2 times starting area). Above the Run panel is a panel for creating and editing the interaction function.<br><br>
There are also controls on the Menu bar. At this stage you might consider that the GUI has the wrong sized font. It can be changed through the Menu:Misc:GUI format control.  
There are also controls on the Menu bar.


{| border="1" cellpadding="5" cellspacing="5"
{| border="1" cellpadding="5" cellspacing="5"
Line 19: Line 21:
{| border="1" cellpadding="5" cellspacing="5"
{| border="1" cellpadding="5" cellspacing="5"
|- valign="top"
|- valign="top"
|width="300px"|Create a canvas by clicking on ''Panel Mesh Editor:new''. A variety of preset shapes are available, here we choose a Circle with 4 concentric rings of nodes that is 2 mm in diameter.<br><br>By default the mesh is autoscaled and autocentred - it makes it easier to see shape changes but to see growth these are best turned off. Set the Panel:Plot options:Auto axis range to unticked and insert plot ranges -2.5 to 2.5 on x and y axes and 0 0 on z. Also turn off Menu:Plot:Autozoom and centre.<br><br><small>Idea: Special shapes can be imported as ''OBJ'' files. ''</small>
|width="300px"|Create a canvas by clicking on ''Panel Mesh Editor:new''. A variety of preset shapes is available. Here we choose a Circle with 4 concentric rings of nodes that is 2 mm in diameter.<br><br>By default the mesh is autoscaled and autocentred - it makes it easier to see shape changes but to see growth these are best turned off. Set the Panel:Plot options:Auto axis range to unticked and insert plot ranges -2.5 to 2.5 on x and y axes and 0 0 on z. Also turn off Menu:Plot:Autozoom and centre.<br><br><small>Idea: Special shapes can be imported as ''OBJ'' files. ''</small>
|width="500px"|[[File:gftboxGUIB_2.jpg|500px|GFtbox interface]]
|width="500px"|[[File:gftboxGUIB_2.jpg|500px|GFtbox interface]]
|}
|}
Line 31: Line 33:
{| border="1" cellpadding="5" cellspacing="5"
{| border="1" cellpadding="5" cellspacing="5"
|- valign="top"
|- valign="top"
|width="300px"|'''Now save the project''' using the ''Save As'' button. A dialogue box will open - here we keyed in ''in_the_beginning'' and the prefix ''GPT_'' and the suffix ''_date'' was added automatically.<br>A directory is created with the project name which contains all the files needed for the project and any results (snapshots, movies) we create.<br>
|width="300px"|'''Now save the project''' using the ''Save As'' button. A dialogue box will open - here we keyed in ''in_the_beginning'', and the prefix ''GPT_'' and the suffix ''_date'' were added automatically.<br>A directory is created with the project name which contains all the files needed for the project and any results (snapshots, movies) we create.<br>
''Select Tool:Simulation'' makes the ''Simulation'' Panel visible. <br>
''Select Tool:Simulation'' makes the ''Simulation'' Panel visible. <br>
Change the ''Panel Run:Run until'' box to 2 and click the ''Panel Run:Run until'' button. The canvas will grow in steps set by the ''Panel Simulation:Timescale'' box.<br><br>
Change the ''Panel Run:Run until'' box to 2 and click the ''Panel Run:Run until'' button. The canvas will grow in steps set by the ''Panel Simulation:Timescale'' box.<br><br>
Line 37: Line 39:
Idea: set the axes manually (here to +-3) and turn off Panel:Plot Options: Auto axis range and Menu:Plot:Auto zoom and centre. This enables growth to be seen as a change of size rather than change of axis range.
Idea: set the axes manually (here to +-3) and turn off Panel:Plot Options: Auto axis range and Menu:Plot:Auto zoom and centre. This enables growth to be seen as a change of size rather than change of axis range.
Idea: take a snapshot of the canvas by pressing Take snap... (c.f. image on right, button is bottom right of GUI controls)<br>
Idea: take a snapshot of the canvas by pressing Take snap... (c.f. image on right, button is bottom right of GUI controls)<br>
Idea: to create an uncompressed movie of your simulation, before running click the ''Record movie'' and when it is finished click ''Stop movie''. The movie will be in the Project directory. We normally compress the movies using Microsoft Live Movie Maker or Quicktime.</small>
Idea: to create a movie of your simulation, before running click the ''Record movie'' and when it is finished click ''Stop movie''. The movie will be in the directory containing the current project, which you can open with the menu command Projects:Show Current Project Folder.</small>
|width="500px"|[[Image:tut_uniform_growth_final.png|500px|GFtbox interface]]
|width="500px"|[[Image:tut_uniform_growth_final.png|500px|GFtbox interface]] The canvas is not flat because it started not flat. By default, a new mesh is given a small random perturbation to allow deformations out of the plane.
|}
|}

Latest revision as of 16:02, 24 June 2011

Back to Tutorial pages


Modelling uniform growth using the GUI alone

First view

The GUI controls are organised into a number of panels. The largest is the plotting window on the right. Just to the left is a column of buttons, tick boxes, drop-down lists and buttons that control what appears in the plotting window.

At the top left is a panel for loading and saving projects.

Below this is a panel for selecting tools. These buttons select what panel will be visible below, e.g. Mesh Editor, Factor, etc.

At the bottom left the Run panel contains controls for running the model: Step, run for a specified number of steps, for a specified (model) time, run to a certain area (e.g. 2 times starting area). Above the Run panel is a panel for creating and editing the interaction function.

There are also controls on the Menu bar.

The GFtbox user interface. Focus on the Select Tool Panel. Here the Mesh Editor has been selected and the Mesh Editor panel is visible.

GftboxGUIB 1detailB.jpg

Idea: change all GFtbox font sizes using Menu Misc:Gui Format

GFtbox interface

Add a mesh (canvas that represents tissue)

Create a canvas by clicking on Panel Mesh Editor:new. A variety of preset shapes is available. Here we choose a Circle with 4 concentric rings of nodes that is 2 mm in diameter.

By default the mesh is autoscaled and autocentred - it makes it easier to see shape changes but to see growth these are best turned off. Set the Panel:Plot options:Auto axis range to unticked and insert plot ranges -2.5 to 2.5 on x and y axes and 0 0 on z. Also turn off Menu:Plot:Autozoom and centre.

Idea: Special shapes can be imported as OBJ files.
GFtbox interface

Add a pattern of growth factor

Select Tool:Factors makes the Morphogen Panel visible. Currently we are controlling the KAPAR factor. It has been selected from a drop down list top right (Plot current factor). We add a constant level of KAPAR. Make sure that the Panel Plot Options:Monochrome is ticked and the gradient of KAPAR will be as shown. Do the same for the top face, KBPAR.

GFtbox interface

And grow

Now save the project using the Save As button. A dialogue box will open - here we keyed in in_the_beginning, and the prefix GPT_ and the suffix _date were added automatically.
A directory is created with the project name which contains all the files needed for the project and any results (snapshots, movies) we create.

Select Tool:Simulation makes the Simulation Panel visible.
Change the Panel Run:Run until box to 2 and click the Panel Run:Run until button. The canvas will grow in steps set by the Panel Simulation:Timescale box.

Warning: saving is essential if you want to Restart the simulation or if you want to save a movie.
Idea: set the axes manually (here to +-3) and turn off Panel:Plot Options: Auto axis range and Menu:Plot:Auto zoom and centre. This enables growth to be seen as a change of size rather than change of axis range. Idea: take a snapshot of the canvas by pressing Take snap... (c.f. image on right, button is bottom right of GUI controls)
Idea: to create a movie of your simulation, before running click the Record movie and when it is finished click Stop movie. The movie will be in the directory containing the current project, which you can open with the menu command Projects:Show Current Project Folder.

GFtbox interface The canvas is not flat because it started not flat. By default, a new mesh is given a small random perturbation to allow deformations out of the plane.