animalplot3d: Make a 3D rotated plot of animal orientation based on roll,...

In animalTrack: Animal track reconstruction for high frequency 2-dimensional (2D) or 3-dimensional (3D) movement data.

Description

3D rendering of animal attitude using the "rgl" package.

Usage

animalplot3d(roll, pitch, yaw, angle = "degree", add = FALSE, ...)

Arguments

roll	Roll angle of the animal
pitch	Pitch angle of the animal
yaw	Yaw angle of the animal
angle	Unit of angular measure for input. Default is "degree", but the function will accept "radian". All three input angles must be either "degree" or "radian".
add	Indicates if the plot will be added to an existing rgl plot.
...	Additional items to be passed on to the rgl plotting function.

Details

This plotting function uses rgl plotting functions to produce a new 3D plot, or to add to an existing 3D plot. Plotting parameters will be passed on the the plot3d() function for customization. The stationary "body frame" which uses the "North-East-Down" (NED) frame of reference is plotted using the color red. Each of the three axes is plotted with small spheres on the end. The X-axis points posterior to anterior (i.e. direction the animal is facing) and faces north when not rotated. The Y-axis is oriented to the east of the X-axis (points left to right). The Z-axis is the dorso-ventral axis and points downward when not rotated (toward the center of the Earth). The rotated axes are also plotted in blue. The X-axis is given a large sphere so that it is easy to represent the direction that the animal is facing.

Value

An object with two rotated matrices

rotmat	3x3 rotation matrix
hrotmat	homogenous rotation matrix

Author(s)

Ed Farrell <[e-mail]>

See Also

plot3d

Examples

## Animal with a roll angle of 30 degrees, and a pitch angle of 10 degrees
roll <- 30
pitch <- 10
yaw <- 0

animalplot3d(roll,pitch,yaw,angle = "degree")

## Make the plot a bit larger
par3d(windowRect = c(50,50,700,700)) 

## Add another animal orientation with the same roll and pitch, but a 40 degree yaw.
animalplot3d(roll,pitch,40,angle = "degree", add=TRUE)

animalTrack documentation built on May 2, 2019, 5:07 a.m.