AAMToolbox template: Difference between revisions

From BanghamLab
Jump to navigation Jump to search
No edit summary
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Tutorials on the Shape modelling toolbox#1|Back to Tutorial pages]]<br><br>
[[Tutorials on the Shape modelling toolbox#1|Back to Tutorial pages]]<br>
 
 
 
=Template Editor=
=Template Editor=
==From the AAMToolbox control panel==
==1) Start a new project from the AAMToolbox control panel==
{| border="1" cellpadding="5" cellspacing="5"
[[AAMToolbox new project|Tutorial on starting a new project]]<br>
|- valign="top"
Notice that one of the images copied into the project has been co-opted as an icon representing the project. <br>
|width="300px"|The ''AAMToolbox'' user interface. Click on the New Project. <br>
[[File:AAMToolbox_GUI2.png|500px|The AAMToolbox control panel after adding the image files]]<br>
[[File:AAMToolbox_Template_Editor.jpg|300px|GFtbox interface]]
Once the template has been added, a second icon will be automatically created that represents the template itself.
This will lead you through three steps<br>
==2) Select an image on which to base the template==
#Select the directory in which to create the project
{| border="0" cellpadding="5" cellspacing="5"
#Name the project: the prefix PRJ_ will be added automatically
|- valign="top"  
#Select the type of project, in this case a 2D shape model
|width="300px"| Select the '''Template Editor from the AAMToolbox control panel'''. Then, from the Template Editor menu select''' New Template'''. This will open the directory of Cropped images and allow you to select one on which to base the template. [[File:AAMToolbox_Selecting_Template_Image.png|400px|Point model template builder interface]]
<br>
<small>Idea: From the Templates menu, Templates (and associated images) can be copied from other, existing, projects. ''</small>
Next copy the images to be analysed into the directory 'Cropped'.  
|width="300px"|[[File:AAMToolbox_new_template.png|300px|Point model template builder interface]]<br>
''Template Editor'' button circled in red. <br>
The''' new template''' will be based on this image.
|width="500px"|[[File:New_AAMToolbox_Project.png|500px|GFtbox interface]]<br.
[[File:Project Folders AAMToolbox.png|300px|GFtbox interface]]
|}
|}
==Template Editor control panel==
==3) Create a new Template using the Template Editor==
{| border="1" cellpadding="5" cellspacing="5"
{| border="0" cellpadding="5" cellspacing="5"
|- valign="top"
|- valign="top"  
|width="300px"|<small>Idea: Special shapes can be imported as ''OBJ'' files. ''</small>
|width="300px"|
|width="500px"|[[File:Template2.jpg|500px|Point model template builder interface]]
#Add points, '''select 'Add Point'''' and click on a feature that can be recognised in every image. For example, the junction between face and neck, or face and ear lobe, the ends.
#Having added the points, define those that you are most reliable as 'primary'. They will turn green. The remaining points are called secondary points and should be spread evenly between primary points.
#Secondary points can be''' spread evenly''' along a cubic spline that joints the primary landmarks by selecting 'Smooth Landmarks'.
#Lines joining points can aid understanding, but they do not contribute to the final shape model. <br>
When the template is correct 'Quit (and Save)' using the button, bottom right.<br>
|width="300px"|[[File:Template2.jpg|300px|Point model template builder interface]]<br>
#The''' point model is a set of points''' (red and green dots) that are used to build the shape model
#These are subdivided into primary (red) and secondary (green) landmarks
#Edges (red lines) are added to make the point model more understandable to humans
|}
|}
==4) Choose a template using the AAMToolbox control panel==
'''Having created a template it should be selected''' using the AAMToolbox main interface, 'Choose Template'. <br>
[[File:Choose_Template_AAMToolbox.png|500px|The AAMToolbox control panel after adding the image files]]<br>
Once the template has been added, a second icon will be automatically created that represents the template itself. Here it is the red smiling face.<BR>
Notice:
#The name of the current working project, top left
#The template name together with the number of points
#The current set of points (that will be selected automatically)
#The current list of images (that will be selected automatically)
#Most importantly, these details are summarised in the Listbox. Each model that is created will be associated with an entry in this listbox.
#The next step is to move the point model into position over each of the images using the '''Point Model Editor'''.

Latest revision as of 17:00, 5 February 2012

Back to Tutorial pages

Template Editor

1) Start a new project from the AAMToolbox control panel

Tutorial on starting a new project
Notice that one of the images copied into the project has been co-opted as an icon representing the project.
The AAMToolbox control panel after adding the image files
Once the template has been added, a second icon will be automatically created that represents the template itself.

2) Select an image on which to base the template

Select the Template Editor from the AAMToolbox control panel. Then, from the Template Editor menu select New Template. This will open the directory of Cropped images and allow you to select one on which to base the template. Point model template builder interface

Idea: From the Templates menu, Templates (and associated images) can be copied from other, existing, projects.

Point model template builder interface

The new template will be based on this image.

3) Create a new Template using the Template Editor

  1. Add points, select 'Add Point' and click on a feature that can be recognised in every image. For example, the junction between face and neck, or face and ear lobe, the ends.
  2. Having added the points, define those that you are most reliable as 'primary'. They will turn green. The remaining points are called secondary points and should be spread evenly between primary points.
  3. Secondary points can be spread evenly along a cubic spline that joints the primary landmarks by selecting 'Smooth Landmarks'.
  4. Lines joining points can aid understanding, but they do not contribute to the final shape model.

When the template is correct 'Quit (and Save)' using the button, bottom right.

Point model template builder interface
  1. The point model is a set of points (red and green dots) that are used to build the shape model
  2. These are subdivided into primary (red) and secondary (green) landmarks
  3. Edges (red lines) are added to make the point model more understandable to humans

4) Choose a template using the AAMToolbox control panel

Having created a template it should be selected using the AAMToolbox main interface, 'Choose Template'.
The AAMToolbox control panel after adding the image files
Once the template has been added, a second icon will be automatically created that represents the template itself. Here it is the red smiling face.
Notice:

  1. The name of the current working project, top left
  2. The template name together with the number of points
  3. The current set of points (that will be selected automatically)
  4. The current list of images (that will be selected automatically)
  5. Most importantly, these details are summarised in the Listbox. Each model that is created will be associated with an entry in this listbox.
  6. The next step is to move the point model into position over each of the images using the Point Model Editor.