broccoli-ml 0.11.0__tar.gz → 0.12.0__tar.gz

{broccoli_ml-0.11.0 → broccoli_ml-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: broccoli-ml
-Version: 0.11.0
+Version: 0.12.0
 Summary: Some useful Pytorch models, circa 2025
 License: MIT
 Author: Nicholas Bailey

broccoli_ml-0.12.0/broccoli/linear.py

@@ -0,0 +1,88 @@
+# UNDER CONSTRUCTION
+
+import math
+import torch
+from torch import nn
+from torch.nn import functional as F
+
+from .tensor import SigmaReparamTensor
+
+
+class SpectralNormLinear(nn.Module):
+    """
+    ...
+    """
+
+    def __init__(self, in_features: int, out_features: int, bias: bool = True):
+        super().__init__()
+        self.in_features = in_features
+        self.out_features = out_features
+        self.use_bias = bias
+
+        self.weights = None
+
+        self.weight_init = nn.Parameter(torch.empty(out_features, in_features))
+
+        # Define the bias vector as a learnable parameter if required.
+        if self.use_bias:
+            self.bias = nn.Parameter(torch.empty(out_features))
+        else:
+            # If no bias, register it as None.
+            # This is important so that PyTorch doesn't complain when saving/loading the model.
+            self.register_parameter("bias", None)
+
+        self.reset_parameters()
+
+    def reset_parameters(self) -> None:
+        nn.init.kaiming_uniform_(self.weight_init, a=math.sqrt(5))
+        if self.use_bias:
+            fan_in, _ = nn.init._calculate_fan_in_and_fan_out(self.weights)
+            bound = 1 / math.sqrt(fan_in) if fan_in > 0 else 0
+            nn.init.uniform_(self.bias, -bound, bound)
+        self.weights = SigmaReparamTensor(self.weight_init)
+
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        return F.linear(x, self.weights(), self.bias)
+
+    def __repr__(self) -> str:
+        # Optional: A nice representation for printing the module.
+        return (
+            f"SpectralNormFeedForward(in_features={self.in_features}",
+            f"out_features={self.out_features}, bias={self.use_bias})",
+        )
+
+
+class RandomLinear(nn.Linear):
+    """ """
+
+    def __init__(
+        self,
+        in_features: int,
+        out_features: int,
+        bias: bool = False,  # <---- TODO: explain this
+        beta=0.1,
+        forward_looks_random=True,
+    ):
+        super().__init__(in_features, out_features, bias=False)
+        self.beta = beta
+        self.forward_looks_random = forward_looks_random
+
+    def forward(self, inputs: torch.Tensor):
+        if not self.training:
+            return F.linear(inputs, self.weight)
+        else:
+            # Initialise self.random_weights
+            random_weights = torch.empty_like(self.weight)
+            nn.init.trunc_normal_(random_weights)
+            random_weights *= self.beta
+
+            if self.forward_looks_random:
+                # Forward using a reparameterisation trick
+                a = F.linear(inputs.detach(), self.weight, self.bias)
+                b = F.linear(inputs, random_weights, bias=None)
+            else:
+                # Forward as (W_actual * input + W_random * input) + bias
+                a = F.linear(inputs, self.weight, self.bias)
+                b = F.linear(inputs, random_weights, bias=None)
+
+            return a + b

{broccoli_ml-0.11.0 → broccoli_ml-0.12.0}/broccoli/transformer.py

@@ -10,6 +10,7 @@ import torch.nn.functional as F
 from einops import rearrange
 
 from .rope import RotaryEmbedding, apply_rotary_emb
+from .linear import SpectralNormLinear
 
 
 class MHAttention(nn.Module):
@@ -235,6 +236,7 @@ class FeedforwardLayer(nn.Module):
         activation_kwargs=None,
         dropout=0.0,
         linear_module=nn.Linear,
+        norm_memory=False,
     ):
         super().__init__()
 
