Eve library

phase-157.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Phase 157: Neith Mantaflow-Class Fluid / Smoke / Fire / Pyro / Particles Simulation — Blender Mantaflow / Houdini Pyro + FLIP + Whitewater / Maya Bifrost / RealFlow / TurbulenceFD / Phoenix FD Parity#

Closes the offline fluid/smoke/fire sovereignty gap. Phase 40.3.3 and Phase 42.2.7 ship Niagara Fluids-class real-time GPU fluids for games. Phase 112 covers classical fluid physics in Kalika. Neither delivers a production-grade DCC simulation framework with FLIP / APIC liquid, Eulerian pyro, combustion, whitewater, secondary particles, and domain-to-domain transfer that VFX and animation teams need for feature film.

Sovereign replacement for Blender Mantaflow (fluid, smoke, fire, particles), SideFX Houdini Pyro + FLIP + Whitewater + POP + Vellum (fluid portion), Autodesk Bifrost (Aero / Liquid), Autodesk Maya Fluids, Next Limit RealFlow / Dyverso, Jawset TurbulenceFD, Chaos Phoenix FD, EmberGen (for offline quality), Nomad Sculpt's FX add-ons, and XSI ICE fluids.


157.1 @neith/sim-core — Solver Core & Domain Model#

  • 157.1.1 Simulation domain object (adaptive grid or mesh)
  • 157.1.2 Sparse grid backend (OpenVDB / NanoVDB / sovereign)
  • 157.1.3 Adaptive-level-set representation
  • 157.1.4 Multi-resolution nested domain
  • 157.1.5 Narrow-band representation for liquid
  • 157.1.6 Cache directory + versioned naming
  • 157.1.7 Bake / simulate / resume / clear operators
  • 157.1.8 Cross-frame checkpoint
  • 157.1.9 Deterministic RNG per sim
  • 157.1.10 Per-frame .vdb + .bphys + .vdb sequence cache
  • 157.1.11 OpenVDB SPGrid IO compatibility
  • 157.1.12 Incremental bake (only changed frames)
  • 157.1.13 Scene-wide sim time step controller
  • 157.1.14 Substep adaptive (CFL-based)
  • 157.1.15 Farm-distribute bake (Phase 138 farm)

157.2 @neith/sim-liquid — FLIP / APIC / PIC Liquid Solver#

  • 157.2.1 Fluid Implicit Particle (FLIP) solver
  • 157.2.2 Affine Particle-In-Cell (APIC)
  • 157.2.3 PolyPIC / MLS-MPM option
  • 157.2.4 Position-based-fluids (PBF) quick preview
  • 157.2.5 Narrow-band FLIP for ocean / large volumes
  • 157.2.6 Pressure projection (multigrid / PCG)
  • 157.2.7 Viscous stress tensor solver
  • 157.2.8 Surface tension (CSF)
  • 157.2.9 Non-Newtonian (honey / paint) rheology
  • 157.2.10 Foam / spray / bubble / whitewater secondary
  • 157.2.11 Diffuse particle emission (curvature, vorticity, kinetic-energy)
  • 157.2.12 Adaptive particle density (seed / sink)
  • 157.2.13 Multi-fluid mixing (density / viscosity blend)
  • 157.2.14 Droplets / splashes / mist sub-solver
  • 157.2.15 Narrow-band + adaptive surface reconstruction

157.3 @neith/sim-gas — Eulerian Pyro / Gas Solver#

  • 157.3.1 MAC grid solver
  • 157.3.2 Semi-Lagrangian advection
  • 157.3.3 MacCormack / BFECC high-order advection
  • 157.3.4 Pressure-Poisson with deflated PCG
  • 157.3.5 Vorticity confinement
  • 157.3.6 Upres (macro + micro) simulation
  • 157.3.7 Combustion (fuel → flame → smoke) model
  • 157.3.8 Black-body emission shader
  • 157.3.9 Sooting model
  • 157.3.10 Heat / temperature scalar field
  • 157.3.11 Turbulence injection with noise field
  • 157.3.12 Dissipation / cooling curve
  • 157.3.13 Buoyancy force
  • 157.3.14 Wind fields with gradient
  • 157.3.15 Explosion preset library

