AAMToolbox template - Revision history

AndrewBangham at 17:00, 5 February 2012

2012-02-05T17:00:04Z

AndrewBangham at 16:58, 5 February 2012

2012-02-05T16:58:38Z

← Older revision		Revision as of 16:58, 5 February 2012
Line 18:		Line 18:
	\|- valign="top"		\|- valign="top"
	\|width="300px"\|		\|width="300px"\|
	#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.		#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.		#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'.		#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>		#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>		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>		\|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		#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		#These are subdivided into primary (red) and secondary (green) landmarks
	#Edges (red lines) are added to make the point model more understandable to humans		#Edges (red lines) are added to make the point model more understandable to humans
Line 30:		Line 30:

	==Choose a template using the AAMToolbox control panel==		==Choose a template using the AAMToolbox control panel==
	Having created a template it should be selected using the AAMToolbox main interface, 'Choose Template'. <br>		'''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>		[[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.		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'''.

AndrewBangham at 16:53, 5 February 2012

2012-02-05T16:53:52Z

← Older revision		Revision as of 16:53, 5 February 2012
Line 22:		Line 22:
	#Secondary points can be spread evenly along a cubic spline that joints the primary landmarks by selecting 'Smooth Landmarks'.		#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>		#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>		\|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		#The point model is a set of points (red and green dots) that are used to build the shape model
Line 27:		Line 28:
	#Edges (red lines) are added to make the point model more understandable to humans		#Edges (red lines) are added to make the point model more understandable to humans
	\|}		\|}

			==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.

AndrewBangham at 16:46, 5 February 2012

2012-02-05T16:46:02Z

← Older revision		Revision as of 16:46, 5 February 2012
Line 23:		Line 23:
	#Lines joining points can aid understanding, but they do not contribute to the final shape model. <br>		#Lines joining points can aid understanding, but they do not contribute to the final shape model. <br>
	\|width="300px"\|[[File:Template2.jpg\|300px\|Point model template builder interface]]<br>		\|width="300px"\|[[File:Template2.jpg\|300px\|Point model template builder interface]]<br>
	#The point model ~~which~~ is a set of points (red and green dots).		#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		#These are subdivided into primary (red) and secondary (green) landmarks
	#Edges (red lines) are added to make the point model more understandable to humans		#Edges (red lines) are added to make the point model more understandable to humans
	\|}		\|}

AndrewBangham at 16:45, 5 February 2012

2012-02-05T16:45:14Z

← Older revision		Revision as of 16:45, 5 February 2012
Line 6:		Line 6:
	[[File:AAMToolbox_GUI2.png\|500px\|The AAMToolbox control panel after adding the image files]]<br>		[[File:AAMToolbox_GUI2.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.		Once the template has been added, a second icon will be automatically created that represents the template itself.
	==~~Create a new Template using~~ the ~~Template Editor~~==		==Select an image on which to base the template==
	{\| border="1" cellpadding="5" cellspacing="5"		{\| border="0" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
	\|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]]		\|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]]
Line 14:		Line 14:
	The''' new template''' will be based on this image.		The''' new template''' will be based on this image.
	\|}		\|}
	Template2.jpg		==Create a new Template using the Template Editor==
			{\| border="0" cellpadding="5" cellspacing="5"
			\|- valign="top"
			\|width="300px"\|
			#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>
			\|width="300px"\|[[File:Template2.jpg\|300px\|Point model template builder interface]]<br>
			#The point model which is a set of points (red and green dots).
			#These are subdivided into primary (red) and secondary (green) landmarks
			#Edges (red lines) are added to make the point model more understandable to humans
			\|}

AndrewBangham at 12:58, 5 February 2012

2012-02-05T12:58:32Z

← Older revision		Revision as of 12:58, 5 February 2012
Line 10:		Line 10:
	\|- valign="top"		\|- valign="top"
	\|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]]		\|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]]
	<small>Idea: ~~Special shapes~~ can be ~~imported as ''OBJ'' files~~. ''</small>		<small>Idea: From the Templates menu, Templates (and associated images) can be copied from other, existing, projects. ''</small>
	\|width="300px"\|[[File:AAMToolbox_new_template.png\|300px\|Point model template builder interface]]		\|width="300px"\|[[File:AAMToolbox_new_template.png\|300px\|Point model template builder interface]]<br>
			The''' new template''' will be based on this image.
	\|}		\|}
	Template2.jpg		Template2.jpg

AndrewBangham at 12:56, 5 February 2012

2012-02-05T12:56:37Z

