Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.uplift.ai/llms.txt

Use this file to discover all available pages before exploring further.

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