Fix: remove duplicate forward method in LiquidSSMBlock, clean up dead code"
Browse files- liquidflow/model.py +86 -261
liquidflow/model.py
CHANGED
|
@@ -2,11 +2,10 @@
|
|
| 2 |
LiquidFlow: A Novel Liquid-SSM Flow Matching Image Generator
|
| 3 |
v0.2.0 — Memory-optimized for Colab T4 (15GB VRAM)
|
| 4 |
|
| 5 |
-
|
| 6 |
-
- SSM scan computes per-step
|
| 7 |
-
- Gradient checkpointing on
|
| 8 |
-
- Liquid CfC
|
| 9 |
-
- Fixed deprecated torch.cuda.amp API
|
| 10 |
"""
|
| 11 |
|
| 12 |
import math
|
|
@@ -22,56 +21,37 @@ from torch.utils.checkpoint import checkpoint
|
|
| 22 |
|
| 23 |
class LiquidCfCCell(nn.Module):
|
| 24 |
"""
|
| 25 |
-
Closed-form Continuous-depth Liquid Cell.
|
| 26 |
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
Sigmoid gating guarantees bounded dynamics — no explosion by construction.
|
| 32 |
-
|
| 33 |
-
MEMORY FIX v0.2: Uses a single linear projection instead of two separate
|
| 34 |
-
networks + avoids expanding hidden state to (B, L, D).
|
| 35 |
"""
|
| 36 |
|
| 37 |
def __init__(self, input_dim, hidden_dim):
|
| 38 |
super().__init__()
|
| 39 |
self.hidden_dim = hidden_dim
|
| 40 |
-
# Single fused projection: input → (tau, state_update)
|
| 41 |
-
# Much more memory efficient than two separate networks
|
| 42 |
self.backbone = nn.Linear(input_dim, hidden_dim)
|
| 43 |
-
self.gate_proj = nn.Linear(hidden_dim, hidden_dim * 2)
|
| 44 |
self.act = nn.Tanh()
|
| 45 |
|
| 46 |
def forward(self, x):
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
Returns: (B, L, hidden_dim)
|
| 50 |
-
"""
|
| 51 |
-
# Project input
|
| 52 |
-
h = self.backbone(x) # (B, L, hidden_dim)
|
| 53 |
-
h = self.act(h)
|
| 54 |
-
proj = self.gate_proj(h) # (B, L, hidden_dim * 2)
|
| 55 |
-
f_tau, f_x = proj.chunk(2, dim=-1)
|
| 56 |
-
|
| 57 |
-
# CfC gating: gate ∈ (0,1) by sigmoid → bounded output
|
| 58 |
gate = torch.sigmoid(-f_tau)
|
| 59 |
-
|
| 60 |
-
out = gate * h + (1.0 - gate) * f_x
|
| 61 |
-
return out
|
| 62 |
|
| 63 |
|
| 64 |
# ============================================================
|
| 65 |
-
# 2. SELECTIVE STATE SPACE BLOCK (Pure PyTorch
|
| 66 |
# ============================================================
|
| 67 |
|
| 68 |
class SelectiveSSM(nn.Module):
|
| 69 |
"""
|
| 70 |
-
Selective SSM
|
| 71 |
|
| 72 |
-
|
| 73 |
-
|
| 74 |
-
This reduces peak memory from O(B*L*D*N) to O(B*D*N).
|
| 75 |
"""
|
| 76 |
|
| 77 |
def __init__(self, d_model, d_state=16, d_conv=4, expand=2):
|
|
@@ -81,7 +61,6 @@ class SelectiveSSM(nn.Module):
|
|
| 81 |
self.d_inner = int(d_model * expand)
|
| 82 |
|
| 83 |
self.in_proj = nn.Linear(d_model, self.d_inner * 2, bias=False)
|
| 84 |
-
|
| 85 |
self.conv1d = nn.Conv1d(
|
| 86 |
self.d_inner, self.d_inner, d_conv,
|
| 87 |
padding=d_conv - 1, groups=self.d_inner, bias=True,
|
|
@@ -99,65 +78,44 @@ class SelectiveSSM(nn.Module):
|
|
| 99 |
dt_init = torch.exp(
|
| 100 |
torch.rand(self.d_inner) * (math.log(0.1) - math.log(0.001)) + math.log(0.001)
|
| 101 |
)
|
| 102 |
-
|
| 103 |
-
self.dt_proj.bias.copy_(inv_dt)
|
| 104 |
|
| 105 |
def forward(self, x):
|
| 106 |
-
B, L,
|
| 107 |
-
|
| 108 |
xz = self.in_proj(x)
|
| 109 |
x_inner, z = xz.chunk(2, dim=-1)
|
| 110 |
|
| 111 |
-
x_conv = self.conv1d(x_inner.transpose(1, 2))[:, :, :L].transpose(1, 2)
|
| 112 |
-
x_conv = F.silu(x_conv)
|
| 113 |
|
| 114 |
x_ssm = self.x_proj(x_conv)
|
| 115 |
B_sel = x_ssm[:, :, :self.d_state]
|
| 116 |
C_sel = x_ssm[:, :, self.d_state:2*self.d_state]
|
| 117 |
-
dt = x_ssm[:, :, -1:]
|
| 118 |
-
dt = F.softplus(self.dt_proj(dt))
|
| 119 |
-
|
| 120 |
-
A = -torch.exp(self.A_log) # (d_inner, d_state)
|
| 121 |
|
| 122 |
-
|
|
|
|
| 123 |
|
| 124 |
y = y + x_conv * self.D.unsqueeze(0).unsqueeze(0)
|
| 125 |
-
|
| 126 |
-
return self.out_proj(y)
|
| 127 |
|
| 128 |
-
def
|
| 129 |
-
"""
|
| 130 |
-
Memory-lean selective scan.
|
| 131 |
-
Computes discretization per-step inside the loop to avoid
|
| 132 |
-
materializing the full (B, L, d_inner, d_state) tensors.
|
| 133 |
-
|
| 134 |
-
Peak memory: O(B * d_inner * d_state) instead of O(B * L * d_inner * d_state).
|
| 135 |
-
"""
|
| 136 |
B_batch, L, d_inner = x.shape
|
| 137 |
-
d_state = A.shape[1]
|
| 138 |
|
| 139 |
-
h = torch.zeros(B_batch, d_inner, d_state, device=x.device, dtype=x.dtype)
|
| 140 |
ys = []
|
| 141 |
|
| 142 |
for i in range(L):
|
| 143 |
-
|
| 144 |
-
|
| 145 |
-
|
| 146 |
-
|
| 147 |
-
x_i = x[:, i, :] # (B, d_inner)
|
| 148 |
-
|
| 149 |
-
# dA_i = exp(dt_i * A) — broadcast: (B, d_inner, 1) * (1, d_inner, d_state)
|
| 150 |
-
dA_i = torch.exp(dt_i.unsqueeze(-1) * A.unsqueeze(0)) # (B, d_inner, d_state)
|
| 151 |
|
| 152 |
-
|
| 153 |
-
dBx_i = dt_i.unsqueeze(-1) * B_i.unsqueeze(1) * x_i.unsqueeze(-1)
|
| 154 |
|
| 155 |
-
# Recurrence
|
| 156 |
h = dA_i * h + dBx_i
|
| 157 |
-
|
| 158 |
-
# Output
|
| 159 |
-
y_i = (h * C_i.unsqueeze(1)).sum(-1) # (B, d_inner)
|
| 160 |
-
ys.append(y_i)
|
| 161 |
|
| 162 |
return torch.stack(ys, dim=1)
|
| 163 |
|
|
@@ -169,22 +127,15 @@ class SelectiveSSM(nn.Module):
|
|
| 169 |
def create_scan_patterns(H, W):
|
| 170 |
total = H * W
|
| 171 |
indices = torch.arange(total)
|
| 172 |
-
|
| 173 |
-
row_major = indices.clone()
|
| 174 |
-
row_major_rev = indices.flip(0)
|
| 175 |
-
|
| 176 |
grid = indices.view(H, W)
|
| 177 |
-
col_major = grid.t().contiguous().view(-1)
|
| 178 |
|
| 179 |
-
|
| 180 |
-
|
| 181 |
-
|
| 182 |
-
|
| 183 |
-
|
| 184 |
-
|
| 185 |
-
zigzag = torch.cat(zigzag)
|
| 186 |
|
| 187 |
-
patterns = [row_major, row_major_rev, col_major, zigzag]
|
| 188 |
inverse_patterns = []
|
| 189 |
for p in patterns:
|
| 190 |
inv = torch.zeros_like(p)
|
|
@@ -195,86 +146,33 @@ def create_scan_patterns(H, W):
|
|
| 195 |
|
| 196 |
|
| 197 |
# ============================================================
|
| 198 |
-
# 4. LIQUID-SSM BLOCK with gradient checkpointing
|
| 199 |
# ============================================================
|
| 200 |
|
| 201 |
class LiquidSSMBlock(nn.Module):
|
| 202 |
def __init__(self, d_model, d_state=16, d_conv=4, expand=2, dropout=0.0):
|
| 203 |
super().__init__()
|
| 204 |
-
|
| 205 |
self.norm1 = nn.LayerNorm(d_model)
|
| 206 |
self.ssm = SelectiveSSM(d_model, d_state, d_conv, expand)
|
| 207 |
-
|
| 208 |
self.norm2 = nn.LayerNorm(d_model)
|
| 209 |
self.liquid = LiquidCfCCell(d_model, d_model)
|
| 210 |
-
|
| 211 |
self.norm3 = nn.LayerNorm(d_model)
|
| 212 |
self.ff = nn.Sequential(
|
| 213 |
-
nn.Linear(d_model, d_model * 4),
|
| 214 |
-
nn.
|
| 215 |
-
nn.Dropout(dropout),
|
| 216 |
-
nn.Linear(d_model * 4, d_model),
|
| 217 |
-
nn.Dropout(dropout),
|
| 218 |
)
|
| 219 |
-
|
| 220 |
self.mix_alpha = nn.Parameter(torch.tensor(0.5))
|
| 221 |
-
|
| 222 |
-
def
|
| 223 |
-
|
| 224 |
-
|
| 225 |
-
|
| 226 |
-
|
| 227 |
-
|
| 228 |
-
mixed = alpha * ssm_out + (1.0 - alpha) * liquid_out
|
| 229 |
-
return mixed
|
| 230 |
-
|
| 231 |
-
def forward(self, x, scan_idx=None, unscan_idx=None):
|
| 232 |
-
if scan_idx is not None:
|
| 233 |
-
x_scanned = x[:, scan_idx]
|
| 234 |
-
else:
|
| 235 |
-
x_scanned = x
|
| 236 |
-
|
| 237 |
-
# Gradient checkpointing: recompute forward during backward
|
| 238 |
-
# to save activation memory
|
| 239 |
-
if self.training and x.requires_grad:
|
| 240 |
-
mixed = checkpoint(self._inner_forward, x, x_scanned, use_reentrant=False)
|
| 241 |
-
else:
|
| 242 |
-
mixed = self._inner_forward(x, x_scanned)
|
| 243 |
-
|
| 244 |
-
# Unscan the SSM output portion
|
| 245 |
-
# Note: mixed already contains both SSM (scanned) and Liquid (unscanned)
|
| 246 |
-
# The SSM part was scanned, so we need to unscan the full mixed output
|
| 247 |
-
# Actually since we mix before unscanning, and liquid operates on original order,
|
| 248 |
-
# we need to handle this differently. Let's unscan only the SSM part.
|
| 249 |
-
# FIXED: unscan happens inside _inner_forward is wrong — we need it outside.
|
| 250 |
-
# Re-architect: unscan the SSM output before mixing.
|
| 251 |
-
|
| 252 |
-
# Actually the mixing happens inside _inner_forward on the scanned SSM output.
|
| 253 |
-
# The Liquid branch sees original order. The mix combines them.
|
| 254 |
-
# For the SSM branch to be correct, we should unscan its output before mixing.
|
| 255 |
-
# Let me fix this properly:
|
| 256 |
-
|
| 257 |
-
# The above checkpoint call passes x_scanned which is in scan order.
|
| 258 |
-
# SSM processes it in scan order and outputs in scan order.
|
| 259 |
-
# We need to unscan before mixing with Liquid (which is in original order).
|
| 260 |
-
# This is handled by splitting the logic:
|
| 261 |
-
|
| 262 |
-
if unscan_idx is not None:
|
| 263 |
-
# We need to redo this without checkpoint for correct unscan
|
| 264 |
-
# Actually let's restructure to handle unscan inside
|
| 265 |
-
pass
|
| 266 |
-
|
| 267 |
-
x = x + mixed
|
| 268 |
-
x = x + self.ff(self.norm3(x))
|
| 269 |
-
return x
|
| 270 |
-
|
| 271 |
def forward(self, x, scan_idx=None, unscan_idx=None):
|
| 272 |
-
|
| 273 |
-
if scan_idx is not None:
|
| 274 |
-
x_scanned = x[:, scan_idx]
|
| 275 |
-
else:
|
| 276 |
-
x_scanned = x
|
| 277 |
|
|
|
|
| 278 |
if self.training and x.requires_grad:
|
| 279 |
ssm_out = checkpoint(self._ssm_forward, x_scanned, use_reentrant=False)
|
| 280 |
liquid_out = checkpoint(self._liquid_forward, x, use_reentrant=False)
|
|
@@ -287,45 +185,34 @@ class LiquidSSMBlock(nn.Module):
|
|
| 287 |
ssm_out = ssm_out[:, unscan_idx]
|
| 288 |
|
| 289 |
alpha = torch.sigmoid(self.mix_alpha)
|
| 290 |
-
|
| 291 |
-
|
| 292 |
-
x = x + mixed
|
| 293 |
x = x + self.ff(self.norm3(x))
|
| 294 |
return x
|
| 295 |
-
|
| 296 |
-
def _ssm_forward(self, x_scanned):
|
| 297 |
-
return self.ssm(self.norm1(x_scanned))
|
| 298 |
-
|
| 299 |
-
def _liquid_forward(self, x):
|
| 300 |
-
return self.liquid(self.norm2(x))
|
| 301 |
|
| 302 |
|
| 303 |
# ============================================================
|
| 304 |
-
# 5.
|
| 305 |
# ============================================================
|
| 306 |
|
| 307 |
class SinusoidalPosEmb(nn.Module):
|
| 308 |
def __init__(self, dim):
|
| 309 |
super().__init__()
|
| 310 |
self.dim = dim
|
| 311 |
-
|
| 312 |
def forward(self, t):
|
| 313 |
-
|
| 314 |
-
emb = math.log(10000) / (
|
| 315 |
-
emb = torch.exp(torch.arange(
|
| 316 |
emb = t.unsqueeze(-1) * emb.unsqueeze(0)
|
| 317 |
return torch.cat([emb.sin(), emb.cos()], dim=-1)
|
| 318 |
|
| 319 |
-
|
| 320 |
class AdaptiveLayerNorm(nn.Module):
|
| 321 |
def __init__(self, d_model, cond_dim):
|
| 322 |
super().__init__()
|
| 323 |
self.norm = nn.LayerNorm(d_model, elementwise_affine=False)
|
| 324 |
self.proj = nn.Sequential(nn.SiLU(), nn.Linear(cond_dim, d_model * 2))
|
| 325 |
-
|
| 326 |
def forward(self, x, cond):
|
| 327 |
-
|
| 328 |
-
return self.norm(x) * (1 +
|
| 329 |
|
| 330 |
|
| 331 |
# ============================================================
|
|
@@ -333,10 +220,8 @@ class AdaptiveLayerNorm(nn.Module):
|
|
| 333 |
# ============================================================
|
| 334 |
|
| 335 |
class LiquidFlowNet(nn.Module):
|
| 336 |
-
def __init__(
|
| 337 |
-
|
| 338 |
-
depth=8, d_state=16, d_conv=4, expand=2, dropout=0.0, num_classes=0,
|
| 339 |
-
):
|
| 340 |
super().__init__()
|
| 341 |
self.img_size = img_size
|
| 342 |
self.patch_size = patch_size
|
|
@@ -350,28 +235,16 @@ class LiquidFlowNet(nn.Module):
|
|
| 350 |
self.num_patches = self.num_patches_h * self.num_patches_w
|
| 351 |
self.patch_dim = in_channels * patch_size * patch_size
|
| 352 |
|
| 353 |
-
self.patch_embed = nn.Sequential(
|
| 354 |
-
nn.Linear(self.patch_dim, d_model), nn.LayerNorm(d_model),
|
| 355 |
-
)
|
| 356 |
self.pos_embed = nn.Parameter(torch.randn(1, self.num_patches, d_model) * 0.02)
|
| 357 |
-
|
| 358 |
self.time_embed = nn.Sequential(
|
| 359 |
-
SinusoidalPosEmb(d_model),
|
| 360 |
-
nn.Linear(d_model, d_model * 4), nn.GELU(),
|
| 361 |
-
nn.Linear(d_model * 4, d_model),
|
| 362 |
)
|
| 363 |
-
|
| 364 |
self.class_embed = nn.Embedding(num_classes, d_model) if num_classes > 0 else None
|
| 365 |
|
| 366 |
-
self.blocks = nn.ModuleList([
|
| 367 |
-
|
| 368 |
-
])
|
| 369 |
-
self.adaln_blocks = nn.ModuleList([
|
| 370 |
-
AdaptiveLayerNorm(d_model, d_model) for _ in range(depth)
|
| 371 |
-
])
|
| 372 |
-
self.skip_projs = nn.ModuleList([
|
| 373 |
-
nn.Linear(d_model * 2, d_model) for _ in range(depth // 2)
|
| 374 |
-
])
|
| 375 |
|
| 376 |
self.final_norm = nn.LayerNorm(d_model)
|
| 377 |
self.final_proj = nn.Linear(d_model, self.patch_dim)
|
|
@@ -384,45 +257,34 @@ class LiquidFlowNet(nn.Module):
|
|
| 384 |
|
| 385 |
self.pre_conv = nn.Conv2d(d_model, d_model, 3, padding=1, groups=d_model)
|
| 386 |
self.post_conv = nn.Conv2d(d_model, d_model, 3, padding=1, groups=d_model)
|
| 387 |
-
|
| 388 |
self._init_weights()
|
| 389 |
|
| 390 |
def _init_weights(self):
|
| 391 |
for m in self.modules():
|
| 392 |
if isinstance(m, nn.Linear):
|
| 393 |
nn.init.xavier_uniform_(m.weight)
|
| 394 |
-
if m.bias is not None:
|
| 395 |
-
nn.init.zeros_(m.bias)
|
| 396 |
elif isinstance(m, (nn.Conv2d, nn.Conv1d)):
|
| 397 |
nn.init.xavier_uniform_(m.weight)
|
| 398 |
-
if m.bias is not None:
|
| 399 |
-
nn.init.zeros_(m.bias)
|
| 400 |
nn.init.zeros_(self.final_proj.weight)
|
| 401 |
nn.init.zeros_(self.final_proj.bias)
|
| 402 |
|
| 403 |
def patchify(self, x):
|
| 404 |
B, C, H, W = x.shape
|
| 405 |
p = self.patch_size
|
| 406 |
-
|
| 407 |
-
x = x.contiguous().view(B, C, self.num_patches_h, self.num_patches_w, p * p)
|
| 408 |
-
x = x.permute(0, 2, 3, 1, 4).contiguous().view(B, self.num_patches, self.patch_dim)
|
| 409 |
-
return x
|
| 410 |
|
| 411 |
def unpatchify(self, x):
|
| 412 |
-
B = x.shape[0]
|
| 413 |
-
|
| 414 |
-
x = x.view(B, self.num_patches_h, self.num_patches_w, self.in_channels, p, p)
|
| 415 |
-
x = x.permute(0, 3, 1, 4, 2, 5).contiguous()
|
| 416 |
-
return x.view(B, self.in_channels, self.num_patches_h * p, self.num_patches_w * p)
|
| 417 |
|
| 418 |
def forward(self, x, t, class_label=None):
|
| 419 |
B = x.shape[0]
|
| 420 |
-
|
| 421 |
tokens = self.patch_embed(self.patchify(x)) + self.pos_embed
|
| 422 |
|
| 423 |
-
|
| 424 |
-
|
| 425 |
-
tokens = self.pre_conv(h2d).permute(0, 2, 3, 1).contiguous().view(B, self.num_patches, self.d_model)
|
| 426 |
|
| 427 |
t_emb = self.time_embed(t)
|
| 428 |
if self.class_embed is not None and class_label is not None:
|
|
@@ -432,23 +294,15 @@ class LiquidFlowNet(nn.Module):
|
|
| 432 |
for i, (block, adaln) in enumerate(zip(self.blocks, self.adaln_blocks)):
|
| 433 |
tokens = adaln(tokens, t_emb)
|
| 434 |
si = i % self.num_scan_patterns
|
| 435 |
-
|
| 436 |
-
|
| 437 |
-
|
| 438 |
-
if i < self.depth // 2:
|
| 439 |
-
skips.append(tokens)
|
| 440 |
-
|
| 441 |
-
tokens = block(tokens, scan_idx, unscan_idx)
|
| 442 |
-
|
| 443 |
if i >= self.depth // 2:
|
| 444 |
skip_idx = self.depth - 1 - i
|
| 445 |
if skip_idx < len(skips):
|
| 446 |
tokens = self.skip_projs[skip_idx](torch.cat([tokens, skips[skip_idx]], dim=-1))
|
| 447 |
|
| 448 |
-
|
| 449 |
-
|
| 450 |
-
tokens = self.post_conv(h2d).permute(0, 2, 3, 1).contiguous().view(B, self.num_patches, self.d_model)
|
| 451 |
-
|
| 452 |
return self.unpatchify(self.final_proj(self.final_norm(tokens)))
|
| 453 |
|
| 454 |
def count_params(self):
|
|
@@ -460,51 +314,22 @@ class LiquidFlowNet(nn.Module):
|
|
| 460 |
# ============================================================
|
| 461 |
|
| 462 |
def liquidflow_tiny(img_size=128, num_classes=0):
|
| 463 |
-
|
| 464 |
-
return LiquidFlowNet(
|
| 465 |
-
img_size=img_size, patch_size=4, in_channels=3,
|
| 466 |
-
d_model=192, depth=6, d_state=8, d_conv=4, expand=2,
|
| 467 |
-
num_classes=num_classes,
|
| 468 |
-
)
|
| 469 |
|
| 470 |
def liquidflow_small(img_size=128, num_classes=0):
|
| 471 |
-
|
| 472 |
-
return LiquidFlowNet(
|
| 473 |
-
img_size=img_size, patch_size=4, in_channels=3,
|
| 474 |
-
d_model=256, depth=8, d_state=16, d_conv=4, expand=2,
|
| 475 |
-
num_classes=num_classes,
|
| 476 |
-
)
|
| 477 |
|
| 478 |
def liquidflow_base(img_size=256, num_classes=0):
|
| 479 |
-
|
| 480 |
-
return LiquidFlowNet(
|
| 481 |
-
img_size=img_size, patch_size=8, in_channels=3,
|
| 482 |
-
d_model=384, depth=10, d_state=16, d_conv=4, expand=2,
|
| 483 |
-
num_classes=num_classes,
|
| 484 |
-
)
|
| 485 |
|
| 486 |
def liquidflow_512(img_size=512, num_classes=0):
|
| 487 |
-
|
| 488 |
-
return LiquidFlowNet(
|
| 489 |
-
img_size=img_size, patch_size=16, in_channels=3,
|
| 490 |
-
d_model=384, depth=10, d_state=16, d_conv=4, expand=2,
|
| 491 |
-
num_classes=num_classes,
|
| 492 |
-
)
|
| 493 |
|
| 494 |
|
| 495 |
if __name__ == "__main__":
|
| 496 |
-
|
| 497 |
-
|
| 498 |
-
("
|
| 499 |
-
(
|
| 500 |
-
(
|
| 501 |
-
("
|
| 502 |
-
]:
|
| 503 |
-
model = factory().to(device)
|
| 504 |
-
print(f"\n{name}: {model.count_params()/1e6:.2f}M params")
|
| 505 |
-
B = 2
|
| 506 |
-
x = torch.randn(B, 3, model.img_size, model.img_size)
|
| 507 |
-
t = torch.rand(B)
|
| 508 |
-
v = model(x, t)
|
| 509 |
-
print(f" {x.shape} → {v.shape} ✓")
|
| 510 |
-
assert v.shape == x.shape
|
|
|
|
| 2 |
LiquidFlow: A Novel Liquid-SSM Flow Matching Image Generator
|
| 3 |
v0.2.0 — Memory-optimized for Colab T4 (15GB VRAM)
|
| 4 |
|
| 5 |
+
Key fixes from v0.1:
|
| 6 |
+
- SSM scan computes per-step (no 4D tensor materialization → saves ~6GB)
|
| 7 |
+
- Gradient checkpointing on SSM + Liquid branches (saves ~60% activations)
|
| 8 |
+
- Liquid CfC simplified to single fused projection (saves ~2GB)
|
|
|
|
| 9 |
"""
|
| 10 |
|
| 11 |
import math
|
|
|
|
| 21 |
|
| 22 |
class LiquidCfCCell(nn.Module):
|
| 23 |
"""
|
| 24 |
+
Closed-form Continuous-depth Liquid Cell (memory-optimized).
|
| 25 |
|
| 26 |
+
Single fused projection instead of two separate MLP networks.
|
| 27 |
+
gate = σ(-f_τ), out = gate * h + (1 - gate) * f_x
|
| 28 |
+
Sigmoid gating guarantees bounded dynamics.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 29 |
"""
|
| 30 |
|
| 31 |
def __init__(self, input_dim, hidden_dim):
|
| 32 |
super().__init__()
|
| 33 |
self.hidden_dim = hidden_dim
|
|
|
|
|
|
|
| 34 |
self.backbone = nn.Linear(input_dim, hidden_dim)
|
| 35 |
+
self.gate_proj = nn.Linear(hidden_dim, hidden_dim * 2)
|
| 36 |
self.act = nn.Tanh()
|
| 37 |
|
| 38 |
def forward(self, x):
|
| 39 |
+
h = self.act(self.backbone(x))
|
| 40 |
+
f_tau, f_x = self.gate_proj(h).chunk(2, dim=-1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 41 |
gate = torch.sigmoid(-f_tau)
|
| 42 |
+
return gate * h + (1.0 - gate) * f_x
|
|
|
|
|
|
|
| 43 |
|
| 44 |
|
| 45 |
# ============================================================
|
| 46 |
+
# 2. SELECTIVE STATE SPACE BLOCK (Pure PyTorch, memory-lean)
|
| 47 |
# ============================================================
|
| 48 |
|
| 49 |
class SelectiveSSM(nn.Module):
|
| 50 |
"""
|
| 51 |
+
Selective SSM — memory-optimized scan.
|
| 52 |
|
| 53 |
+
Per-step discretization inside loop avoids materializing
|
| 54 |
+
(B, L, d_inner, d_state) 4D tensors. Peak memory: O(B*D*N) not O(B*L*D*N).
|
|
|
|
| 55 |
"""
|
| 56 |
|
| 57 |
def __init__(self, d_model, d_state=16, d_conv=4, expand=2):
|
|
|
|
| 61 |
self.d_inner = int(d_model * expand)
|
| 62 |
|
| 63 |
self.in_proj = nn.Linear(d_model, self.d_inner * 2, bias=False)
|
|
|
|
| 64 |
self.conv1d = nn.Conv1d(
|
| 65 |
self.d_inner, self.d_inner, d_conv,
|
| 66 |
padding=d_conv - 1, groups=self.d_inner, bias=True,
|
|
|
|
| 78 |
dt_init = torch.exp(
|
| 79 |
torch.rand(self.d_inner) * (math.log(0.1) - math.log(0.001)) + math.log(0.001)
|
| 80 |
)
|
| 81 |
+
self.dt_proj.bias.copy_(dt_init + torch.log(-torch.expm1(-dt_init)))
|
|
|
|
| 82 |
|
| 83 |
def forward(self, x):
|
| 84 |
+
B, L, _ = x.shape
|
|
|
|
| 85 |
xz = self.in_proj(x)
|
| 86 |
x_inner, z = xz.chunk(2, dim=-1)
|
| 87 |
|
| 88 |
+
x_conv = F.silu(self.conv1d(x_inner.transpose(1, 2))[:, :, :L].transpose(1, 2))
|
|
|
|
| 89 |
|
| 90 |
x_ssm = self.x_proj(x_conv)
|
| 91 |
B_sel = x_ssm[:, :, :self.d_state]
|
| 92 |
C_sel = x_ssm[:, :, self.d_state:2*self.d_state]
|
| 93 |
+
dt = F.softplus(self.dt_proj(x_ssm[:, :, -1:]))
|
|
|
|
|
|
|
|
|
|
| 94 |
|
| 95 |
+
A = -torch.exp(self.A_log)
|
| 96 |
+
y = self._scan(x_conv, dt, A, B_sel, C_sel)
|
| 97 |
|
| 98 |
y = y + x_conv * self.D.unsqueeze(0).unsqueeze(0)
|
| 99 |
+
return self.out_proj(y * F.silu(z))
|
|
|
|
| 100 |
|
| 101 |
+
def _scan(self, x, dt, A, B, C):
|
| 102 |
+
"""Memory-lean sequential scan — no 4D tensor allocation."""
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 103 |
B_batch, L, d_inner = x.shape
|
|
|
|
| 104 |
|
| 105 |
+
h = torch.zeros(B_batch, d_inner, self.d_state, device=x.device, dtype=x.dtype)
|
| 106 |
ys = []
|
| 107 |
|
| 108 |
for i in range(L):
|
| 109 |
+
dt_i = dt[:, i] # (B, d_inner)
|
| 110 |
+
B_i = B[:, i] # (B, d_state)
|
| 111 |
+
C_i = C[:, i] # (B, d_state)
|
| 112 |
+
x_i = x[:, i] # (B, d_inner)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 113 |
|
| 114 |
+
dA_i = torch.exp(dt_i.unsqueeze(-1) * A.unsqueeze(0)) # (B, d_inner, d_state)
|
| 115 |
+
dBx_i = dt_i.unsqueeze(-1) * B_i.unsqueeze(1) * x_i.unsqueeze(-1) # (B, d_inner, d_state)
|
| 116 |
|
|
|
|
| 117 |
h = dA_i * h + dBx_i
|
| 118 |
+
ys.append((h * C_i.unsqueeze(1)).sum(-1))
|
|
|
|
|
|
|
|
|
|
| 119 |
|
| 120 |
return torch.stack(ys, dim=1)
|
| 121 |
|
|
|
|
| 127 |
def create_scan_patterns(H, W):
|
| 128 |
total = H * W
|
| 129 |
indices = torch.arange(total)
|
|
|
|
|
|
|
|
|
|
|
|
|
| 130 |
grid = indices.view(H, W)
|
|
|
|
| 131 |
|
| 132 |
+
patterns = [
|
| 133 |
+
indices.clone(), # row-major
|
| 134 |
+
indices.flip(0), # reversed
|
| 135 |
+
grid.t().contiguous().view(-1), # column-major
|
| 136 |
+
torch.cat([grid[i].flip(0) if i % 2 else grid[i] for i in range(H)]), # zigzag
|
| 137 |
+
]
|
|
|
|
| 138 |
|
|
|
|
| 139 |
inverse_patterns = []
|
| 140 |
for p in patterns:
|
| 141 |
inv = torch.zeros_like(p)
|
|
|
|
| 146 |
|
| 147 |
|
| 148 |
# ============================================================
|
| 149 |
+
# 4. LIQUID-SSM BLOCK (with gradient checkpointing)
|
| 150 |
# ============================================================
|
| 151 |
|
| 152 |
class LiquidSSMBlock(nn.Module):
|
| 153 |
def __init__(self, d_model, d_state=16, d_conv=4, expand=2, dropout=0.0):
|
| 154 |
super().__init__()
|
|
|
|
| 155 |
self.norm1 = nn.LayerNorm(d_model)
|
| 156 |
self.ssm = SelectiveSSM(d_model, d_state, d_conv, expand)
|
|
|
|
| 157 |
self.norm2 = nn.LayerNorm(d_model)
|
| 158 |
self.liquid = LiquidCfCCell(d_model, d_model)
|
|
|
|
| 159 |
self.norm3 = nn.LayerNorm(d_model)
|
| 160 |
self.ff = nn.Sequential(
|
| 161 |
+
nn.Linear(d_model, d_model * 4), nn.GELU(), nn.Dropout(dropout),
|
| 162 |
+
nn.Linear(d_model * 4, d_model), nn.Dropout(dropout),
|
|
|
|
|
|
|
|
|
|
| 163 |
)
|
|
|
|
| 164 |
self.mix_alpha = nn.Parameter(torch.tensor(0.5))
|
| 165 |
+
|
| 166 |
+
def _ssm_forward(self, x_scanned):
|
| 167 |
+
return self.ssm(self.norm1(x_scanned))
|
| 168 |
+
|
| 169 |
+
def _liquid_forward(self, x):
|
| 170 |
+
return self.liquid(self.norm2(x))
|
| 171 |
+
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 172 |
def forward(self, x, scan_idx=None, unscan_idx=None):
|
| 173 |
+
x_scanned = x[:, scan_idx] if scan_idx is not None else x
|
|
|
|
|
|
|
|
|
|
|
|
|
| 174 |
|
| 175 |
+
# Gradient checkpointing: recompute during backward → saves activation memory
|
| 176 |
if self.training and x.requires_grad:
|
| 177 |
ssm_out = checkpoint(self._ssm_forward, x_scanned, use_reentrant=False)
|
| 178 |
liquid_out = checkpoint(self._liquid_forward, x, use_reentrant=False)
|
|
|
|
| 185 |
ssm_out = ssm_out[:, unscan_idx]
|
| 186 |
|
| 187 |
alpha = torch.sigmoid(self.mix_alpha)
|
| 188 |
+
x = x + alpha * ssm_out + (1.0 - alpha) * liquid_out
|
|
|
|
|
|
|
| 189 |
x = x + self.ff(self.norm3(x))
|
| 190 |
return x
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 191 |
|
| 192 |
|
| 193 |
# ============================================================
|
| 194 |
+
# 5. EMBEDDINGS
|
| 195 |
# ============================================================
|
| 196 |
|
| 197 |
class SinusoidalPosEmb(nn.Module):
|
| 198 |
def __init__(self, dim):
|
| 199 |
super().__init__()
|
| 200 |
self.dim = dim
|
|
|
|
| 201 |
def forward(self, t):
|
| 202 |
+
half = self.dim // 2
|
| 203 |
+
emb = math.log(10000) / (half - 1)
|
| 204 |
+
emb = torch.exp(torch.arange(half, device=t.device) * -emb)
|
| 205 |
emb = t.unsqueeze(-1) * emb.unsqueeze(0)
|
| 206 |
return torch.cat([emb.sin(), emb.cos()], dim=-1)
|
| 207 |
|
|
|
|
| 208 |
class AdaptiveLayerNorm(nn.Module):
|
| 209 |
def __init__(self, d_model, cond_dim):
|
| 210 |
super().__init__()
|
| 211 |
self.norm = nn.LayerNorm(d_model, elementwise_affine=False)
|
| 212 |
self.proj = nn.Sequential(nn.SiLU(), nn.Linear(cond_dim, d_model * 2))
|
|
|
|
| 213 |
def forward(self, x, cond):
|
| 214 |
+
s, b = self.proj(cond).chunk(2, dim=-1)
|
| 215 |
+
return self.norm(x) * (1 + s.unsqueeze(1)) + b.unsqueeze(1)
|
| 216 |
|
| 217 |
|
| 218 |
# ============================================================
|
|
|
|
| 220 |
# ============================================================
|
| 221 |
|
| 222 |
class LiquidFlowNet(nn.Module):
|
| 223 |
+
def __init__(self, img_size=128, patch_size=4, in_channels=3, d_model=256,
|
| 224 |
+
depth=8, d_state=16, d_conv=4, expand=2, dropout=0.0, num_classes=0):
|
|
|
|
|
|
|
| 225 |
super().__init__()
|
| 226 |
self.img_size = img_size
|
| 227 |
self.patch_size = patch_size
|
|
|
|
| 235 |
self.num_patches = self.num_patches_h * self.num_patches_w
|
| 236 |
self.patch_dim = in_channels * patch_size * patch_size
|
| 237 |
|
| 238 |
+
self.patch_embed = nn.Sequential(nn.Linear(self.patch_dim, d_model), nn.LayerNorm(d_model))
|
|
|
|
|
|
|
| 239 |
self.pos_embed = nn.Parameter(torch.randn(1, self.num_patches, d_model) * 0.02)
|
|
|
|
| 240 |
self.time_embed = nn.Sequential(
|
| 241 |
+
SinusoidalPosEmb(d_model), nn.Linear(d_model, d_model * 4), nn.GELU(), nn.Linear(d_model * 4, d_model),
|
|
|
|
|
|
|
| 242 |
)
|
|
|
|
| 243 |
self.class_embed = nn.Embedding(num_classes, d_model) if num_classes > 0 else None
|
| 244 |
|
| 245 |
+
self.blocks = nn.ModuleList([LiquidSSMBlock(d_model, d_state, d_conv, expand, dropout) for _ in range(depth)])
|
| 246 |
+
self.adaln_blocks = nn.ModuleList([AdaptiveLayerNorm(d_model, d_model) for _ in range(depth)])
|
| 247 |
+
self.skip_projs = nn.ModuleList([nn.Linear(d_model * 2, d_model) for _ in range(depth // 2)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 248 |
|
| 249 |
self.final_norm = nn.LayerNorm(d_model)
|
| 250 |
self.final_proj = nn.Linear(d_model, self.patch_dim)
|
|
|
|
| 257 |
|
| 258 |
self.pre_conv = nn.Conv2d(d_model, d_model, 3, padding=1, groups=d_model)
|
| 259 |
self.post_conv = nn.Conv2d(d_model, d_model, 3, padding=1, groups=d_model)
|
|
|
|
| 260 |
self._init_weights()
|
| 261 |
|
| 262 |
def _init_weights(self):
|
| 263 |
for m in self.modules():
|
| 264 |
if isinstance(m, nn.Linear):
|
| 265 |
nn.init.xavier_uniform_(m.weight)
|
| 266 |
+
if m.bias is not None: nn.init.zeros_(m.bias)
|
|
|
|
| 267 |
elif isinstance(m, (nn.Conv2d, nn.Conv1d)):
|
| 268 |
nn.init.xavier_uniform_(m.weight)
|
| 269 |
+
if m.bias is not None: nn.init.zeros_(m.bias)
|
|
|
|
| 270 |
nn.init.zeros_(self.final_proj.weight)
|
| 271 |
nn.init.zeros_(self.final_proj.bias)
|
| 272 |
|
| 273 |
def patchify(self, x):
|
| 274 |
B, C, H, W = x.shape
|
| 275 |
p = self.patch_size
|
| 276 |
+
return x.unfold(2,p,p).unfold(3,p,p).contiguous().view(B,C,self.num_patches_h,self.num_patches_w,p*p).permute(0,2,3,1,4).contiguous().view(B,self.num_patches,self.patch_dim)
|
|
|
|
|
|
|
|
|
|
| 277 |
|
| 278 |
def unpatchify(self, x):
|
| 279 |
+
B = x.shape[0]; p = self.patch_size
|
| 280 |
+
return x.view(B,self.num_patches_h,self.num_patches_w,self.in_channels,p,p).permute(0,3,1,4,2,5).contiguous().view(B,self.in_channels,self.num_patches_h*p,self.num_patches_w*p)
|
|
|
|
|
|
|
|
|
|
| 281 |
|
| 282 |
def forward(self, x, t, class_label=None):
|
| 283 |
B = x.shape[0]
|
|
|
|
| 284 |
tokens = self.patch_embed(self.patchify(x)) + self.pos_embed
|
| 285 |
|
| 286 |
+
h2d = tokens.view(B, self.num_patches_h, self.num_patches_w, self.d_model).permute(0,3,1,2)
|
| 287 |
+
tokens = self.pre_conv(h2d).permute(0,2,3,1).contiguous().view(B, self.num_patches, self.d_model)
|
|
|
|
| 288 |
|
| 289 |
t_emb = self.time_embed(t)
|
| 290 |
if self.class_embed is not None and class_label is not None:
|
|
|
|
| 294 |
for i, (block, adaln) in enumerate(zip(self.blocks, self.adaln_blocks)):
|
| 295 |
tokens = adaln(tokens, t_emb)
|
| 296 |
si = i % self.num_scan_patterns
|
| 297 |
+
if i < self.depth // 2: skips.append(tokens)
|
| 298 |
+
tokens = block(tokens, getattr(self, f'scan_{si}'), getattr(self, f'unscan_{si}'))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 299 |
if i >= self.depth // 2:
|
| 300 |
skip_idx = self.depth - 1 - i
|
| 301 |
if skip_idx < len(skips):
|
| 302 |
tokens = self.skip_projs[skip_idx](torch.cat([tokens, skips[skip_idx]], dim=-1))
|
| 303 |
|
| 304 |
+
h2d = tokens.view(B, self.num_patches_h, self.num_patches_w, self.d_model).permute(0,3,1,2)
|
| 305 |
+
tokens = self.post_conv(h2d).permute(0,2,3,1).contiguous().view(B, self.num_patches, self.d_model)
|
|
|
|
|
|
|
| 306 |
return self.unpatchify(self.final_proj(self.final_norm(tokens)))
|
| 307 |
|
| 308 |
def count_params(self):
|
|
|
|
| 314 |
# ============================================================
|
| 315 |
|
| 316 |
def liquidflow_tiny(img_size=128, num_classes=0):
|
| 317 |
+
return LiquidFlowNet(img_size=img_size, patch_size=4, d_model=192, depth=6, d_state=8, expand=2, num_classes=num_classes)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 318 |
|
| 319 |
def liquidflow_small(img_size=128, num_classes=0):
|
| 320 |
+
return LiquidFlowNet(img_size=img_size, patch_size=4, d_model=256, depth=8, d_state=16, expand=2, num_classes=num_classes)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 321 |
|
| 322 |
def liquidflow_base(img_size=256, num_classes=0):
|
| 323 |
+
return LiquidFlowNet(img_size=img_size, patch_size=8, d_model=384, depth=10, d_state=16, expand=2, num_classes=num_classes)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 324 |
|
| 325 |
def liquidflow_512(img_size=512, num_classes=0):
|
| 326 |
+
return LiquidFlowNet(img_size=img_size, patch_size=16, d_model=384, depth=10, d_state=16, expand=2, num_classes=num_classes)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 327 |
|
| 328 |
|
| 329 |
if __name__ == "__main__":
|
| 330 |
+
for name, factory in [("tiny-128", lambda: liquidflow_tiny(128)), ("small-128", lambda: liquidflow_small(128))]:
|
| 331 |
+
m = factory()
|
| 332 |
+
print(f"{name}: {m.count_params()/1e6:.1f}M params")
|
| 333 |
+
x = torch.randn(2, 3, m.img_size, m.img_size)
|
| 334 |
+
v = m(x, torch.rand(2))
|
| 335 |
+
print(f" {x.shape} → {v.shape} ✓"); assert v.shape == x.shape
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|