store_data {AvInertia}R Documentation

Store data from the inertia calculations in long format

Description

Function to store moment of inertia tensor and center of gravity vector components in long format

Usage

store_data(dat_wingID_curr, dat_mass, mass_properties, name)

Arguments

dat_wingID_curr

Dataframe related to the current bird wing ID info that must include the following columns:

  • speciesSpecies ID code as a string

  • BirdIDBird ID code as a string

  • TestIDTest ID code as a string

  • frameIDVideo frame ID code as a string

dat_mass

Dataframe containing the new MOI and CG data to add to mass_properties as new rows. Must include:

  • IMoment of inertia tensor (kg-m^2)

  • CGCenter of gravity with three location components (m)

mass_properties

Dataframe containing any previously saved data. Must have the following columns: "species","BirdID","TestID","FrameID", "prop_type","component","value".

name

Name of the component for which the moment of inertia and center of gravity were computed.

Value

This function returns mass_properties as an updated dataframe with a new row corresponding to the dat_mass information

Examples

# refer to the vignette
library(AvInertia)

# load data
data(dat_id_curr, package = "AvInertia")
data(dat_bird_curr, package = "AvInertia")
data(dat_feat_curr, package = "AvInertia")
data(dat_bone_curr, package = "AvInertia")
data(dat_mat, package = "AvInertia")
data(clean_pts, package = "AvInertia")

# 1. Determine the center of gravity of the bird's torso (including the legs)
dat_torsotail_out = massprop_restbody(dat_id_curr, dat_bird_curr)
# 2. Calculate the inertia of the flight feathers about the tip of the calamus
feather_inertia <- compute_feat_inertia(dat_mat, dat_feat_curr, dat_bird_curr)
# 3. Determine the center of gravity of one of the bird's wings
dat_wing_out      = massprop_birdwing(dat_id_curr, dat_bird_curr,
dat_bone_curr, dat_feat_curr, dat_mat, clean_pts,
feather_inertia, plot_var = 0)
# Visualize the center of gravity of each wing component in the x and y axis
dat_wing_out      = massprop_birdwing(dat_id_curr, dat_bird_curr,
dat_bone_curr, dat_feat_curr, dat_mat, clean_pts,
feather_inertia, plot_var = "yx")
# or the y and z axis
dat_wing_out      = massprop_birdwing(dat_id_curr, dat_bird_curr,
dat_bone_curr, dat_feat_curr, dat_mat, clean_pts,
feather_inertia, plot_var = "yz")
# 4. Combine all data and obtain the center of gravity, moment of inertia
# and principal axes of the bird
curr_full_bird      = combine_inertialprop(dat_torsotail_out,dat_wing_out,
dat_wing_out, dat_id_curr, dat_bird_curr, symmetric=TRUE)


[Package AvInertia version 0.0.1 Index]