GFtbox Tutorial pages: Difference between revisions

From BanghamLab
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:
=Three ways to use ''GFtbox''=
=Three ways to use ''GFtbox''=
There are three ways to use the ''GFtbox''.<br>
There are three ways to use the ''GFtbox''.<br>
#'''Doing everything from the GUI'''. This is the best way to start. See (1,2) below.
#'''Doing everything from the Graphical User Interface (GUI)'''. This is the best way to start. See (1,2) below.
#'''Do only some things''' from the GUI. This is the best way to develop ideas. Use the GUI to generate the mesh (canvas) and create growth factors (morphogens - in other words declare the variables) but capturing your ideas on how the regulatory processes work in, what we call, the interaction function. See (3) below.
#'''Do only some things''' from the GUI. This is the best way to develop ideas. Use the GUI to generate the mesh (canvas) and create growth factors (morphogens - in other words declare the variables) but capturing your ideas on how the regulatory processes work in, what we call, the interaction function. See (3) below.
#'''Without the GUI'''. For example, run many examples (instances) of a pre-existing project on a cluster. This is the best way to explore the parameter space of a model for comparison with biological observations. We have used this way extensively but the code is not yet ready for general use.   
#'''Without the GUI'''. For example, run many examples (instances) of a pre-existing project on a cluster. This is the best way to explore the parameter space of a model for comparison with biological observations. We have used this way extensively but the code is not yet ready for general use.   
='''1''' Doing it through the GUI=
='''1''' Modelling using the Graphical User Interface=
== Isotropic growth==
== Isotropic growth==
===A===
===A===
Line 28: Line 28:
|- valign="top"
|- valign="top"
|width="700pt"|[[In the beginning Growing a cone|For tutorial on uniform growth non-uniform polariser click here]]<br><br>
|width="700pt"|[[In the beginning Growing a cone|For tutorial on uniform growth non-uniform polariser click here]]<br><br>
In the presence of polariser, ''GFtbox'' growth will be anisotropic, in other words growth in the plane of the canvas can be different parallel and perpendicular to the axis of the polariser: ''Kapar'' and ''Kaper'' (''A'' side) and ''Kbpar'' and ''Kbper'' (''B'' side).<br>
In the presence of polariser, ''GFtbox'' growth will be anisotropic, in other words growth in the plane of the canvas can be different parallel and perpendicular to the axis of the polariser: ''Kapar'' and ''Kaper'' (''A'' side) and ''Kbpar'' and ''Kbper'' (''B'' side).<br><br>
We now add polariser.  Start with example A - uniform growth - and add a radial polarising gradient.<br> The gradient defines local directions and local growth can be specifed either parallel to (''Kpar'') or perpendicular to (''Kper'') that direction.<br><br>
We now''' add polariser'''.  Start with example A - uniform growth - and add a radial polarising gradient.<br><br>Arrows show the direction of the gradient. They are turned on using the Panel:Plot option:Pol. grad. tick box. The gradient defines local directions and local growth can be specifed either parallel to (''Kpar'') or perpendicular to (''Kper'') that direction.<br><br>
Given a uniform pattern of specified growth parallel to the polariser and zero specified growth perpendicular to the polariser '''What will be the final shape?'''
Given a '''uniform pattern of specified growth parallel''' to the polariser and '''zero specified growth perpendicular''' to the polariser.<br><br> '''What will be the final shape?'''
|width="200pt"|<wikiflv width="300" height="300" logo="false"  loop="true" background="white">GPT_in_the_beginning_2_20110510-0003.flv|GPT_in_the_beginning_2_20110510-0003_First.png</wikiflv>
|width="200pt"|<wikiflv width="300" height="300" logo="false"  loop="true" background="white">GPT_in_the_beginning_2_20110510-0003.flv|GPT_in_the_beginning_2_20110510-0003_First.png</wikiflv>
|}
|}
='''2''' Doing it through the GUI and an interaction function=
='''2''' Modelling using a combination of GUI and interaction function=
Interaction functions - programmatic modelling
Interaction functions - programmatic modelling. <br><br>
 
