Skip to content

irit 0.6.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 05:10
· 10 commits to main since this release

New: the rest of a metagenome-to-MAG study on a laptop: SemiBin2 binning, galah dereplication, a
genome × sample abundance table, GTDB tree placement for genomes the ANI screen can't name
(gtdbprep place), and co-occurrence statistics (cooccur, a new tool). sheetgen verify checks
read files against their MD5s before analysis, and fieldsheet is an offline phone worksheet for
sample metadata. A replay now tolerates bins a binner names differently after a changed assembly.

irit-mcp

  • semibin2 (SemiBin 2.6.0, single sample): pretrained environment models from CoverM's depth
    table, or self-supervised training from BAMs. On the Crystal Geyser sample the pretrained models
    took about a minute in 0.9–1.5 GiB and gave 25–27 bins against MetaBAT2's 23, without better
    quality; self-supervised training was killed at 8 GB.
  • galah (0.6.3): dereplicate bins from several samples at 95 % ANI, choosing representatives
    by CheckM2 quality. 48 bins made 24 clusters in under a second.
  • coverm_abundance: several samples mapped to a set of genomes, one genome × sample table
    (relative abundance, mean depth, covered fraction, read count) for cooccur.
  • reads_verify, cooccur and gtdbprep_place: irit-mcp tools for sheetgen verify, cooccur
    and gtdbprep place, with a stdio test that runs the first two with the real binaries and replays.
  • coverm_contig gains bam_cache_dir, to keep each sample's sorted BAM for SemiBin2.

sheetgen

  • sheetgen verify checks read files before analysis: full gzip decompression (every member,
    CRC-32 and length) and FASTQ structure, with MD5 and SHA-256 in the same pass, compared with an
    md5sum file (--md5) or ENA's published MD5s and sizes (--ena, opt-in network). Each file is
    ok, mismatch, corrupt (with the byte offset, record and line) or not listed; exit 1 on any
    problem; --json for irit-mcp. Constant memory; 163–174 MB/s on a 568 MB file on a loaded laptop.

cooccur (new)

  • Which genomes rise and fall together across samples, from a coverm genome table: CLR
    proportionality rho (Lovell et al. 2015) or Spearman on CLR values, seeded sequential permutation
    p-values and Benjamini-Hochberg q-values, CPR / non-CPR labels from a GTDB-Tk summary. rho and
    Spearman match the R package propr 5.1.8 and R. The permutation null's calibration and the power
    were measured by simulation; 500 genomes × 60 samples run in about 6 s and 20 MiB.

gtdbprep

  • gtdbprep place: GTDB-Tk tree placement on the placement-only data dblock fetches
    (identify, align --skip_gtdb_refs, classify without the ANI screen), with gPlace as the placer
    under a memory cap. It checks that gPlace wrote every placement, skips genomes gtdbprep ani
    assigned (--skip-assigned), and writes place.tsv and a place.json run record. On the three
    Crystal Geyser bins the ANI screen couldn't assign it gave the same classifications as the earlier
    manual run, 5.6 GiB peak.

fieldsheet (new)

  • An offline web app, installable on a phone, for recording sample metadata in the field:
    projects, automatic sample IDs, range checks, GPS with a coarse or off option, photos kept on the
    device, CSV export with sample first for sheetgen and isotable, JSON backup and import, English
    and Bahasa Indonesia. At https://dzulfikar08.github.io/irit/fieldsheet/.

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.6.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.6.0-universal-macos.tar.gz
  • msascope for macOS (signed, notarised): msascope-0.6.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.6.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/