Chapter 3 Templates

3.1 Change Default Template

The template used for new templates will be your default template, which starts as the 189-point FRL-face template, but you can change this in the Preferences (,). You can see your current template under Current Templates in the Templates menu.

Current template and other options.

Figure 3.1: Current template and other options.

One unusual template is for hands. You fit the hand template by clicking in the base of the second digit, the tip of the third digit, and the base of the fourth digit. You can use this to calculate 2D4D for scanned hand images. I’m not sure this line of research means much, but this is a tool that can do it if you must.

Hand Template. Don't measure hands like this; use a flatbed scanner. Or just don't do 2D4D research.

Figure 3.2: Hand Template. Don’t measure hands like this; use a flatbed scanner. Or just don’t do 2D4D research.

3.2 Delneation

3.2.1 Close Mouth

In the FRL-Face template, the bottom of the top lip is a red line, while the to of the bottom lip is a blue line (think “blue” = “depressed”). If the face has lips together, you can just delineate the bottom blue line and choose Close Mouth (C) to move the red line exactly underneath.

The red line is the bottom of the top lip.

Figure 3.3: The red line is the bottom of the top lip.

3.3 Batch Template Functions

There are several functions under the Template menu that you can apply to all selected templates.

3.3.1 Convert Templates

You can convert between a few types of templates, such as FRL-Face (the default 189-point front face template) and PL-Face (a 179-point template commonly used in Dave Perret’s Perception Lab). You can convert to the auto-delineation template (Face++) but not back yet (it’s much easier to remove points from a template than add them.

Tem conversion options

Figure 3.4: Tem conversion options

Conversions are usually approximate, as some points are just guessed based on the placement of other points (there is no machine vision going on here), so you should always look through your converted templates and fix any inaccuracies.

3.3.2 TPS Files

A TPS file is a way to represent shape data of several images in one file. These are used by geometric morphometric programs like facefuns. You can create a TPS file by selecting the templates you want to add (any non-template selected files will be ignored) and choosing Create TPS File from the Template Menu. This will save a .tps file in that folder that you can download.

3.3.3 Tem from Embedded

If a JPEG image is created in webmorph, the template is embedded in the image, so you can recover it even if you deleted the template file. This information, along with the image history, is stored in the EXIF, which can be removed.

All images say that “Tem Embed” is false in the image preview. This is a bug. Also, the built-in images don’t have embedded templates. I will fix this when I get time.

3.3.4 Modify Delineation

You can batch delete points from selected templates. This is useful if you want to keep only the points appropriate for a geometric morphometric analysis (facefuns also has a function to do this).

The lines usually get messed up when you delete points, so I just delete all the lines, which are seldom used for geometric morphometrics.

3.4 New Templates

You can register a template you uploaded from another version of WebMorph or Psychomorph, or a new one you created here. Registering a template allows you to use it to delineate new images and lets you set the point names and symmetry points.

3.4.1 From a Saved Template

  • Load the image with the template you want to register.
  • Select the three points you want to use for 3-point delineation by shift-clicking on them. This only works if you select exactly 3 points. I recommend always setting the first three points to the centre of the left eye, centre of the right eye, and centre of the bottom of the top lip to make fitting delineation easier.
  • Choose New/Edit Template from the Template menu
  • Make sure that “Register this as a new template” is checked, unless you are editing one of your previously saved templates. You can’t edit the public templates that you don’t own (e.g., FRL-face, FRL-body, Face++).
  • Give the template a useful name and notes. The 3 points for 3-point delineation will be automatically filled in from the points you selected. You can change or re-order them here.
Save a new template.

Figure 3.5: Save a new template.

3.4.2 From Scratch

If you want to make a template from scratch, start with an image that has no saved template. You can fit the current template, and then delete it by clicking A to select all points and delete. This is a buggy process right now, so it might take a few tries.

First, add new points using click. Use L to start drawing a new line; the cursor will change to a wand. Hover over points until they turn red (you need to move the cursor icon around a bit to find the right point) and click to add them to a line. Click ‘enter’ to end the line; it will turn from red to blue. Use L to delete a line by clicking on any point attached to the line.

Editng points and lines

Figure 3.6: Editng points and lines

Save your template and follow the instructions above for registering a new template.

3.4.3 Set Point Labels

After you save the template, choose “Set Point Labels” from the Template menu. Each point will be selected in turn (and an arrow will point at it). Type the name into the box at the top of the screen and press return.

Setting template point labels.

Figure 3.7: Setting template point labels.

3.4.4 Setting Symmetry Points

To set symmetry points for mirroring or symmetrising images, choose Set Symmetry Points from the Template menu. Look for the highlighted point and cmd-click on its corresponding point on the other side. You can move points out of the way to check if they are overlapping. If a point is on the midline, its corresponding point is itself. If you make a mistake, click cmd-Z to go back a point.

Setting symmetry points.

Figure 3.8: Setting symmetry points.