Skip to content

doc: present the Kolmogorov setup on the results pages - #275

Closed
dionhaefner wants to merge 3 commits into
docs/warm-redesignfrom
doc/kolmogorov-results
Closed

dionhaefner wants to merge 3 commits into
docs/warm-redesignfrom
doc/kolmogorov-results

Conversation

@dionhaefner

@dionhaefner dionhaefner commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Relevant issue or PR

Stacked on #203 (docs redesign), into which it merges. It presents the experiments added in #272 and #315. Until those are merged it changes nothing visible, because a setup without results is left off the scoreboard.

Description of changes

  • Scoreboard: a new ns-grid setup, Forced periodic box (Kolmogorov flow).
    • It claims forward/kolmogorov_laminar, forward/kolmogorov and gradient/chain_fd_check, so they don't fall into the periodic setup.
    • Its forward gates are the two forward checks, and its gradient gate is the chained check. It has no optimization task.
  • Protocol (index.qmd): forward accuracy now names the Kolmogorov flow. It says the turbulent case is chaotic, so a solver must converge towards the reference on a ladder of grids at observed order 0.8 or more, instead of meeting a fixed error bound. A new paragraph under gradient accuracy explains the chained check. Training through a solver passes each call a tiny cotangent, and the check catches VJPs that are only accurate for large ones.
  • Results page: readable titles for the three experiments. The rest of that section comes from the experiments themselves: their plot descriptions and plots.

Testing done

  • tests/test_docs_generate.py passes.
  • The pages were generated from a local A100 run of the earlier version of this branch, which presented the solver-in-the-loop check. They have not been regenerated since the chained check replaced it.

@PasteurBot

PasteurBot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

📊 View the full benchmark results

The rendered docs preview has every plot for this run (forward accuracy, gradients, cost, optimization) merged with existing baseline results on main. The summary below reports pass/fail status.


Mosaic status

Benchmarks: not applicable (no mosaic/ changes).

…p training

The Kolmogorov setup now gates its gradient check on
gradient/chain_fd_check and has no optimization task. The protocol
describes the chained check under gradient accuracy and the Kolmogorov
reference and convergence gate under forward accuracy.
@dionhaefner

Copy link
Copy Markdown
Contributor Author

Closing to keep the Kolmogorov work in one PR (#272). Its three-file change (scoreboard setup, protocol paragraphs, result titles) stays on doc/kolmogorov-results and gets added to #272 once #203 lands, since the scoreboard only exists there.

@pasteurlabs pasteurlabs locked and limited conversation to collaborators Oct 30, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants