match.datasets: match.datasets

Description Usage Arguments Details Value Author(s) References Examples

View source: R/ShapeRotator.R

Description

Matches two arrays by their dimnames

Usage

1
match.datasets(data.1, data.2)

Arguments

data.1

an object of the class "array" that contains three-dimensional landmarks for structure #1 (e.g. skull)

data.2

an object of the class "array" that contains three-dimensional landmarks for structure #2 (e.g. mandible)

Details

Takes the two translated arrays and joined them by dimnames. Unmatched datasets (specimens missing in data.1 or data.2) are deleted.

Value

This function returns a list with the two translated arrays of dimensions (p, 3, n), in which dimnames associated with each specimen (n) are in the same order.

Author(s)

Marta Vidal-Garcia

References

M. Vidal-GarcĂ­a, L. Bandara and J.S. Keogh. 2018. ShapeRotator: An R tool for standardized rigid rotations of articulated three-dimensional structures with application for geometric morphometrics. Ecology and Evolution. DOI: 10.1002/ece3.4018

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# We need to match the dimnames of the translated datasets, but we have two
# extra specimens in data.1_t

length(dimnames(data.1_t)[[3]]) # n=12
length(dimnames(data.2_t)[[3]])  # n=10
matched <- match.datasets(data.1_t, data.2_t)

# When we matched the arrays, only matrices from specimens present in both
# datasets will be kept

length(dimnames(matched$matched1)[[3]]) # n=10

length(dimnames(matched$matched2)[[3]])  # n=10

ShapeRotator documentation built on July 1, 2020, 5:41 p.m.