Skip to content

docs: the GPU balance notes describe 3D face + edge balance - #70

Merged
nikbott merged 1 commit into
devfrom
docs/balance-notes
Oct 5, 2026
Merged

nikbott merged 1 commit into
devfrom
docs/balance-notes

Conversation

@nikbott

@nikbott nikbott commented Oct 1, 2026

Copy link
Copy Markdown
Owner

From the 2026-10-01 adversarial review (finding C6). docs/design/gpu-balance-notes.md said "Our balance_ref/balance enforce face balance, so N(o) = the 2·d face-neighbours of parent(o)", and repeated it in four places. The code enforces face and edge balance in 3D: cuda/tree.cuh uses 6 face + 12 edge directions, as the README's invariant says.

That matters for the preclusion balancer the notes plan. A face-only coarse neighbourhood would not be byte-identical to balance_ref on 3D fixtures. The notes now say 4 directions in 2D, 18 in 3D, and "≤ 4 or 18 outputs/leaf". Docs only.

🤖 Generated with Claude Code

https://claude.ai/code/session_0173Mq5KeHKB8Ye9XBospZ88

The notes said balance_ref and balance enforce face balance, with
2d face neighbours per leaf; in 3D both enforce face and edge balance
(18 directions), as the README's invariant states.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173Mq5KeHKB8Ye9XBospZ88
@nikbott
nikbott force-pushed the docs/balance-notes branch from 791e7fe to 6d30edd Compare October 5, 2026 23:11
@nikbott
nikbott merged commit e12be6c into dev Oct 5, 2026
12 checks passed
@nikbott
nikbott deleted the docs/balance-notes branch October 5, 2026 23:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant