Skip to main content

    Interpreting oncology analytics outputs

    TMB values, MSI status, MHC binding predictions, and neoantigen rankings.

    oncologyoutputs

    Retired tools

    hrd_score, liquid_biopsy_ctdna and tumor_fraction_estimate are retired and can no longer be run, so their outputs are no longer produced. Use an allele-specific copy-number HRD caller such as scarHRD for HRD, ichorCNA on low-pass WGS for tumor fraction, and a dedicated ctDNA/MRD pipeline for ctDNA.

    These tools return TMB values and MSI status, MHC binding predictions, and ranked neoantigens against clinical thresholds — letting you assess checkpoint inhibitor eligibility and feed the readouts into therapy selection and trial matching.

    TMB/MSI Calculate output

    FieldTypeDescription
    tmbnumberTumor mutational burden (mutations per megabase)
    tmb_statusstring"high" (>= 10) or "low" (< 10)
    total_mutationsnumberTotal somatic mutations detected
    coding_mutationsnumberMutations in coding regions
    synonymous_countnumberSynonymous (silent) mutations
    nonsynonymous_countnumberNonsynonymous mutations
    panel_size_mbnumberEffective panel size used for TMB calculation
    msi_scorenumberPercentage of unstable microsatellite sites
    msi_statusstring"MSS", "MSI-L", or "MSI-H"
    unstable_sitesnumberNumber of unstable microsatellite loci
    total_sites_evaluatednumberTotal microsatellite loci assessed
    mutation_spectrumobjectCounts of each mutation type (C>A, C>G, C>T, T>A, T>C, T>G)

    TMB interpretation by tumor type

    Tumor TypeMedian TMB (mut/Mb)TMB-High Threshold
    Melanoma13.5≥ 10
    NSCLC7.2≥ 10
    Colorectal (MSS)3.8≥ 10
    Colorectal (MSI-H)45.2≥ 10
    Breast2.6≥ 10
    Pancreatic1.7≥ 10

    MSI status interpretation

    StatusUnstable SitesClinical Implication
    MSI-H≥ 30%Checkpoint inhibitor eligible (pembrolizumab)
    MSI-L10-30%Not considered MSI-H; standard treatment
    MSS< 10%Microsatellite stable; standard treatment

    MHC Binding Predict output

    FieldTypeDescription
    predictionsarrayBinding predictions for each peptide-allele pair
    total_predictionsnumberNumber of peptide-allele combinations evaluated
    strong_bindersnumberPredictions with IC50 < 50 nM
    weak_bindersnumberPredictions with IC50 50-500 nM
    methodstringPrediction method used

    Prediction fields

    FieldTypeDescription
    peptidestringInput peptide sequence
    hla_allelestringHLA allele evaluated
    ic50_nmnumberPredicted binding affinity in nanomolar
    percentile_ranknumberPercentile rank (lower = stronger binding)
    classificationstring"strong_binder", "weak_binder", or "non_binder"
    core_peptidestringPredicted binding core (for class II)

    Binding affinity interpretation

    IC50 (nM)Percentile RankClassificationImmunological Relevance
    < 50< 0.5%Strong binderHigh likelihood of immune recognition
    50-5000.5-2%Weak binderPossible immune recognition
    500-50002-10%MarginalUnlikely to elicit response
    > 5000> 10%Non-binderNo binding expected

    Neoantigen Predict output

    FieldTypeDescription
    neoantigensarrayRanked neoantigen candidates
    total_candidatesnumberTotal neoantigens passing filters
    strong_candidatesnumberCandidates with IC50 < 50 nM
    mutations_processednumberInput mutations evaluated
    peptides_generatednumberTotal peptides generated from mutations

    Neoantigen candidate fields

    FieldTypeDescription
    rankintegerOverall ranking (1 = best candidate)
    genestringMutated gene symbol
    mutationstringProtein-level mutation (e.g., G12D)
    mutant_peptidestringNeoantigen peptide sequence
    wildtype_peptidestringCorresponding wildtype peptide
    hla_allelestringBest-binding HLA allele
    mutant_ic50numberMutant peptide binding affinity (nM)
    wildtype_ic50numberWildtype peptide binding affinity (nM)
    agretopicitynumberRatio of wildtype to mutant IC50 (higher = more tumor-specific)
    expression_tpmnumberGene expression level (TPM, if provided)
    clonalitystring"clonal" or "subclonal" (if available)
    composite_scorenumberWeighted ranking score (0-1)

    Neoantigen prioritization

    PriorityCriteria
    Tier 1IC50 < 50 nM, expression > 10 TPM, clonal, agretopicity > 10
    Tier 2IC50 < 50 nM, expression > 1 TPM, any clonality
    Tier 3IC50 < 500 nM, expression > 1 TPM
    Tier 4IC50 < 500 nM, no expression data

    Was this page helpful?

    On this page

    On this page

    Loading...