A *.tps file containing two- or
three-dimensional landmark data
specID
a character specifying whether to extract
the specimen ID names from the ID or IMAGE lines (default
is "None").
Value
Function returns a (p x k x n) array, where p is the number
of landmark points, k is the number of landmark dimensions
(2 or 3), and n is the number of specimens. The third
dimension of this array contains names for each specimen,
which are obtained from the image names in the *.tps file.
Details
This function reads a *.tps file containing two- or
three-dimensional landmark coordinates. Tps files are text
files in one of the standard formats for geometric
morphometrics (see Rohlf 2010). Two-dimensional landmarks
coordinates are designated by the identifier "LM=", while
three-dimensional data are designated by "LM3=". Landmark
coordinates are multiplied by their scale factor if this is
provided for all specimens. If one or more specimens are
missing the scale factor, landmarks are treated in their
original units.
The user may specify whether specimen names are to be
extracted from the 'ID=' field or 'IMAGE=' field and
included in the resulting 3D array. e.g., for 'ID=' use
(file, specID = "ID") and for 'IMAGE=' use (file, specID =
"imageID"). The default is specID="None".
NOTE: At present, all other information that can be
contained in tps files (curves, comments, variables, radii,
etc.) is ignored.
References
Rohlf, F. J. 2010. tpsRelw: Relative warps analysis.
Version 1.49. Department of Ecology and Evolution, State
University of New York at Stony Brook, Stony Brook, NY.