> ## 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.

# Golf: Swing

> The golf swing requires precise coordination & timing between the upper and lower body to generate powerful and accurate swings.

## Dimensions

Required Inputs for processing:

* **handedness:** the handedness of the athlete \['left', 'right']

## Variables

Output variables from hitting analysis.

### Events

Identify specific time points during the swing.

| Event                       | Data Type | Description                                                                                                                          | Column Name |
| --------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| Top Backswing               | Int       | Highest position during the backswing.                                                                                               | \`\`        |
| Max X Factor                | Int       | Maximum rotational (twist) difference between hips and shoulders.                                                                    | \`\`        |
| Peak Wrist Angular Velocity | Int       | Maximum angular velocity of the wrists rotating about the body.                                                                      | \`\`        |
| X Factor Zero Crossing      | Int       | The instant hips and shoulders have no rotational difference after max X Factor. When shoulders are stacked directly on top of hips. | \`\`        |
| Ball Contact                | Int       | The instant the club strikes the ball, estimated as the frame when the wrists are closest to the pelvis.                             | \`\`        |
| Follow Through              | Int       | The end of the swing, determined by the max hip shoulder separation after ball contact.                                              | \`\`        |

### Discrete Metrics

| Metric               | Units     | Description                                                                                                                                                                   | Column Name |
| -------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| Kinematic Sequence   | N/A       | Order (timing) of peak segment angular velocities \['pelvis-trunk', 'trunk-pelvis']. Correct order is 'pelvis-trunk'.                                                         | \`\`        |
| Sway                 | bool      | Whether the golfer exhibits a sway fault, indicated by shifting the pelvis laterally (side-side displacement) more than 15 cm (\~6 in) in the 2 s leading up to ball contact. | \`\`        |
| Max Stretch          | degrees   | Returns the maximum amount of hip shoulder separation (aka X Factor)                                                                                                          | \`\`        |
| Peak Pelvis Velocity | degrees/s | Max angular velocity of the pelvis about the twist axis (like a tornado) during the swing.                                                                                    | \`\`        |
| Peak Trunk Velocity  | degrees/s | Max angular velocity of the trunk about the twist axis (like a tornado) during the swing.                                                                                     | \`\`        |
| Hip Angle            | degrees   | Pelvis segment (defined by the hip joint centers) rotation angle about the twist axis relative to the first frame.                                                            | \`\`        |
| Shoulder Angle       | degrees   | Trunk segment (defined by the shoulder joint centers) rotation angle about the twist axis relative to the first frame.                                                        | \`\`        |

## Notes

* Kinematic data typically captured at 240Hz for Golf Swing