157.4 @neith/sim-mpm — Material-Point Method (Snow / Sand / Goo)#

  • 157.4.1 MLS-MPM solver
  • 157.4.2 Elastoplastic material model
  • 157.4.3 Sand (Drucker-Prager) constitutive model
  • 157.4.4 Snow (Stomakhin) plasticity
  • 157.4.5 Cookie-dough viscoelastic
  • 157.4.6 Two-way MPM ↔ rigid body
  • 157.4.7 MPM ↔ liquid coupling
  • 157.4.8 Fracture criteria on MPM surface
  • 157.4.9 Grain-level render (mesh / sprite)
  • 157.4.10 Cross-domain contact resolution

157.5 @neith/sim-particles — Particle System (POPs)#

  • 157.5.1 Point particle primitive
  • 157.5.2 Emitter (point / surface / volume / curve)
  • 157.5.3 Force fields (gravity / wind / turbulence / noise / drag)
  • 157.5.4 Attraction / repulsion point forces
  • 157.5.5 Life / age / birth-frame per particle
  • 157.5.6 Collision with mesh (SDF / BVH)
  • 157.5.7 Inter-particle collision
  • 157.5.8 Flocking / boids rule-set
  • 157.5.9 Sprite / instance render per particle
  • 157.5.10 Per-particle attribute (size / velocity / id / colour)
  • 157.5.11 Particle → mesh surfacing (metaballs / marching cubes)
  • 157.5.12 Disintegration effect (mesh → particles)
  • 157.5.13 Granular crowd-seed particles
  • 157.5.14 GPU-accelerated solver <!-- real wgpu compute integrator (integrate.wgsl) behind the gpu feature; parity test vs CPU integrate_chunked passes on the on-box llvmpipe adapter; naga validates the WGSL in every build -->
  • 157.5.15 Spawn-from-simulation (inherit fluid velocity)

157.6 @neith/sim-cloth — Cloth & Soft-Body (DCC Quality)#

  • 157.6.1 XPBD cloth solver
  • 157.6.2 Bending constraints (Gauss-Seidel + dihedral)
  • 157.6.3 Tearing / ripping threshold
  • 157.6.4 Self-collision with signed-distance thickness
  • 157.6.5 Cloth-vs-body tight contact
  • 157.6.6 Air-drag / wind interaction with gas
  • 157.6.7 Stitch / seam model (garment authoring)
  • 157.6.8 Pressure / inflation (balloon / airbag)
  • 157.6.9 Finite element shell (for rubber / skin)
  • 157.6.10 Two-way rigid-body coupling
  • 157.6.11 Volume-preservation soft body
  • 157.6.12 Phase-resolved cloth cache
  • 157.6.13 Retime / warp cache
  • 157.6.14 Cache transfer to Phase 155 hair / Phase 44 garment
  • 157.6.15 Marvelous-Designer garment import

157.7 @neith/sim-rigid — Rigid / Constraint / Fracture#

  • 157.7.1 Rigid-body solver (sequential impulse / PBD)
  • 157.7.2 Constraint types (hinge / fixed / ball / slider / cone)
  • 157.7.3 Motor + spring constraints
  • 157.7.4 Pre-fracture tool (Voronoi / Boolean cells)
  • 157.7.5 Dynamic fracture during sim
  • 157.7.6 Cluster / glue constraint for packs
  • 157.7.7 Compound body hierarchy
  • 157.7.8 Stabilised island solver
  • 157.7.9 Rigid-fluid two-way coupling
  • 157.7.10 Destructible building library

157.8 @neith/sim-ocean — Ocean, Waves, Whitecaps#

  • 157.8.1 Gerstner + FFT ocean surface
  • 157.8.2 Beaufort wind scale presets
  • 157.8.3 Swell + chop + spectrum control
  • 157.8.4 Shore breaking (procedural + FLIP boundary)
  • 157.8.5 Foam / whitecap distribution
  • 157.8.6 Jacobian displacement map export
  • 157.8.7 Ocean tile tileable for vast scene
  • 157.8.8 Wake from mesh (boat / duck) into FFT ocean
  • 157.8.9 Caustic pattern generator
  • 157.8.10 Shallow-water coupling

157.9 @neith/sim-surface — Surface Reconstruction & Meshing#

  • 157.9.1 Anisotropic kernel surface (Yu–Turk)
  • 157.9.2 Marching-cubes / dual-contour
  • 157.9.3 Narrow-band mesh generation
  • 157.9.4 Smoothing + filter
  • 157.9.5 UV automatic generation
  • 157.9.6 Velocity-transfer to mesh for motion blur
  • 157.9.7 Mesh subdivision refinement
  • 157.9.8 Displacement from particle foam
  • 157.9.9 Mesh cache export (.bobj / .abc / .vdb / .usd)
  • 157.9.10 Retopology for hero shots

157.10 @neith/sim-forces — Force Field & Object Interaction#

  • 157.10.1 Obstacle (static / kinematic / deforming)
  • 157.10.2 Moving obstacle velocity transfer
  • 157.10.3 Collider SDF auto-generation
  • 157.10.4 Inflow / outflow objects
  • 157.10.5 Source temperature / velocity driver
  • 157.10.6 Negative source (sink) remover
  • 157.10.7 Guide fluid from low-res sim
  • 157.10.8 Channel-driven forces (keyframe)
  • 157.10.9 Procedural noise force
  • 157.10.10 Character-animated force (actor drives wind)

157.11 @neith/sim-render — Render & Shading Integration#

  • 157.11.1 Density / temperature / velocity VDB AOV
  • 157.11.2 Volume shader with absorption / scattering / emission
  • 157.11.3 Henyey-Greenstein phase function
  • 157.11.4 Multi-scattering approximation
  • 157.11.5 Black-body fire shader with physically-based temperature
  • 157.11.6 Light-linking per volume
  • 157.11.7 Render-ready LOD (low-res for preview)
  • 157.11.8 Denoiser for volumes (Phase 138 OIDN / OptiX)
  • 157.11.9 Motion blur from velocity field
  • 157.11.10 Viewport preview (Phase 154 EEVEE-class)

157.12 @neith/sim-games — Real-Time Baking for Game Runtime#

  • 157.12.1 Bake to flipbook (2D/3D texture)
  • 157.12.2 Bake to VAT (vertex animation texture)
  • 157.12.3 Bake to Alembic sequence
  • 157.12.4 Bake to GPU particle seed data
  • 157.12.5 Export to Neith Engine Phase 42 / Phase 161 Niagara-class
  • 157.12.6 Loop-friendly bake with phase-align
  • 157.12.7 Impostor card generation
  • 157.12.8 Tile-able fluid loop
  • 157.12.9 LOD chain per sim
  • 157.12.10 Runtime playback shader

157.13 @neith/sim-farm — Distributed Simulation#

  • 157.13.1 Frame-range splitter
  • 157.13.2 Spatial domain decomposition (MPI / NCCL)
  • 157.13.3 Multi-GPU scaling for grid solvers <!-- executable multi_gpu coordinator partitions grids, materialises exact halos, dispatches ranks concurrently, and assembles results; optional wgpu backend enumerates adapters through one selected compute API and runs the Jacobi stencil on one logical device/queue per adapter; CPU rank parity + on-box llvmpipe wgpu runtime parity pass. Physical multi-adapter throughput remains covered honestly by 157.14.10. -->
  • 157.13.4 Dependency scheduler (low-res guide → hi-res upres)
  • 157.13.5 Deadline-compatible farm submission (Phase 138 farm)
  • 157.13.6 Checkpoint retry on node failure
  • 157.13.7 Result-review proxy before final
  • 157.13.8 Cost estimator per sim
  • 157.13.9 Cache pinning / retention policy
  • 157.13.10 Metrics (kernel-time, grid-count, particle-count)

157.14 Testing & Validation#

  • 157.14.1 Dam-break benchmark vs analytic
  • 157.14.2 Rising-bubble benchmark
  • 157.14.3 Rayleigh-Taylor instability test
  • 157.14.4 Kelvin-Helmholtz instability test
  • 157.14.5 Pyro vs Houdini reference (qualitative corpus)
  • 157.14.6 Mantaflow .bobj round-trip
  • 157.14.7 OpenVDB SPGrid interop
  • 157.14.8 Cloth swing / flag benchmark
  • 157.14.9 MPM snow-ball vs Stomakhin reference
  • 157.14.10 Multi-GPU scaling efficiency ≥ 80 % blocked:gpu <!-- a measured median-sample release gate now rejects single-device evidence and calculates real speedup/efficiency; this host exposes one Virtio display device and only one llvmpipe wgpu compute adapter, so the >=80% multi-GPU measurement still requires external multi-GPU hardware --> Re-measured on the Linux dev server 2026-09-18, because a blocker tag is a claim like any other: nvidia-smi is not installed (command not found), lspci reports one display device — Red Hat, Inc. Virtio 1.0 GPU — and /dev/dri holds a single render node, renderD128. An efficiency figure across N devices cannot be produced on one paravirtual adapter, and the gate above is right to reject single-device evidence rather than report a speedup of 1.0 as a pass.