about summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-11-11 15:58:45 +0000
committerPjotr <wrk@bosa.lan>2026-11-11 15:58:45 +0000
commit64e63bd5e17a72dbb9c8b5eefd2a5662691f8159 (patch)
tree38e6da1a47f10967d98f7f16678cef9a1b00b449 /docs
parent69ff86d7c2125c34d4f8ccce09ed535b532377e2 (diff)
downloadgenenetwork4-64e63bd5e17a72dbb9c8b5eefd2a5662691f8159.tar.gz
docs: the two engines agree on heritability -- measured, not asserted
Once both engines' variance components were readable, BXD::10001 (34
animals) gives:

  BulkLMM, global null   h2 = 0.819  (sigma2_e 5.381)
  GEMMA, LOCO per chr    pve 0.3125-0.9558, median 0.8015, mean 0.7769

0.80 against 0.82. The engines never disagreed about the variance split;
they disagreed about which chromosome's kinship to hold the rest of the
genome out from. That closes the question this comparison started with.

Also says how to quote them: GEMMA's pve with its range because it is per
chromosome, BulkLMM's h2 as one number because it is global, and neither
set of p-values against the other.
Diffstat (limited to 'docs')
-rw-r--r--docs/bulklmm.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/bulklmm.md b/docs/bulklmm.md
index 61c1663..fc4266a 100644
--- a/docs/bulklmm.md
+++ b/docs/bulklmm.md
@@ -87,6 +87,18 @@ are estimating different things, and it is worth knowing which:
    under LOCO. On a boundary both optimisers clamp, and they clamp to different
    conventions.
 
+   Measured on **BXD::10001, 34 animals**, once both engines' variance
+   components were readable: BulkLMM's global null `h2` is **0.819**
+   (`σ²_e = 5.381`), and GEMMA's LOCO `pve` over the 20 chromosomes runs
+   **0.3125-0.9558**, median **0.8015**, mean 0.7769. So the two agree on the
+   variance split to within a couple of percent -- 0.80 against 0.82 -- which
+   is the answer this comparison was for: the engines were never in
+   disagreement about heritability, only about which chromosome's kinship to
+   hold the rest of the genome out from. Quote GEMMA's `pve` with its range
+   (it is per chromosome), BulkLMM's `h2` as one number (it is global), and do
+   not compare the p-values: `--loco` weights each chromosome differently, so
+   neither set is the other's null.
+
 **What would settle it, in order of cost:**
 
 * **GEMMA's own variance components — available, one flag away.** Tested on a