Files
hao-ai-lab-FastVideo/v2/models/tiled/loop.py
T
SolitaryThinker 4e331eb7ff [refactor] v2: use absolute imports (v2.*) everywhere instead of relative
Mechanical conversion of every relative import under v2/ to an absolute v2.* path
(from .x / ..x / ...x -> from v2.<pkg>.x) so imports are unambiguous, grep-able, and
stable when code is copied/moved between entrypoints (VideoGenerator, CLI, server).

Surgical prefix-only rewrite: only the 'from <dots><module>' prefix changed — import
names, parentheses, multi-line formatting, comments, and ordering are byte-for-byte
preserved (no collapsing, no reorder, no unrelated reformatting).

- 471 imports across 125 files; v2/tests/ was already absolute (untouched).
- Validated: all 125 files compile, every 'from v2.* import' target resolves to a real
  module/package, zero relative imports remain (full sweep), CPU mini suite green
  (202 passed, 2 skipped).
2026-07-04 17:15:34 +00:00

81 lines
3.6 KiB
Python

"""VAETileLoop — tiled VAE decode (design_v3 §4.3 ``LoopKind.VAE_TILE``; §17 falsifier probe).
Decodes a latent in spatial row-tiles, **each tile a ``VAE_TILE`` WorkUnit** that flows through the
exact same admission + step-scheduling + interleave machinery as a denoise step. This is the §17
falsifier made testable: *does the general WorkUnit scheduler earn its generality on non-step kinds, or
should tiles collapse to an in-loop call?* At the mechanism level it composes cleanly — VAE_TILE units
interleave bit-identically with DIFFUSION_STEP units across requests (the §9.3 gate over mixed kinds).
Whether it *pays* on a real GPU duty-cycle is the empirical half of the falsifier (deferred to the port).
The toy VAE is spatially local (channel-mix + repeat-upsample), so tiled decode is **exactly** equal to
one-shot decode — a C0 component parity the tests assert.
"""
from __future__ import annotations
import numpy as np
from v2._enums import WorkUnitKind
from v2.loop.contracts import (
Done,
LoopResult,
LoopState,
ResourceRequest,
ShapeSignature,
StepResult,
WorkPlan,
)
class VAETileLoop:
def __init__(self, *, loop_id, vae_id="vae", cost, tile_rows=1, latent_slot="denoise_out"):
self.loop_id = loop_id
self.vae_id = vae_id
self.cost = cost
self.tile_rows = tile_rows
self.latent_slot = latent_slot
def init(self, req, model, ctx) -> LoopState:
out = ctx.slots.get(self.latent_slot)
latent = out["latents"] if isinstance(out, dict) else out
latent = np.asarray(latent, dtype="float32")
st = LoopState(loop_id=self.loop_id, instance_id=model.card.model_id,
request_id=req.request_id, profile=ctx.profile)
h = latent.shape[2]
st.scratch["latent"] = latent
st.scratch["tiles"] = [(r, min(r + self.tile_rows, h)) for r in range(0, h, self.tile_rows)] or [(0, h)]
st.scratch["decoded"] = [None] * len(st.scratch["tiles"])
return st
def next(self, st: LoopState):
i = st.step_idx
tiles = st.scratch["tiles"]
if i >= len(tiles):
return Done()
r0, r1 = tiles[i]
latent, vid = st.scratch["latent"], self.vae_id
def run(model, override=None):
tile = latent[:, :, r0:r1, :] # a spatial row-band of the latent
dec = model.component(vid).decode(tile)
return StepResult(output={"tile": np.asarray(dec, dtype="float32"), "i": i})
rows = r1 - r0
res = ResourceRequest(
compute_seconds=self.cost.predict(int(rows * latent.shape[1] * latent.shape[3])),
resident_bytes=int(latent.nbytes), peak_activation_bytes=int(latent[:, :, r0:r1, :].nbytes))
return WorkPlan(
loop_id=self.loop_id, instance_id=st.instance_id, kind=WorkUnitKind.VAE_TILE,
shape_sig=ShapeSignature(WorkUnitKind.VAE_TILE, dims=(rows, latent.shape[3])),
resources=res, payload={"tile": i}, run=run, label=f"vae.tile{i}")
def advance(self, st: LoopState, result: StepResult) -> LoopState:
st.scratch["decoded"][int(result.output["i"])] = result.output["tile"]
st.step_idx += 1
return st
def finalize(self, st: LoopState) -> LoopResult:
tiles = [t for t in st.scratch["decoded"] if t is not None]
video = np.concatenate(tiles, axis=2) if tiles else None # stitch row-bands back together
return LoopResult(outputs={"video": video, "latents": st.scratch["latent"]},
metrics={"vae_tiles": float(st.step_idx)})