Repository navigation
SimPlex v2d: recalibration knobs and princeps 2026 profiles - #21
Merged
Merged
Conversation
All new settings default to off; v2c output is unchanged. - routing: negative binomial reads per molecule (reads_per_molecule_dispersion), separate light depth (reads_per_molecule_mean_light), UMI substitution errors - molecules: non-Ig junk molecules (junk_rate, junk_length) - reads: barcode/TSO substitution errors, TSO indels, TSO G-run length distribution - cells: input_filter, clonal sampling of real lineages (sample_clone_alpha, clone_id carried into truth), constant-region prefix (_constant.py, heavy_isotype_mix) - truth: exclude junk molecules from resident components - fidelity.py: contig fidelity against truth and clonal-sibling over-collapse - profiles: PRINCEPS_2026_FAMILY (memory/naive x P10/P50/P90) and PRINCEPS_2026_FULL_MEMORY_P50 - tests for the new knobs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New SimPlex generator settings and profiles, calibrated to 23 princeps 2026 reactions. Every new setting defaults to off, so v2c output is unchanged.
Generator settings
reads_per_molecule_dispersiondraws reads per molecule from a negative binomial (PCR jackpots).reads_per_molecule_mean_lightsets light-chain depth separately.umi_sub_rateadds UMI errors.junk_rateandjunk_lengthadd non-Ig library molecules with valid barcodes.barcode_sub_rate,tso_sub_rate,tso_indel_rateandtso_g_run_probsadd barcode and TSO errors.constant_regionandheavy_isotype_mixadd a constant-region prefix up to the primer (simplex/_constant.py).input_filterselects one donor and kind per reaction.sample_clone_alphasamples real clonal lineages, andclone_idis carried into the truth tables.truth.pyexcludes junk molecules from the resident components.New module
simplex/fidelity.py. It scores contig sequences against the truth: exact share and edits per 100 nt. It also measures whether clonal siblings in the same well and barcode are kept apart or merged into one contig. It is separate from the frozen pairing scorer.Profiles
PRINCEPS_2026_FAMILY: memory and naive, each at P10, P50 and P90 of Ig UMIs per barcode.PRINCEPS_2026_FULL_MEMORY_P50: memory median with all the settings above.The report, calibration targets and scripts are in
~/work/PairPlex/diagnosis/simplex_v2d/(SIMPLEX_V2D.md).Known limitation
Pairing precision is not yet calibrated. The simulation's precision is several times higher than a model-free estimate on real data. Don't use these profiles to choose between per-well and pooled pairing, or to set confidence thresholds, until that is resolved.
Tests
New knob tests are in
simplex/tests/test_v2_knobs.py. The full SimPlex suite passed (91 tests) on the branch base, before main moved to its current head. The branch merges cleanly with current main, which has nosimplex/changes since.🤖 Generated with Claude Code