Repository navigation
irit 0.5.0
New in irit-mcp: assembly_stats, coverm_genome (depth by read mapping), kleborate and rasusa
(subsampling), and a warning for Flye contigs that hold a small plasmid several times. dblock
downloads in parallel (fetch --jobs), and msascope reads gzip faster. Fixes from a second AI-agent
paper redo (Amena et al. 2026, E. coli and Salmonella Kentucky, MRA e01429-25) and from three
more nanopore isolates.
irit-mcp
assembly_stats: QUAST-style assembly statistics (contigs, total length, largest contig, N50,
L50, N90, L90, GC, Ns per 100 kbp, contigs >= 1 kb; contigs of 500 bp or more, QUAST's default),
computed by isotable and recorded like any call.coverm_genome(CoverM 0.8.0): an isolate's depth by read mapping, and the fraction of the
assembly covered. Warns when Shovill's depth estimate differs by more than 1.5×.kleborate(Kleborate 3.2.4): Klebsiella typing (ST, virulence and resistance scores,
ybt/clb/iuc/iro/rmpADC, K/O loci with Kaptive's confidence). Its bundled databases are hashed into
the record; warns about assemblies with no row or outside the KpSC.rasusa(Rasusa 5.1.0): subsample reads to a depth, number of bases, reads or a fraction, seed
1 by default (byte-identical output, so replayed and compared). Flye's description and guide now
say thatasm_coverageonly limits its first stage: a 5.7 Mb K. pneumoniae at about 450x went
over 8 GB in Flye's consensus stage, so deep long reads are subsampled first.- Outputs isotable won't read are allowed: mlst, AMRFinderPlus and CoverM genome outputs not
named<sample>.<tool>.tsvnow run with a warning instead of being refused, for side analyses
that shouldn't join the table (found by the second paper redo). - Flye: plasmids closed as several copies are flagged. A circular contig up to 300 kb with more
than half of its 21-mers repeated gets a warning (and the copy count when it is a clean
multiple): AF38's 6,141 bp blaOXA-232 plasmid came out as three copies in an 18,377 bp circle,
so AMRFinderPlus listed the gene three times. Flye's description mentionsmetafor small
plasmids. - A tool whose bundled data (mlst's schemes, Kleborate's databases) can't be found now gets a
warning that the record identifies it by version only.
isotable
isotable assembly-stats, and largest contig, L50, N90, Ns per 100 kbp, contigs >= 1 kb and
all contigs as table columns (from assemblies and QUAST reports).- Reads CoverM genome and Kleborate 3 tables. Shows Shovill's depth estimate next to the mapped
depth;--min-depth(default 20) grades the mapped depth (warn below it, fail below half), and a
warning says when the two differ by more than 1.5×. New requirementsdepthandkleborate.
msascope
-
Faster gzip loading: gzip input is decompressed on its own thread while the parser encodes,
BGZF (bgzip) files are decompressed 32 members at a time in parallel, and flate2 uses its
zlib-rs backend. On a 20,000 × 30,000 alignment, measured on a busy machine: BGZF 5.4 → 4.4 s
and one-member gzip 7.2 → 6.3 s (medians of 9), fastest runs 3.0 → 1.4 s and 3.1 → 2.6 s; peak
memory unchanged. Tests cover plain, multi-member and BGZF gzip, progress and cancel. -
Read QC named after the sheet's read files joins their sample: with
--sheet, a leanqc or
FastQC report ofreads/SRR30733615_1.fastq.gzjoins the sample the sheet lists that file for,
instead of getting a row of its own (found by the second paper redo). -
--min-contig(and irit-mcp'smin_contig): the contig cut-off for assembly statistics,
500 bp by default as QUAST; 200 bp compares with papers that report GenBank's assemblies.
dblock
- Downloads side by side:
fetch --jobs N(default 4) downloads the parts or files of an entry,
and several databases, under one shared limit;--jobs 1fetches one thing at a time as before.
Measured: placement-lite (11 parts, 175 MB) 133 s → 68 s, AMRFinderPlus (38 files, 126 MB)
414 s → 161 s. When a part fails, the parts still downloading stop and keep their partial files
for the next run; the error names the part that failed. Progress stays on one live line.
Download
Terminal (Linux or macOS), installs into ~/.local/bin without sudo:
curl -fsSL https://raw.githubusercontent.com/dzulfikar08/irit/main/scripts/install.sh | IRIT_VERSION=v0.5.0 sh- Linux command-line tools (static, any distribution): x86_64, aarch64
- macOS command-line tools (Apple Silicon and Intel, Developer ID signed and notarised): irit-0.5.0-universal-macos.tar.gz
- msascope for macOS (signed, notarised): msascope-0.5.0.dmg. Open it and drag msascope to Applications.
- msascope for Linux (glibc 2.39 or newer: Ubuntu 24.04, Debian 13, Fedora 40 or later): x86_64, aarch64
- Windows (sheetgen, leanqc, isotable, dblock): irit-0.5.0-x86_64-windows.zip. Not code-signed: SmartScreen may warn the first time you run them.
Check downloads with sha256sum -c SHA256SUMS --ignore-missing (macOS: shasum -a 256 -c SHA256SUMS --ignore-missing). More, including checking the macOS signatures: https://dzulfikar08.github.io/irit/install/