Rotate and center a tunnel based on landmarksSource:
rotate_tunnel(); rotate and center tunnel data based on
landmarks (specific subjects in the data).
The input viewr object; a tibble or data.frame with attribute
"viewr"that has been passed through
gather_tunnel_data()(or is structured as though it has been passed through those functions).
Subject name of the first landmark
Subject name of the second landmark
Additional arguments passed to/from other pathviewr functions
A viewr object (tibble or data.frame with attribute
pathviewr_steps that includes
"viewr") in which data have
been rotated according to the positions of the landmarks in the data.
The center point of the tunnel is estimated as the point between the
two landmarks. It is therefore recommended that
landmark_two be objects that are placed on opposite ends of the
tunnel (e.g. in an avian flight tunnel, these landmarks may be perches that
are placed at the extreme ends). The angle between landmark_one,
tunnel_center_point, and arbitrary point along the length axis
(tunnel_center_point - 1 on length) is estimated. That angle is then used
to rotate the data, again only in the length and width dimensions. Height
is standardized by average landmark height; values greater than 0 are above
the landmarks and values less than 0 are below the landmark level.
position_length values of landmark_one MUST be less than
position_length values of landmark_two; otherwise,
the rotation will apply to a mirror-image of the tunnel
Other data cleaning functions: