@woosh/meep-engine 3.69.0 → 3.70.0

package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.d.ts

@@ -1,21 +1,33 @@
 /**
  * The parent's identity read at a face of the child, one concrete function per component:
  * `fluid_parent_face_u(face, offset)`, `_v`, `_w`, `face` a window-local face of the child's lattice
- * for that component (u face `(i, j, k)` at cell coordinate `(i − ½, j, k)`).
+ * for that component (u face `(i, j, k)` at cell coordinate `(i − ½, j, k)`), and the deviation it adds
+ * to the far field, `fluid_parent_face_deviation_u(face, offset)`, `_v`, `_w`.
  *
  * Child u face `i` lies on parent u lattice coordinate `(i + offset)/2` along x and
- * `(j + offset − ½)/2` across it; likewise v along y and w along z. The tap's eight parent faces are
- * read as deviations, `v − parent.far_velocity`, and one beyond the parent's window as 0; the read is
- * `parent.read_far_velocity + parent.keep · trilinear(deviations)`.
+ * `(j + offset − ½)/2` across it; likewise v along y and w along z. In child-lattice cells counted
+ * from `parent.origin` the face is at `face + offset − (½, 0, 0)`, which is where both far fields,
+ * `parent.far` and `parent.read`, are laid.
  *
- * Binds `parent_u`, `parent_v`, `parent_w`: the parent's persistent faces, `texture_3d<f32>`
- * (`r32float`), toroidal through `parent.faces_*`. A far-field parent binds stand-ins it never reads.
+ * The deviation: the tap's eight parent faces are read less the parent's far field's mean,
+ * `v − parent.far.mean`, and one beyond the parent's window as the parent's far field's eddy at the
+ * face, `σ·T`; the trilinear of those, less that eddy, is the parent's deviation from its far field at
+ * the face, which the read keeps `parent.keep` of. A smooth far field differs from its trilinear over
+ * the parent's corners by a fraction of its curvature over a parent cell, which a tile of
+ * `FLUID_TURBULENCE_TEXELS_PER_LENGTH` texels a length scale keeps small; with no turbulence the
+ * eddy is 0 and the deviation is exact.
+ *
+ * The read: `v_far(t_read)` at the face, `parent.read`, plus the deviation.
  *
- * Reads 8 texels a call; beside the far field (a window of size 0) none, and it answers
- * `parent.read_far_velocity` before any window test. That early answer is measured: a lone 64×32×64
- * cascade's predict went from 56.3 to 27.6 µs and its correct from 84.0 to 44.0 on an RTX 4090
- * (pipelines swapped in one run, per-dispatch medians), the seams' empty-window tests and blend being
- * most of what a beyond-window read cost there.
+ * Binds `parent_u`, `parent_v`, `parent_w`: the parent's persistent faces, `texture_3d<f32>`
+ * (`r32float`), toroidal through `parent.faces_*`; and the turbulence tile
+ * (`fluid_turbulence_add_resources`). A far-field parent binds stand-ins it never reads.
+ *
+ * Reads 8 texels a call, and the tile once for each far field that has turbulence; beside the far
+ * field (a window of size 0) no texel, and the deviation answers 0 before any window test. That early
+ * answer is measured: a lone 64×32×64 cascade's predict went from 56.3 to 27.6 µs and its correct from
+ * 84.0 to 44.0 on an RTX 4090 (pipelines swapped in one run, per-dispatch medians), the seams'
+ * empty-window tests and blend being most of what a beyond-window read cost there.
  *
  * @type {CodeChunk}
  */

package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_fluid_cascade_parent.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,kDAFU,SAAS,CAmMjB;AAEF;;;;;;;;;;;;;;;GAeG;AACH,kDAFU,SAAS,CAkFjB;0BAzUwB,oCAAoC"}
+{"version":3,"file":"chunk_fluid_cascade_parent.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.js"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,kDAFU,SAAS,CAyNjB;AAEF;;;;;;;;;;;;;;;GAeG;AACH,kDAFU,SAAS,CAkFjB;0BA7WwB,oCAAoC"}