Metadata
- Specific information about the recorded session. Columns may include:
athlete_name- as entered during captureathleteid- automatically generated id for the athletesessionid- automatically generated id for the sessionorgid- automatically generated id for the organizationcapture_time- timestamp of session capture in Unix Epochfps- frames per secondactivity- 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_extension | head_extension_velocity |
| head_lateral_flexion_clockwise | head_lateral_flexion_clockwise_velocity |
| head_twist_clockwise | head_twist_clockwise_velocity |
| right_shoulder_flexion | right_shoulder_flexion_velocity |
| right_shoulder_adduction | right_shoulder_adduction_velocity |
| right_shoulder_external_rotation | right_shoulder_external_rotation_velocity |
| right_shoulder_horizontal_adduction | |
| left_shoulder_flexion | left_shoulder_flexion_velocity |
| left_shoulder_adduction | left_shoulder_adduction_velocity |
| left_shoulder_external_rotation | left_shoulder_external_rotation_velocity |
| left_shoulder_horizontal_adduction | |
| right_elbow_flexion | right_elbow_flexion_velocity |
| left_elbow_flexion | left_elbow_flexion_velocity |
| right_hip_flexion_with_respect_to_trunk | right_hip_flexion_velocity_with_respect_to_trunk |
| right_hip_adduction_with_respect_to_trunk | right_hip_adduction_velocity_with_respect_to_trunk |
| left_hip_flexion_with_respect_to_trunk | left_hip_flexion_velocity_with_respect_to_trunk |
| left_hip_adduction_with_respect_to_trunk | left_hip_adduction_velocity_with_respect_to_trunk |
| right_knee_extension | right_knee_extension_velocity |
| left_knee_extension | left_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_clockwise | trunk_twist_clockwise_velocity |
| trunk_lateral_flexion_right | |
| trunk_angle_global_sagittal | |
| trunk_angle_global_frontal | |
| trunk_angle_global_twist | |
| right_ankle_dorsiflexion | right_ankle_dorsiflexion_velocity |
| left_ankle_dorsiflexion | left_ankle_dorsiflexion_velocity |
| right_hip_internal_rotation_with_respect_to_trunk | right_hip_internal_rotation_velocity_with_respect_to_trunk |
| right_hip_adduction_with_respect_to_pelvis | right_hip_adduction_velocity_with_respect_to_pelvis |
| right_hip_internal_rotation_with_respect_to_pelvis | right_hip_internal_rotation_velocity_with_respect_to_pelvis |
| left_hip_internal_rotation_with_respect_to_trunk | left_hip_internal_rotation_velocity_with_respect_to_trunk |
| left_hip_adduction_with_respect_to_pelvis | left_hip_adduction_velocity_with_respect_to_pelvis |
| left_hip_internal_rotation_with_respect_to_pelvis | left_hip_internal_rotation_velocity_with_respect_to_pelvis |
| right_knee_varus | right_knee_varus_velocity |
| right_knee_internal_rotation | right_knee_internal_rotation_velocity |
| left_knee_varus | left_knee_varus_velocity |
| left_knee_internal_rotation | left_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.
| X | Y | Z |
|---|---|---|
| nose_3d_x | nose_3d_y | nose_3d_z |
| left_eye_3d_x | left_eye_3d_y | left_eye_3d_z |
| right_eye_3d_x | right_eye_3d_y | right_eye_3d_z |
| left_ear_3d_x | left_ear_3d_y | left_ear_3d_z |
| right_ear_3d_x | right_ear_3d_y | right_ear_3d_z |
| left_shoulder_jc_3d_x | left_shoulder_jc_3d_y | left_shoulder_jc_3d_z |
| right_shoulder_jc_3d_x | right_shoulder_jc_3d_y | right_shoulder_jc_3d_z |
| left_elbow_jc_3d_x | left_elbow_jc_3d_y | left_elbow_jc_3d_z |
| right_elbow_jc_3d_x | right_elbow_jc_3d_y | right_elbow_jc_3d_z |
| left_wrist_jc_3d_x | left_wrist_jc_3d_y | left_wrist_jc_3d_z |
| right_wrist_jc_3d_x | right_wrist_jc_3d_y | right_wrist_jc_3d_z |
| left_hip_jc_3d_x | left_hip_jc_3d_y | left_hip_jc_3d_z |
| right_hip_jc_3d_x | right_hip_jc_3d_y | right_hip_jc_3d_z |
| left_knee_jc_3d_x | left_knee_jc_3d_y | left_knee_jc_3d_z |
| right_knee_jc_3d_x | right_knee_jc_3d_y | right_knee_jc_3d_z |
| left_ankle_jc_3d_x | left_ankle_jc_3d_y | left_ankle_jc_3d_z |
| right_ankle_jc_3d_x | right_ankle_jc_3d_y | right_ankle_jc_3d_z |
| right_heel_3d_x | right_heel_3d_y | right_heel_3d_z |
| left_heel_3d_x | left_heel_3d_y | left_heel_3d_z |
| proximal_neck_3d_x | proximal_neck_3d_y | proximal_neck_3d_z |
| pelvis_3d_x | pelvis_3d_y | pelvis_3d_z |
| mid_head_3d_x | mid_head_3d_y | mid_head_3d_z |
| right_mid_toe_3d_x | right_mid_toe_3d_y | right_mid_toe_3d_z |
| left_mid_toe_3d_x | left_mid_toe_3d_y | left_mid_toe_3d_z |