editTemplate: Edit 3D template

In geomorphR/geomorph: Geometric Morphometric Analyses of 2D and 3D Landmark Data

Edit 3D template

Description

An interactive function to remove landmarks from a 3D template file.

Usage

editTemplate(template, fixed, n)

Arguments

template	Matrix of template 3D coordinates
fixed	Number of "fixed" landmark points (non surface sliding points)
n	Number of points to be removed

Details

The function edits a 'template.txt' file made by buildtemplate, which must be in the current working directory, and which is overwritten. Use read.table("template.txt", header = T) to read in the template first.

Selection

Choosing which landmarks will be deleted involves landmark selection using a mouse in the rgl plot window. With a standard 3-button (PC) buildtemplate uses:

1. the RIGHT mouse button (primary) to choose points to be deleted,

2. the LEFT mouse button (secondary) is used to rotate mesh,

3. the mouse SCROLLER (third/middle) is used to zoom in and out.

NOTE: Digitizing functions on MACINTOSH computers using a standard 3-button mice works as specified. Macs using platform specific single button mice, XQuartz must be configured: go to Preferences > Input > tick "Emulate three button mouse":

1. press button to rotate 3D mesh,

2. press button while pressing COMMAND key to select points to be deleted,

3. press button while pressing OPTION key to adjust mesh perspective.

4. the mouse SCROLLER or trackpad two finger scroll is used to zoom in an out.

Value

Function returns a matrix containing the x,y,z coordinates of the new template landmarks. Function also writes to the working directory 'template.txt' containing the x,y,z coordinates of the updated template

Author(s)

Erik Otarola-Castillo & Emma Sherratt

See Also

rgl-package (used in 3D plotting)

geomorphR/geomorph documentation built on April 23, 2024, 11:05 p.m.