← Older revision		Revision as of 12:56, 5 February 2012
Line 3:		Line 3:
	==Start a new project from the AAMToolbox control panel==		==Start a new project from the AAMToolbox control panel==
	[[AAMToolbox new project\|Tutorial on starting a new project]]<br>		[[AAMToolbox new project\|Tutorial on starting a new project]]<br>
	Notice that one of the images has been co-opted as an icon representing the project. <br>		Notice that one of the images copied into the project has been co-opted as an icon representing the project. <br>
	[[File:AAMToolbox_GUI2.png\|500px\|The AAMToolbox control panel after adding the image files]<br>		[[File:AAMToolbox_GUI2.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.		Once the template has been added, a second icon will be automatically created that represents the template itself.
	==Create a new Template using the Template Editor==		==Create a new Template using the Template Editor==
	{\| border="1" cellpadding="5" cellspacing="5"		{\| border="1" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
	\|width="300px"\|<small>Idea: Special shapes can be imported as ''OBJ'' files. ''</small>		\|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]]
	\|width="~~500px~~"\|[[File:~~Template2~~.~~jpg~~\|~~500px~~\|Point model template builder interface]]		<small>Idea: Special shapes can be imported as ''OBJ'' files. ''</small>
			\|width="300px"\|[[File:AAMToolbox_new_template.png\|300px\|Point model template builder interface]]
	\|}		\|}
			Template2.jpg

AndrewBangham at 12:33, 5 February 2012

2012-02-05T12:33:38Z

← Older revision		Revision as of 12:33, 5 February 2012
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==		==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 has been co-opted as an icon representing the project. <br>
	~~\|width="300px"\|The ''AAMToolbox'' user interface. Click on the<br> '''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>		==Create a new Template using the Template Editor==
	~~#Select the directory in which to create the project~~
	~~#Name the project: the prefix PRJ_ will be added automatically~~
	~~#Select the type~~ of ~~project, in this case a 2D shape model~~
	~~<br>~~
	~~Next '''copy~~ the images ~~to be analysed into~~ the ~~directory 'Cropped''''.~~
	~~''Template Editor'' button circled in red~~. <br>
	~~\|width="500px"\|~~[[File:~~New_AAMToolbox_Project~~.png\|500px\|~~GFtbox interface]]<br>~~
	~~[[File:Project Folders~~ AAMToolbox~~.png\|300px\|GFtbox interface]~~]<br>
	~~The subdirectories in~~ a ~~project are~~ created ~~automatically. Whilst the original images should be stored in the 'Original' subdirectory, images~~ that ~~have been cropped to the same size ready for shape analysis are stored in~~ the ~~directory called 'Cropped'~~.
	\|}
	==Template Editor ~~control panel~~==
	{\| border="1" cellpadding="5" cellspacing="5"		{\| border="1" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"

AndrewBangham at 12:07, 5 February 2012

2012-02-05T12:07:44Z

← Older revision		Revision as of 12:07, 5 February 2012
Line 7:		Line 7:
	{\| border="1" cellpadding="5" cellspacing="5"		{\| border="1" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
	\|width="300px"\|The ''AAMToolbox'' user interface. Click on the '''New Project'''. <br>		\|width="300px"\|The ''AAMToolbox'' user interface. Click on the<br> '''New Project'''. <br>
	[[File:AAMToolbox_Template_Editor.jpg\|300px\|GFtbox interface]]		[[File:AAMToolbox_Template_Editor.jpg\|300px\|GFtbox interface]]
	This will lead you through three steps<br>		This will lead you through three steps<br>
Line 14:		Line 14:
	#Select the type of project, in this case a 2D shape model		#Select the type of project, in this case a 2D shape model
	<br>		<br>
	Next copy the images to be analysed into the directory 'Cropped'.		Next '''copy the images to be analysed into the directory 'Cropped''''.
	''Template Editor'' button circled in red. <br>		''Template Editor'' button circled in red. <br>
	\|width="500px"\|[[File:New_AAMToolbox_Project.png\|500px\|GFtbox interface]]<br>		\|width="500px"\|[[File:New_AAMToolbox_Project.png\|500px\|GFtbox interface]]<br>

AndrewBangham at 12:07, 5 February 2012

2012-02-05T12:07:10Z

← Older revision		Revision as of 12:07, 5 February 2012
Line 7:		Line 7:
	{\| border="1" cellpadding="5" cellspacing="5"		{\| border="1" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
	\|width="300px"\|The ''AAMToolbox'' user interface. Click on the New Project. <br>		\|width="300px"\|The ''AAMToolbox'' user interface. Click on the '''New Project'''. <br>
	[[File:AAMToolbox_Template_Editor.jpg\|300px\|GFtbox interface]]		[[File:AAMToolbox_Template_Editor.jpg\|300px\|GFtbox interface]]
	This will lead you through three steps<br>		This will lead you through three steps<br>

← Older revision		Revision as of 17:00, 5 February 2012
Line 1:		Line 1:
	[[Tutorials on the Shape modelling toolbox#1\|Back to Tutorial pages]]<br>		[[Tutorials on the Shape modelling toolbox#1\|Back to Tutorial pages]]<br>
	=Template Editor=		=Template Editor=
	==Start a new project from the AAMToolbox control panel==		==1) Start a new project from the AAMToolbox control panel==
	[[AAMToolbox new project\|Tutorial on starting a new project]]<br>		[[AAMToolbox new project\|Tutorial on starting a new project]]<br>
	Notice that one of the images copied into the project has been co-opted as an icon representing the project. <br>		Notice that one of the images copied into the project has been co-opted as an icon representing the project. <br>
	[[File:AAMToolbox_GUI2.png\|500px\|The AAMToolbox control panel after adding the image files]]<br>		[[File:AAMToolbox_GUI2.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.		Once the template has been added, a second icon will be automatically created that represents the template itself.
	==Select an image on which to base the template==		==2) Select an image on which to base the template==
	{\| border="0" cellpadding="5" cellspacing="5"		{\| border="0" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
Line 14:		Line 14:
	The''' new template''' will be based on this image.		The''' new template''' will be based on this image.
	\|}		\|}
	==Create a new Template using the Template Editor==		==3) Create a new Template using the Template Editor==
	{\| border="0" cellpadding="5" cellspacing="5"		{\| border="0" cellpadding="5" cellspacing="5"
	\|- valign="top"		\|- valign="top"
Line 29:		Line 29:
	\|}		\|}

	==Choose a template using the AAMToolbox control panel==		==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>		'''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>		[[File:Choose_Template_AAMToolbox.png\|500px\|The AAMToolbox control panel after adding the image files]]<br>