SirStone/SirRoboGarage
1
0
Fork 0
Code Issues 28 Pull Requests Actions Projects Releases Wiki Activity

bitbrain gun README: the gain warning was wrong and contradicted its own verdict section (it recommended the direction measured decisively harmful)

Browse Source
This commit is contained in:
Davide Cappellini
2026-09-26 14:48:23 +02:00
parent 7516ca47c0
commit 36c4334487
1 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
common_libs/guns/bitbrain_gun.README.md
+7 -2
View File
@@ -79,12 +79,17 @@ Default is **off**; the shipped rack never calls it. Minimal `.env`:
``` ```
TR_RACK_BITBRAIN=both TR_RACK_BITBRAIN=both
TR_RACK_PATTERN=off TR_RACK_PATTERN=off
TR_BITBRAIN_GAINS=1.0,1.25,1.5,2.0 TR_BITBRAIN_GAINS=1.0 # 1.0 = identity = aims EXACTLY like Pattern
TR_BITBRAIN_MEM=decay TR_BITBRAIN_MEM=decay
TR_BITBRAIN_LOG=1 TR_BITBRAIN_LOG=1
``` ```
⚠️ **Warning:** the **default** candidate set `{0, 0.25, 0.5, 0.75, 1.0}` can only reach 1.0 — it can only **shrink** the lead (toward HeadOn), which was measured **harmful** at long range. The useful set is the one that allows gains **above 1.0**: `1.0,1.25,1.5,2.0`. ⚠️ **`TR_BITBRAIN_GAINS=1.0` is the identity** — with one candidate at 1.0 the gun aims **exactly like Pattern**.
**Do not read the candidate list as a recommendation.** Measured live: fixed gains **above** 1.0 are
*decisively harmful* (1.5 → −93.8 dmg/run, p=0.0006; 1.25 → −34.2 dmg/run), a learner restricted to **≤ 1.0**
is a **wash** (−2.5 dmg/run, p=0.87), and zero lead (= HeadOn) is **catastrophic** (14 vs 279 dmg/run).
So the default set `{0, 0.25, 0.5, 0.75, 1.0}` is **not** a recommendation either — it merely *allows* the gun
to shrink the lead toward HeadOn. Multi-candidate lists are for running the experiment, not for playing.
## MEASURED VERDICT ## MEASURED VERDICT