stack-attention-pytorch 0.0.2__tar.gz → 0.0.3__tar.gz

{stack_attention_pytorch-0.0.2 → stack_attention_pytorch-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stack-attention-pytorch
-Version: 0.0.2
+Version: 0.0.3
 Summary: Implementation of Differentiable Stacks for augmenting Transformers / Attention
 Project-URL: Homepage, https://pypi.org/project/stack-attention-pytorch/
 Project-URL: Repository, https://github.com/lucidrains/stack-attention-pytorch
@@ -47,6 +47,37 @@ Description-Content-Type: text/markdown
 
 For following a line of research that augments attention with a differentiable stack, beginning with DuSell et al. at ETH Zurich
 
+## Install
+
+```bash
+$ pip install stack-attention
+```
+
+## Usage
+
+```python
+import torch
+from stack_attention.stack_trans_layer import StackTransLayer
+
+tokens = torch.randn(2, 512, 256)
+
+layer = StackTransLayer(256)
+
+out1, state = layer(
+    tokens,
+    stochastic_action = stochastic_action,
+    hard_action = hard_action
+)
+
+out2, state = layer(
+    tokens,
+    stochastic_action = stochastic_action,
+    hard_action = hard_action
+)
+
+assert out1.shape == out2.shape == tokens.shape
+```
+
 ## Citations
 
 ```bibtex

{stack_attention_pytorch-0.0.2 → stack_attention_pytorch-0.0.3}/README.md

@@ -2,6 +2,37 @@
 
 For following a line of research that augments attention with a differentiable stack, beginning with DuSell et al. at ETH Zurich
 
+## Install
+
+```bash
+$ pip install stack-attention
+```
+
+## Usage
+
+```python
+import torch
+from stack_attention.stack_trans_layer import StackTransLayer
+
+tokens = torch.randn(2, 512, 256)
+
+layer = StackTransLayer(256)
+
+out1, state = layer(
+    tokens,
+    stochastic_action = stochastic_action,
+    hard_action = hard_action
+)
+
+out2, state = layer(
+    tokens,
+    stochastic_action = stochastic_action,
+    hard_action = hard_action
+)
+
+assert out1.shape == out2.shape == tokens.shape
+```
+
 ## Citations
 
 ```bibtex

{stack_attention_pytorch-0.0.2 → stack_attention_pytorch-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stack-attention-pytorch"
-version = "0.0.2"
+version = "0.0.3"
 description = "Implementation of Differentiable Stacks for augmenting Transformers / Attention"
 authors = [
     { name = "Phil Wang", email = "lucidrains@gmail.com" }

{stack_attention_pytorch-0.0.2 → stack_attention_pytorch-0.0.3}/stack_attention/stack_trans_layer.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 from functools import partial
 
 import torch
-from torch import cat, nn, Tensor
+from torch import cat, nn, Tensor, tensor
 from torch.nn import Module, Linear, RMSNorm, Parameter
 import torch.nn.functional as F
 
@@ -58,7 +58,9 @@ class StackTransLayer(Module):
         num_stacks = 4,     # heads
         dim_stack = 16,     # dim head
         stack_size = 24,
-        prenorm = False
+        prenorm = False,
+        add_residual = True,
+        learned_residual_gate = True
     ):
         super().__init__()
 
@@ -87,10 +89,17 @@ class StackTransLayer(Module):
 
         self.null_stack = Parameter(torch.randn(dim_stack) * 1e-2)
 
-        # combine
+        # combining stack reads across number of stacks
 
         self.combine = LinearNoBias(dim_inner, dim)
 
+        # maybe combining with residual
+
+        self.add_residual = add_residual
+        learned_residual_gate &= add_residual
+
+        self.residual_scale = Parameter(tensor(0.)) if learned_residual_gate else None
+
     def forward(
         self,
         tokens,
@@ -101,7 +110,7 @@ class StackTransLayer(Module):
     ):
         assert action_temperature > 0.
 
-        orig, device = tokens, tokens.device
+        residual, device = tokens, tokens.device
 
         # maybe pre norm
 
@@ -188,7 +197,7 @@ class StackTransLayer(Module):
 
         read_stack_out = einsum(next_stack_with_null, read_stack_attn, 'b h s d, b h s -> b h d')
 
-        # combine
+        # combine heads
 
         out = rearrange(stack_inputs, 'b h d -> b (h d)')
 
@@ -196,4 +205,9 @@ class StackTransLayer(Module):
 
         out = inverse_pack(out)
 
+        # maybe add residual
+
+        if self.add_residual:
+            out = out + residual * self.residual_scale.exp()
+
         return out, next_stack_states