pytorch/torch/_dynamo/variables
Apurva Jain 8bc5ef563e Grouped Query Attention (#132689)
### Approach: Using the current function declaration

**Constraint:** Q_Heads % KV_Heads == 0

**Major change:**
- Added a new argument enable_gqa: bool to sdpa function call
- It adds a meaning to the last third dimension.

Sample use cases this would enable:
LLama3

```
# LLama3 8b call to SDPA
query = torch.rand(batch, 32, seq_len_q, D)
key = torch.rand(batch, 8, seq_len_kv, D)
value = torch.rand(batch, 8, seq_len_kv, D)

output = scaled_dot_product_attention(query, key, value, is_causal=True, enable_gqa=True)

# Output Shape
(batch, 32, seq_len_q, D)
```

### Design Choice:

- Check if Query.size(-3) == Key.size(-3) == Value.size(-3) or, Query.size(-3) % Key.size(-3) == 0
- The function adjusts the key and value tensors to match the query tensor's head dimension by using repeat_interleave if their number of heads are not equal, facilitating correct and efficient computation in attention mechanisms.
- By default the enable_gqa flag is set to False, which ensures that regular sdpa functionality remains unchanged.

### Benchmarks:

- **sdpa.py: #130634**
For different batch sizes enable_gqa=True shows a substansial improvement in the run_time of sdpa

 | batch_size | q_num_heads | kv_num_heads | q_seq_len | kv_seq_len | embed_dim | forward_time when enable_gqa=True   |   forward_time when enable_gqa=False    |
| ------------ | ------------- | -------------- | ----------- | ------------ | ----------- | ----------- | ---------------- |
|     1      |     32      |      8       |   2048    |    2048    |   2048    |   100.71  |  119.70  |
|     8      |     32      |      8       |   2048    |    2048    |   2048    |   539.78  |  628.83  |
|     16     |     32      |      8       |   2048    |    2048    |   2048    |   1056.81  |  1225.48  |
|     32      |     32      |      8       |   2048    |    2048    |   2048    |   2099.54  |  2440.45  |

![Screenshot 2024-07-25 at 9 07 40 PM](https://github.com/user-attachments/assets/a3e5f716-c39f-4096-9e6c-82a735e57b7b)

- **TorchTitan: https://github.com/pytorch/torchtitan/pull/458**

Differential Revision: D60772086

Pull Request resolved: https://github.com/pytorch/pytorch/pull/132689
Approved by: https://github.com/drisspg
2024-08-07 05:35:36 +00:00
..
__init__.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
base.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
builder.py [dynamo][inline_inbuilt_nn_modules] Mark nn module tensor static for cudagraphs (#132736) 2024-08-06 20:13:28 +00:00
builtin.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
constant.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
ctx_manager.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
dicts.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
distributed.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
functions.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
higher_order_ops.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
iter.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
lazy.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
lists.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00
misc.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
nn_module.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
optimizer.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
script_object.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
sdpa.py Grouped Query Attention (#132689) 2024-08-07 05:35:36 +00:00
tensor.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
torch_function.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
torch.py Add basic mypy annotations to dynamo (#132415) 2024-08-04 18:43:36 +00:00
user_defined.py [dynamo] revert map/zip iterator related changes (#132528) 2024-08-04 18:46:55 +00:00