about summary refs log tree commit diff
path: root/test/python/test_dev_token.py
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-11-11 12:52:36 +0000
committerPjotr <wrk@bosa.lan>2026-11-11 12:52:36 +0000
commitc9db07f6d372b0b8812e5f6698257a9df94dc1ef (patch)
tree98b8e918ff8d7e2d6e97773bc6326fb4f7513721 /test/python/test_dev_token.py
parente616b84fc86b176a20170a61ad205979af8bffc1 (diff)
downloadgenenetwork4-c9db07f6d372b0b8812e5f6698257a9df94dc1ef.tar.gz
docs: what BulkLMM models, what its cores do, and how to package it
docs/bulklmm.md records the three things that are easy to get wrong when a
BulkLMM result is quoted:

  * where it stands against the other engines -- Haley-Knott with no
    kinship (R/qtl), LOCO LMM whose permutations are refused (GEMMA),
    LOCO LMM on HMM probabilities (R/qtl2), and this: a global-kinship
    LMM whose permutation thresholds are rotation-based and therefore
    cheap -- the only engine here that can say "genome-wide significant
    at alpha 0.05" against a null that respects relatedness;
  * what it is not: global kinship rather than LOCO, so its p-values are
    not GEMMA's; h2_null says how much relatedness it found (near zero
    here, which is why it reproduces R/qtl's 9.59 where GEMMA differs);
    one degree of freedom, so multiparent scans stay with /compute/qtl2;
    and no standard errors in 1.2.2's scan(), so the rows are
    marker, chr, pos, lod, beta, h2;
  * the cores, measured: Threads.@threads is in bulkscan.jl and
    bulkscan_helpers.jl, never in scan.jl, so a single-trait scan is
    serial by design and the visible parallelism was BLAS (96 threads
    10.5 s against 4 threads 7.7 s). What the driver does about it --
    exact marker blocks, cached matrix and kinship, capped BLAS, and the
    breakdown printed into the reply -- with the numbers (20.9 s at one
    block against 18.3 s at four, same LOD 9.589938).

Also the packaging picture, since it is not obvious from the outside:
guix-bioinformatics has a working julia-bin and a julia-build-system, but
only three of BulkLMM's closure are packaged, so a pure-Guix build is
35-45 recipes; the pragmatic route is julia-bin plus a depot built once
from the pinned Manifest. scripts/prepare-julia-depot.sh is that step,
written down, and the depot stays small and GPU-free (79 packages,
139 MB) with JULIA_PKG_OFFLINE=true at request time.

The plot test learns that both thresholds are drawn, not one.
Diffstat (limited to 'test/python/test_dev_token.py')
0 files changed, 0 insertions, 0 deletions