SanntiS detects biosynthetic gene clusters (BGCs) in prokaryotic and eukaryotic sequences from InterProScan domain annotations, assigns a MIBiG class and predicts NPClassifier pathways and superclasses of the products. This repository holds one model bundle: a 3-seed Conv1D + BiLSTM token detector, a RandomForest post-filter / MIBiG class head and an NPClassifier ensemble (RandomForest + logistic regression + kNN).
sanntis setup --container-engine docker # InterProScan 6 + InterPro data, once
sanntis predict genome.fna --container-engine docker --model <this repo>@<revision>
sanntis predict assembly.gbk --ips-tsv interproscan.tsv # precomputed annotations, no containers
from sanntis import SanntisModel, Predictor
model = SanntisModel.from_pretrained('<this repo>', revision='<revision>')
Inputs: prokaryotic nucleotide FASTA (genes called with pyrodigal), GenBank with CDS translations or a protein FASTA with the GFF3 of its CDS (prokaryotes and eukaryotes), each optionally with a precomputed InterProScan 5.76+ / 6.x TSV. Outputs: GFF3 (one CLUSTER feature per region with bgc_class, p_non_bgc, npc_pathway, npc_superclass, npc_pathway_key_domains_unsupported, ...), per-CDS scores, a regions table and antiSMASH sideloader JSON.
| Field | Value |
|---|---|
| sanntis version | 1.2.0 |
| Fit | production |
| Features | InterProScan 6.0.3.0, InterPro 107.0; 14 member databases (pfam, ncbifam, sfld, superfamily, gene3d, hamap, coils, cdd, prints, pirsf, prositeprofiles, prositepatterns, mobidblite, smart) |
| Vocabulary | 6663 tokens (incl. 3 specials) |
| Detector | 3 seeds, 6 epochs (median best CV epoch) |
| Operating point t* | 0.2 (hysteresis low 0.15); set in the training recipe (BGC precision >= 0.80 on validation: not met) |
| Decode | mean token score per CDS; CDS without InterPro hits take the lower score of their annotated neighbours; regions are not merged across gaps |
| RF post-filter | drop regions with P(non-BGC) >= 0.8 |
| Heads | MIBiG class: True; NPClassifier: True |
Metrics in ORF space. Validation = pooled out-of-fold CV predictions (training data).
| Dataset | Precision_T | Recall_macro_T | F1_macro_T | BGC precision | BGC macro recall | F2_macro |
|---|---|---|---|---|---|---|
| Validation (CV, pooled OOF) | 0.490 | 0.876 | 0.628 | 0.706 | 0.929 | 0.874 |
Full report with confidence intervals and figures: report/report.md.
p_non_bgc and the NPClassifier scores are model scores, not calibrated probabilities (the NPC abstention tiers target 0.9 / 0.8 precision on validation).npc_pathway_key_domains_unsupported is a hint, not a verdict: a called pathway none of whose key domains (or domain pairs) is in the region is wrong more often than a supported one, but most wrong calls do carry the domains (hybrids, tailoring); pathways with low rule coverage in CV are na.Every file is listed with its sha256 in manifest.json and verified on load. No pickles: detectors are safetensors, sklearn models skops (explicit trusted types), the kNN reference a sparse npz.
The model files are released under Apache-2.0. They hold learned parameters, a vocabulary of InterPro signatures and NPClassifier class names and, in npc_knn.npz, the kNN reference: one binary domain-presence vector and the NPClassifier labels per training BGC (derived from MIBiG; no sequences). The training data come from the sources below and are published with their licences in sanntis-training-data (CC BY 4.0; negatives/ CC BY-SA 4.0).
This work is part of EUREMAP (European Research Infrastructure for Marine Bioprospecting, https://euremap.eu), funded by the European Union's Horizon Europe research and innovation programme under grant agreement No 101131663 (doi:10.3030/101131663). Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union. Neither the European Union nor the granting authority can be held responsible for them.
@article{sanchez2023sanntis,
title = {Expansion of novel biosynthetic gene clusters from diverse environments using SanntiS},
author = {Sanchez, Santiago and Rogers, Joel D. and Rogers, Alexander B. and Nassar, Maaly and McEntyre, Johanna
and Welch, Martin and Hollfelder, Florian and Finn, Robert D.},
journal = {bioRxiv},
year = {2023},
doi = {10.1101/2023.05.23.540769}
}
detector-seed0.safetensors 2 MBdetector-seed1.safetensors 2 MBdetector-seed2.safetensors 2 MBnpc_knn.npz 496.3 kB