='''3''' Running models without the GUI=
Having developed the concepts underpinning a pattern of growth in an interaction function it is often desirable to explore a range of model parameters. Given that each run of the model can take between 5 minutes and hour it is appropriate to run the models in parallel on a computing cluster.  (Each node of the cluster to be used by ''GFtbox'' needs to be licensed to run Matlab - however for the purpose of running on a cluster without the GUI we are exploring the possibility of making ''GFtbox'' compatible with [http://www.gnu.org/software/octave/ Octave].)<br><br>

Revision as of 07:38, 28 May 2011

GFtbox Details

Three ways to use GFtbox

There are three ways to use the GFtbox.

  1. Doing everything from the Graphical User Interface (GUI). This is the best way to start. See (1,2) below.
  2. Do only some things from the GUI. This is the best way to develop ideas. Use the GUI to generate the mesh (canvas) and create growth factors (morphogens - in other words declare the variables) but capturing your ideas on how the regulatory processes work in, what we call, the interaction function. See (3) below.
  3. Without the GUI. For example, run many examples (instances) of a pre-existing project on a cluster. This is the best way to explore the parameter space of a model for comparison with biological observations. We have used this way extensively but the code is not yet ready for general use.

1 Modelling using the Graphical User Interface

Isotropic growth

A

For tutorial on uniform growth click here.

Consider a disc shaped canvas (tissue) in which the specified growth is uniform, isotropic and on both sides.

Into what shape will the disc grow?

This model is as simple as it gets. Notice that, during growth, the mesh is automatically subdivided. Notice also that the final surface is not quite flat. This is because, to allow it to deform in 3D, it is not flat initially. There are options to initialise a flat mesh and others to force it to remain flat - see options on the GUI (hover over controls to get prompts).

In the absence of a polariser (there is no polariser in this example) growth will be isotropic, in other words growth in the plane of the canvas will be the average of what is specified for Kapar and Kaper (A side) and Kbpar and Kbper (B side).

<wikiflv width="300" height="300" logo="false" loop="true" background="white">GPT_tut_uniform_20110527-0003.flv|GPT_tut_uniform_20110527-0003_Last.png</wikiflv>

B

For tutorial on non-uniform growth click here

Consider a disc shaped canvas (tissue) in which the non-uniform specified growth increases in proportion to the distance from the centre.

Into what shape will the disc grow?

Already we are into the realms of modelling biological systems. Compare this result with the discussion of Lily petals and Gaussian curvature (Lianga and Mahadevana,Sharon, Marder and Swinney,Nath, Crawford, Carpenter and Coen ).
<wikiflv width="300" height="300" logo="false" loop="true" background="white">GPT_tut_uniform_20110527-0006.flv|GPT_tut_uniform_20110527-0006_First.png</wikiflv>

Note: this model should have many more finite elements

Adding polariser

C

For tutorial on uniform growth non-uniform polariser click here

In the presence of polariser, GFtbox growth will be anisotropic, in other words growth in the plane of the canvas can be different parallel and perpendicular to the axis of the polariser: Kapar and Kaper (A side) and Kbpar and Kbper (B side).

We now add polariser. Start with example A - uniform growth - and add a radial polarising gradient.

Arrows show the direction of the gradient. They are turned on using the Panel:Plot option:Pol. grad. tick box. The gradient defines local directions and local growth can be specifed either parallel to (Kpar) or perpendicular to (Kper) that direction.

Given a uniform pattern of specified growth parallel to the polariser and zero specified growth perpendicular to the polariser.

What will be the final shape?

<wikiflv width="300" height="300" logo="false" loop="true" background="white">GPT_in_the_beginning_2_20110510-0003.flv|GPT_in_the_beginning_2_20110510-0003_First.png</wikiflv>

2 Modelling using a combination of GUI and interaction function

Interaction functions - programmatic modelling.

3 Running models without the GUI

Having developed the concepts underpinning a pattern of growth in an interaction function it is often desirable to explore a range of model parameters. Given that each run of the model can take between 5 minutes and hour it is appropriate to run the models in parallel on a computing cluster. (Each node of the cluster to be used by GFtbox needs to be licensed to run Matlab - however for the purpose of running on a cluster without the GUI we are exploring the possibility of making GFtbox compatible with Octave.)