Uplift includes generic outputs of joint angles, joint velocities, and 3D keypoints for all recorded movements. Movements without specific events and metrics (such as “other-other”) will include these outputs.

Metadata

  • Specific information about the recorded session. Columns may include:
    • athlete_name - as entered during capture
    • athleteid - automatically generated id for the athlete
    • sessionid - automatically generated id for the session
    • orgid - automatically generated id for the organization
    • capture_time - timestamp of session capture in Unix Epoch
    • fps - frames per second
    • activity - general activity being performed (baseball, jumping, gait, etc.)
    • movement - specific movement being performed (pitching, countermovement, running, etc.)
    • handedness - dominant hand of the athlete (as performed during the movement) [if applicable]
    • footedness - dominant foot of the athlete (as performed during the movement) [if applicable]
    • approved_by_biomech_qa - boolean variable indicating whether the session passed Uplift’s internal biomechanics quality assurance [0 = failed, 1 = passed]
    • time - row variable indicating the elapsed time in seconds since beginning of the capture [0, 0.01, 0.02, …]
    • frame - row variable indicating the frame number since beginning of the capture [0, 1, 2, …]

Generic Kinematics

  • Lists the joint angles (degrees) and velocities (degrees/second) for all joints included in the biomechanical model.
  • These columns are generally paired with the angle preceeding the velocity (i.e., ‘left_shoulder_flexion’, ‘left_shoulder_flexion_velocity’).
  • Available outputs may depend on keypoint model and biomechanical processing versions.
Joint Angle (deg)Joint Velocity (deg/s)
head_extensionhead_extension_velocity
head_lateral_flexion_clockwisehead_lateral_flexion_clockwise_velocity
head_twist_clockwisehead_twist_clockwise_velocity
right_shoulder_flexionright_shoulder_flexion_velocity
right_shoulder_adductionright_shoulder_adduction_velocity
right_shoulder_external_rotationright_shoulder_external_rotation_velocity
right_shoulder_horizontal_adduction
left_shoulder_flexionleft_shoulder_flexion_velocity
left_shoulder_adductionleft_shoulder_adduction_velocity
left_shoulder_external_rotationleft_shoulder_external_rotation_velocity
left_shoulder_horizontal_adduction
right_elbow_flexionright_elbow_flexion_velocity
left_elbow_flexionleft_elbow_flexion_velocity
right_hip_flexion_with_respect_to_trunkright_hip_flexion_velocity_with_respect_to_trunk
right_hip_adduction_with_respect_to_trunkright_hip_adduction_velocity_with_respect_to_trunk
left_hip_flexion_with_respect_to_trunkleft_hip_flexion_velocity_with_respect_to_trunk
left_hip_adduction_with_respect_to_trunkleft_hip_adduction_velocity_with_respect_to_trunk
right_knee_extensionright_knee_extension_velocity
left_knee_extensionleft_knee_extension_velocity
pelvis_rotational_velocity_with_respect_to_ground
trunk_rotational_velocity_with_respect_to_ground
right_arm_rotational_velocity_with_respect_to_ground
left_arm_rotational_velocity_with_respect_to_ground
trunk_twist_clockwisetrunk_twist_clockwise_velocity
trunk_lateral_flexion_right
trunk_angle_global_sagittal
trunk_angle_global_frontal
trunk_angle_global_twist
right_ankle_dorsiflexionright_ankle_dorsiflexion_velocity
left_ankle_dorsiflexionleft_ankle_dorsiflexion_velocity
right_hip_internal_rotation_with_respect_to_trunkright_hip_internal_rotation_velocity_with_respect_to_trunk
right_hip_adduction_with_respect_to_pelvisright_hip_adduction_velocity_with_respect_to_pelvis
right_hip_internal_rotation_with_respect_to_pelvisright_hip_internal_rotation_velocity_with_respect_to_pelvis
left_hip_internal_rotation_with_respect_to_trunkleft_hip_internal_rotation_velocity_with_respect_to_trunk
left_hip_adduction_with_respect_to_pelvisleft_hip_adduction_velocity_with_respect_to_pelvis
left_hip_internal_rotation_with_respect_to_pelvisleft_hip_internal_rotation_velocity_with_respect_to_pelvis
right_knee_varusright_knee_varus_velocity
right_knee_internal_rotationright_knee_internal_rotation_velocity
left_knee_varusleft_knee_varus_velocity
left_knee_internal_rotationleft_knee_internal_rotation_velocity

Generic Keypoints

  • Lists the X/Y/Z keypoint positions (units: meters) in the global coordinate system.
  • Keypoint columns end in “_3d_x”, “_3d_y”, and “_3d_z”.
  • Number and location of keypoints may differ by keypoint model and biomechanical processing versions.
XYZ
nose_3d_xnose_3d_ynose_3d_z
left_eye_3d_xleft_eye_3d_yleft_eye_3d_z
right_eye_3d_xright_eye_3d_yright_eye_3d_z
left_ear_3d_xleft_ear_3d_yleft_ear_3d_z
right_ear_3d_xright_ear_3d_yright_ear_3d_z
left_shoulder_jc_3d_xleft_shoulder_jc_3d_yleft_shoulder_jc_3d_z
right_shoulder_jc_3d_xright_shoulder_jc_3d_yright_shoulder_jc_3d_z
left_elbow_jc_3d_xleft_elbow_jc_3d_yleft_elbow_jc_3d_z
right_elbow_jc_3d_xright_elbow_jc_3d_yright_elbow_jc_3d_z
left_wrist_jc_3d_xleft_wrist_jc_3d_yleft_wrist_jc_3d_z
right_wrist_jc_3d_xright_wrist_jc_3d_yright_wrist_jc_3d_z
left_hip_jc_3d_xleft_hip_jc_3d_yleft_hip_jc_3d_z
right_hip_jc_3d_xright_hip_jc_3d_yright_hip_jc_3d_z
left_knee_jc_3d_xleft_knee_jc_3d_yleft_knee_jc_3d_z
right_knee_jc_3d_xright_knee_jc_3d_yright_knee_jc_3d_z
left_ankle_jc_3d_xleft_ankle_jc_3d_yleft_ankle_jc_3d_z
right_ankle_jc_3d_xright_ankle_jc_3d_yright_ankle_jc_3d_z
right_heel_3d_xright_heel_3d_yright_heel_3d_z
left_heel_3d_xleft_heel_3d_yleft_heel_3d_z
proximal_neck_3d_xproximal_neck_3d_yproximal_neck_3d_z
pelvis_3d_xpelvis_3d_ypelvis_3d_z
mid_head_3d_xmid_head_3d_ymid_head_3d_z
right_mid_toe_3d_xright_mid_toe_3d_yright_mid_toe_3d_z
left_mid_toe_3d_xleft_mid_toe_3d_yleft_mid_toe_3d_z