analyse_joint_power_file: Analyse joint power

In Kneerav/biomechanics: Biomechanics Data Analysis

Analyse joint power

Description

This function computes joint power using inverse dynamics and joint velocities from OpenSim. This function has the option to sum components for a given joint and limb (e.g., hip, knee) will create a new column for each joint (e.g., hip_r, hip_l).. By default, this summing excludes any columns that contain the word "beta" (i.e., from the couple patellofemoral joint).

Usage

analyse_joint_power_file(
  inverse_dynamics_file = "inverse_dynamics.sto",
  joint_vel_file = "Model_scaled_Kinematics_u.sto",
  file_out = "joint_power.sto",
  in_degrees = TRUE,
  sum_joints = c("hip", "arm"),
  sum_suffix = c("_l", "_r"),
  write_file = TRUE,
  return_object = FALSE
)

Arguments

inverse_dynamics_file	A string specifying the file path for the inverse dynamics data (e.g., "inverse_dynamics.sto").
joint_vel_file	A string specifying the file path for the joint velocities (e.g., "Model_scaled_Kinematics_u.sto").
file_out	A string specifying the output file path for the joint power results (e.g., "joint_power.sto").
in_degrees	A logical indicating whether the input joint velocities are in degrees (default is TRUE). If TRUE, velocities are converted to radians.
sum_joints	A character vector of joints to sum (e.g., c("hip", "arm")). Default is c("hip", "arm").
sum_suffix	A character vector of suffixes for left and right sides (e.g., c("_l", "_r")). Default is c("_l", "_r").
write_file	A logical indicating whether to write the results to a file (default is TRUE).
return_object	A logical indicating whether to return the resulting data frame (default is FALSE).

Value

If return_object = TRUE, returns a data frame with the computed joint power. If write_file = TRUE, writes the data to a file.

Kneerav/biomechanics documentation built on July 16, 2025, 4:51 p.m.