← Clebsch surfaces
FLUID COHOMOLOGY · FLAT TORUSHarmonic state lab

Same local curl · different global transport

What did
vorticity forget?

On a periodic square, adding a constant flow changes how particles wind around the torus but changes no local vorticity. The missing information is exactly two numbers: circulation around the horizontal cycle and circulation around the vertical cycle.

PATCH DATA

Vorticity fixes local boundary circulation.

vorticity and Stokes

For every contractible loop that bounds a patch A, vorticity determines the circulation.

LOOP DATA

Two noncontractible periods remain.

normalized horizontal and vertical periods

Neither generator is a patch boundary. These two numbers are independent velocity data.

HARMONIC DATA

The periods select one velocity among many.

coexact reconstruction plus two harmonic modes

All choices share the same vorticity. Pressure cannot choose between them because subtracting d p changes no closed-loop period.

PERIODIC FUNDAMENTAL DOMAINopposite edges are identified
raw material after subtraction
ARROWS
MATERIAL GRID
SELECTED RECONSTRUCTION
residual periods

No lattice field is removed. Both grids coincide and carry the same nonzero physical harmonic drift.

raw periods
removed field
residual periods
residual harmonic energy
raw mean winding
cyan mean winding

What the subtraction means

Three operations that look similar—but are not.

All three manipulate one-forms. Only one is a pressure projection, and only one changes the cohomology class.

01 · PRESSURE

Remove an exact field

eta minus d p

Enforces zero divergence. Closed-loop periods and vorticity are unchanged because an exact form integrates to zero around every closed loop.

02 · STREAMFUNCTION

Recover the coexact field

vorticity maps to curl pseudoinverse

Recovers the least-norm velocity seen by vorticity. “Least norm” silently sets both harmonic periods to zero; it does not infer them.

03 · OPTIONAL QUANTIZATION

Change the harmonic state

subtract a lattice vector

Preserves divergence and vorticity, but changes cross-sectional flux. “Nearest” means minimum residual energy only after this lab imposes q, the basis dx,dy, and the flat metric.

Primary source: Hang Yin, Mohammad Sina Nabizadeh, Baichuan Wu, Stephanie Wang, and Albert Chern, Fluid Cohomology, ACM Transactions on Graphics 42(4), 2023. The integer lattice in this tutorial is an added mathematical experiment, not a claim made by the paper.