about summary refs log tree commit diff
path: root/test/python/test_envelope.py
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-11-10 12:19:05 +0000
committerPjotr <wrk@bosa.lan>2026-11-10 12:19:05 +0000
commite0bbc56324cc7a6bd563f0dadd7163a93b8b4ad8 (patch)
tree6e1fb728c0e149c0baf3f0caddd0b829b4454f0b /test/python/test_envelope.py
parent8f4a9512d7fb4ac518341f23a4b062ccf80e2a7d (diff)
downloadgenenetwork4-e0bbc56324cc7a6bd563f0dadd7163a93b8b4ad8.tar.gz
genotypes: call frequencies, marker names, and a location per marker
Two questions the genotype surface could not answer: what a panel is
actually called as, and which markers it holds. The listing gives counts
and the compute endpoints give scans; a panel whose calls are not the
codes its header declares, or a marker that is 99% missing, stayed
invisible until a scan came back flat -- and then the search for the
cause started at the wrong end.

  * GET /groups/{group}/genotypes/{version}/frequencies counts the calls
    in the version's .geno and returns them as call -> frequency
    ({"B": 0.4889, "D": 0.492109, "H": 0.018991}). Frequencies are over
    the calls that are present, so they sum to 1; missing codes (U, N,
    NA, an empty cell) are counted separately and reported in notes,
    because the missing rate is the diagnosis.
  * A probability-valued file is binned 0.05 wide (twenty bins over
    [0, 1], keys are the bin edges), since 0.4187 and 0.4191 are the same
    statement about a marker; ?bin= sets another width. A file with a few
    distinct numbers (0, 0.5, 1 for a biallelic dosage) is reported
    exactly -- binning three values hides what is being looked at.
  * .../markers/{marker}/frequencies is one locus, and ?marker= on the
    panel route is the same call. Counting goes through an interner, so
    cost is one hash lookup per cell and one allocation per distinct
    call; a .geno over 256 MB is refused (413 genotype_too_large) rather
    than read, which is what HSNIH-Palmer_true (3.7 GB, 134927 markers x
    6147 individuals) demanded.
  * The version's /markers now lists marker NAMES only, one column, and
    .../markers/{marker}/location returns {"name","chr","cM","Mb"} as
    named fields: a page of names stays small, and a position is a
    lookup rather than a table the client must hold. The same size guard
    applies, so an oversized panel's listing is a 413 in 3 ms.
  * Files no group lists -- a panel in preparation, a fixture, the DO's
    do/ cross -- live at /groups/unlisted/genotypes/{name}/... with the
    same four calls. `unlisted` is a namespace, not a group: only its
    genotype subtree answers. One prefix for the whole genotype surface
    beats a second spelling for the same tally, so the earlier
    /genotypes/{name} spelling is gone.
  * genotypes::resolve_named (moved out of the frequencies module, since
    it is genotype metadata) resolves a version, a .geno name, or a path
    relative to the genotype files directory; MAX_SCAN_BYTES is shared by
    every whole-file read.

Tests limited to the feature: genotypes 3 (names-only columns, paging,
location fields, marker_not_found, unlisted parity, 413), frequencies 5,
frequencies unit 7.
Diffstat (limited to 'test/python/test_envelope.py')
0 files changed, 0 insertions, 0 deletions