balrox
Pure-Rust learned bacterial gene / ORF quality scorer. A dilated temporal convolutional network reads a candidate ORF's amino-acid sequence and returns P(real protein-coding gene) — used to rerank / filter spurious ORF calls. Self-contained, database-free, no ML runtime, no Python at inference time.
let m = embedded;
let s = m.score; // 0.0..=1.0
CLI:
balrox orfs.faa
#id score
orf1 0.996561
Role
Inside a gene-annotation pipeline (e.g. bactars), balrox is an additive reranker over a faithful gene caller (Prodigal / rustygal): the caller still finds ORFs, and balrox scores them so borderline / shadow / spurious calls can be down-ranked or filtered. It does not replace the gene caller.
Model & provenance
A dilated temporal CNN: Embedding(21→C) → 4 × [DilatedConv1d(k=7, dilation∈{1,2,4,8}) → ReLU] → masked global-average pool → Linear(C,1) → sigmoid. Architecture inspired
by Balrog (Sommer & Salzberg 2021), but this is an independent clean-room implementation
with its own code and its own weights, trained from scratch on public RefSeq/GenBank
bacterial CDS (positives) versus frame-shift-simulated and shadow ORFs (negatives). No
Balrog source code or trained weights were used.
Weights are embedded in the crate (weights.json); inference is pure-Rust (embedding
lookup, dilated conv1d, ReLU, masked pool, linear head) and was verified to match the
reference PyTorch model to 6 decimal places.
Note: held-out discrimination is very high against the synthetic negative set; the operating threshold should be calibrated on real genomes (real-vs-shadow ORFs) before use as a hard filter.
Changelog
0.1.1
- Performance: rewrote the dilated
conv1dkernel (branch-free contiguous AXPY inner loop + flattened weight layout). Multiple× faster single-thread; bit-identical output (same floating-point accumulation order — verified byte-for-byte on a full proteome).
0.1.0
- Initial release: distilled/trained pure-Rust model, gzip-embedded weights, PyTorch-parity verified.
License
MIT OR Apache-2.0. Training data derived from NCBI RefSeq/GenBank (public domain) and UniProt (CC-BY 4.0).