Skip to content

irit 0.5.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 09:32
· 23 commits to main since this release

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 that asm_coverage only 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>.tsv now 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 mentions meta for 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 requirements depth and kleborate.

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 of reads/SRR30733615_1.fastq.gz joins 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's min_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 1 fetches 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/