MHC binding predictors¶
Vaxrank runs MHC binding predictors through
MHCtools. Select one with
--mhc-predictor <name>. Names marked "requires local install" need the
vendor's own executable on your PATH. The historical IEDB names also run
local tools; they do not call a web API or fall back to HTTP.
MHCflurry also needs model weights (mhcflurry-downloads fetch). Check the
MHCtools predictor guide for model
installation and allele/length support.
--mhc-predictor |
Tool | MHC Class | Notes |
|---|---|---|---|
mhcflurry |
MHCflurry | I | Open-source neural network; Python package installed with MHCtools; fetch model weights separately |
bigmhc |
BigMHC | I | Auto-detects EL or IM model |
bigmhc-el |
BigMHC EL | I | Presentation (eluted ligand) model |
bigmhc-im |
BigMHC IM | I | Immunogenicity model |
pepsickle |
Pepsickle | -- | Proteasomal cleavage predictor |
netmhc |
NetMHC | I | Auto-detects NetMHC3 or NetMHC4 |
netmhc3 |
NetMHC 3.x | I | Requires local install |
netmhc4 |
NetMHC 4.0 | I | Requires local install |
netmhcpan |
NetMHCpan | I | Auto-detects installed version |
netmhcpan28 |
NetMHCpan 2.8 | I | Requires local install |
netmhcpan3 |
NetMHCpan 3.x | I | Requires local install |
netmhcpan4 |
NetMHCpan 4.0 | I | Default mode (EL + BA) |
netmhcpan4-ba |
NetMHCpan 4.0 | I | Binding affinity mode only |
netmhcpan4-el |
NetMHCpan 4.0 | I | Eluted ligand mode only |
netmhcpan41 |
NetMHCpan 4.1 | I | Default mode (EL + BA) |
netmhcpan41-ba |
NetMHCpan 4.1 | I | Binding affinity mode only |
netmhcpan41-el |
NetMHCpan 4.1 | I | Eluted ligand mode only |
netmhcpan42 |
NetMHCpan 4.2 | I | Default mode (EL + BA) |
netmhcpan42-ba |
NetMHCpan 4.2 | I | Binding affinity mode only |
netmhcpan42-el |
NetMHCpan 4.2 | I | Eluted ligand mode only |
netmhccons |
NetMHCcons | I | Requires local install |
netmhcstabpan |
NetMHCstabpan | I | Stability predictor; requires local install |
netchop |
NetChop | -- | Proteasomal cleavage predictor |
netmhciipan |
NetMHCIIpan | II | Auto-detects installed version |
netmhciipan3 |
NetMHCIIpan 3.x | II | Requires local install |
netmhciipan4 |
NetMHCIIpan 4.0 | II | Default mode (EL + BA) |
netmhciipan4-ba |
NetMHCIIpan 4.0 | II | Binding affinity mode only |
netmhciipan4-el |
NetMHCIIpan 4.0 | II | Eluted ligand mode only |
netmhciipan43 |
NetMHCIIpan 4.3 | II | Default mode (EL + BA) |
netmhciipan43-ba |
NetMHCIIpan 4.3 | II | Binding affinity mode only |
netmhciipan43-el |
NetMHCIIpan 4.3 | II | Eluted ligand mode only |
mixmhcpred |
MixMHCpred | I | Requires local install |
netmhcpan-iedb |
NetMHCpan compatibility wrapper | I | Requires local NetMHCpan 4.1 BA |
netmhccons-iedb |
NetMHCcons compatibility wrapper | I | Requires local NetMHCcons |
netmhciipan-iedb |
NetMHCIIpan compatibility wrapper | II | Requires local NetMHCIIpan 4.3 BA |
smm-iedb |
SMM compatibility wrapper | I | Requires local SMM |
smm-pmbec-iedb |
SMM-PMBEC compatibility wrapper | I | Requires local SMM-PMBEC |
random |
Random | -- | Returns random scores; for testing only |
Optional Weirdo category scores¶
Topiary 5.95 supports the released Weirdo model through
pip install 'topiary[weirdo]>=5.95,<6'. Its foreignness predictions are
allele-independent and retain their exact model/artifact version and score
policy through Topiary tables, native CandidateEpitope records, and saved
Vaxrank datasets. Imported matched-comparator rows also retain their own
measurement context.
For a dataset that already contains Weirdo predictions, opt into the score
with epitopes.score_expr=peptide_view(foreignness[weirdo].score). Ordinary
binding-based scoring is unchanged when these observations are merely present.
Keep the complete predictor_version and measurement_context columns when
transporting the table; native dataset save/load preserves them automatically.
The released policy is human-self-complement-v1: one minus the model's
human-category output. It accepts canonical 8–11-residue peptides and only a
human reference host (taxon 9606). Do not apply this policy as a mouse/B16
self reference; a rodent training category is not a mouse-specific model.
This is an experimental category score, with no confirmed immune-response
ranking benefit. It is not a self-safety verdict or a substitute for binding,
presentation, or self-proteome evidence. It is also distinct from the published
IEDB similarity feature used by tesla-recognition-v1.
Effective prediction stages¶
The normal text/HTML/PDF reports and run_summary.txt include the effective
prediction configuration. Native output embeds the same record under
run_configuration.effective_predictions; it includes actual model/version
identities, endpoints, recorded alleles and peptide lengths, context, cache
behavior, coverage and whether each stage executed, skipped or replayed evidence.
Unknown historical versions and unrecorded coverage remain explicit.
Candidate and junction inference both use Topiary's public prediction contract.
Candidate selection uses epitopes.selection_policy, or the legacy controls
translated to the displayed Topiary DSL expression. See
selection policies. The separate RNA support, vaccine
window ranking and construct assembly settings continue to apply afterward.
Junction optimization selects one percentile-rank endpoint:
vaxrank ... --mrna-junction-predictor netmhcpan42 \
--mrna-junction-rank-kind pMHC_presentation \
--mrna-junction-rank-strong 0.5 --mrna-junction-rank-mild 2.0
The API counterpart is RNAConstructConfig(junction_rank_kind=...);
YAML uses mrna.junction_rank_kind. auto preserves the historical preference:
use affinity when the model declares it, otherwise presentation. It never pools
endpoints. Every requested peptide/allele needs a finite percentile rank from
one model/version. Missing coverage now fails; it cannot win as zero burden.
The thresholds count ranks at or below their values. They are configurable
selection heuristics, not calibrated probabilities of an immune response.
NetMHCpan's BA and EL ranks describe different trained endpoints
(DTU output documentation).
Processing annotation still uses mhctools' source-sequence Pepsickle interface,
which supplies the cleavage profile needed for occurrence-specific annotation.
It has no allele axis and does not change ranking. Its geometric-mean summary
is displayed explicitly and is not a calibrated presentation probability.
Native output retains the source sequence, offset, model/version and boundary
status for each annotation. Replay restores those records without inference;
--processing-aware-annotation explicitly requests a new annotation pass.
A sequence endpoint keeps its missing C-boundary score.
Configured candidate and junction models are described through Topiary's public
describe_prediction_models API. The report keeps this configuration separate
from identities observed in prediction rows: configuring a model is not proof
that it returned complete coverage. Older native files without that inventory
continue to report only the evidence they actually retained.
External/native replay runs no candidate or junction inference implicitly. Select fresh/additive candidate inference or an explicit junction model to request it. Direct VCF/BAM runs may reuse their single candidate model for junctions; multiple candidate models require an explicit junction choice.