@@ -245,19 +247,28 @@ class FeedforwardLayer(nn.Module):
 
         self.dropout = nn.Dropout(dropout)
 
+        self.max_features = (
+            2 * ratio * output_features
+            if activation.__name__.endswith("GLU")
+            else ratio * output_features
+        )
+
+        if norm_memory:
+            self.memory_type = SpectralNormLinear
+            self.bias_memories = False
+        else:
+            self.memory_type = linear_module
+            self.bias_memories = True
+
         self.process = nn.Sequential(
             *[
                 nn.LayerNorm(input_features),
-                linear_module(
-                    input_features,
-                    (
-                        2 * ratio * output_features
-                        if activation.__name__.endswith("GLU")
-                        else ratio * output_features
-                    ),
-                ),
+                linear_module(input_features, self.max_features),
                 self.activation,
-                linear_module(ratio * output_features, output_features),
+                nn.LayerNorm(self.max_features),
+                self.memory_type(
+                    ratio * output_features, output_features, bias=self.bias_memories
+                ),
                 self.dropout,
             ]
         )

{broccoli_ml-0.11.0 → broccoli_ml-0.12.0}/broccoli/vit.py

@@ -82,6 +82,7 @@ class ViTEncoder(nn.Module):
         pooling_kernel_stride=2,
         pooling_padding=1,
         intermediate_feedforward_layer=True,
+        norm_intermediate_ff_memory=True,
         transformer_position_embedding="relative",  # absolute or relative
         transformer_embedding_size=256,
         transformer_layers=7,
@@ -263,6 +264,7 @@ class ViTEncoder(nn.Module):
                 activation_kwargs=transformer_activation_kwargs,
                 dropout=transformer_mlp_dropout,
                 linear_module=linear_module,
+                norm_memory=norm_intermediate_ff_memory,
             )
         elif pooling_out_channels < transformer_embedding_size:
             self.intermediate_feedforward_layer = nn.Identity()
@@ -326,6 +328,7 @@ class CCT(nn.Module):
         pooling_kernel_stride=2,
         pooling_padding=1,
         intermediate_feedforward_layer=True,
+        norm_intermediate_ff_memory=True,
         transformer_position_embedding="relative",  # absolute or relative
         transformer_embedding_size=256,
         transformer_layers=7,

{broccoli_ml-0.11.0 → broccoli_ml-0.12.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "broccoli-ml"
-version = "0.11.0"
+version = "0.12.0"
 description = "Some useful Pytorch models, circa 2025"
 authors = [
     {name = "Nicholas Bailey"}

broccoli_ml-0.11.0/broccoli/linear.py

@@ -1,41 +0,0 @@
-# UNDER CONSTRUCTION
-
-import torch
-from torch import nn
-from torch.nn import functional as F
-
-
-class RandomLinear(nn.Linear):
-    """ """
-
-    def __init__(
-        self,
-        in_features: int,
-        out_features: int,
-        bias: bool = False,  # <---- TODO: explain this
-        beta=0.1,
-        forward_looks_random=True,
-    ):
-        super().__init__(in_features, out_features, bias=False)
-        self.beta = beta
-        self.forward_looks_random = forward_looks_random
-
-    def forward(self, inputs: torch.Tensor):
-        if not self.training:
-            return F.linear(inputs, self.weight)
-        else:
-            # Initialise self.random_weights
-            random_weights = torch.empty_like(self.weight)
-            nn.init.trunc_normal_(random_weights)
-            random_weights *= self.beta
-
-            if self.forward_looks_random:
-                # Forward using a reparameterisation trick
-                a = F.linear(inputs.detach(), self.weight, self.bias)
-                b = F.linear(inputs, random_weights, bias=None)
-            else:
-                # Forward as (W_actual * input + W_random * input) + bias
-                a = F.linear(inputs, self.weight, self.bias)
-                b = F.linear(inputs, random_weights, bias=None)
-
-            return a + b