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

# Basketball: Layup

> Biomechanical analysis of basketball layup movements, including events, phases, and discrete metrics.

## Overview

The layup is a close-range shot in which the player drives toward the basket and releases the ball off the backboard (or directly through the rim), typically with one hand, after one or more steps.
It is a fundamental finishing move and is performed from various angles (e.g., right-hand layup from the right side, left-hand from the left) and with different footwork (e.g., one-step, two-step, Euro step).
Key biomechanical elements include approach speed and angle, takeoff from one or both feet, body control and protection of the ball, release hand and timing relative to peak height or descent, and use of the backboard for angle and spin. Layups can be contested, so arm extension, body positioning, and release height are often analyzed for success and injury risk.

Biomechanical analysis of the layup can address approach and plant, takeoff and flight, release timing and hand placement, and landing.

## Dimensions

Required inputs for processing are not yet defined. When supported, typical dimensions may include:

* **handedness:** the handedness of the player \['left', 'right']
* **layup hand or side:** e.g., right-hand vs left-hand layup, if applicable

## Output Variables

### Events

| Metric | Data Type | Acronym | Description |
| ------ | --------- | ------- | ----------- |

### Phases and Stages

| Phase | Start | End |
| ----- | ----- | --- |
|       |       |     |

### Discrete Metrics

| Metric | Data Type | Units | Description |
| ------ | --------- | ----- | ----------- |
|        |           |       |             |

## Detailed Documentation

### Events

### Metrics

## Notes

* Events and metrics are placeholders; definitions will be added in a future update.