Skip to content

irit 0.3.5

Choose a tag to compare

@github-actions github-actions released this 12 Nov 17:04
· 66 commits to main since this release

irit-mcp

  • gtdbprep_ani tool (#4): gtdbprep ani through the server, recorded and replayable.
    source stays opt-in; the sketch cache, $GTDBTK_DATA_PATH and $GTDBPREP_ENV are resolved
    when the server starts and written into the command. It returns each genome's species,
    reference, ANI and AF, and <work>/gtdbtk_data, which gtdbtk_classify_wf takes as data_path
    (its skani-missing message now says so). On B. subtilis 168 with a warm cache: 15 s, then
    classify_wf 4.8 s, same species; the replay matched all 32 outputs. Since that folder is now an
    output of a recorded call, the run record shows where classify_wf's GTDBTK_DATA_PATH came from
    (#8).
  • GTDB-Tk's data is accounted for or flagged (#8): a skani/ database of up to 512 MB (the one
    gtdbprep_ani builds is a few MB) is hashed into gtdbtk_classify_wf's inputs under its real
    path, and the call warns when data_path is neither in a dblock store nor written by an earlier
    call of the run, since the record can't then say what the folder held.
  • Missing output folders are created (#2): trim/s1_R1.fastq.gz or an outdir of asm/s1
    no longer needs trim/ or asm/ to exist. Only folders of checked outputs are created (so inside
    the root), a file in the way is refused, the record lists them as dirs, and replay.sh runs
    mkdir -p on them, so a replay works from a clean folder.
  • Shovill link_as (#3): e.g. genomes/s1.fna becomes a relative link to
    <outdir>/contigs.fa, made before Shovill runs, recorded as the call's links and recreated by
    replay.sh (ln -sfn), so CheckM2, GTDB-Tk and gtdbprep_ani name the genome after the
    sample and replay works without hand-made copies.
  • Every Shovill output is volatile (#5): contigs.fa headers carry the date, and SKESA 2.5.1
    with 8 CPUs gave different assemblies from identical reads, as SPAdes did. replay.sh checks
    that they exist; the contig count, length and N50 are in the result and in isotable's row.
  • Replay explains outputs made from a volatile one (#5). The contig count, length and N50
    are now recorded with the Shovill call (assembly), and replay.sh prints the replayed
    assembly's beside them. Before each call it checks the inputs an earlier call wrote; when one
    differs (a new assembly), that call's different outputs (CheckM2's report, isotable's row) are
    reported as following it instead of failing the replay. Anything else that differs still fails.

isotable

  • Reads Shovill's contigs.fa (#7) when shovill.log is beside it, as the sample named after
    its folder: contigs, length and N50, counted as QUAST does (contigs of 500 bp or more), so a
    QUAST report on the same assembly agrees. The default isolate requirements (contigs, N50) can
    now be met without QUAST, also through irit-mcp.

leanqc

  • Reports are byte-identical between runs (#6): remaining_if_deduplicated_percent summed
    over duplication levels in a hash map's order, so its last digits could change from run to run
    and replay.sh's hash check of the JSON report failed. The levels are now summed in order.
    A test runs leanqc with 1 to 4 threads, eight times, on reads that push the duplication
    estimate past its tracking limit, and compares the JSON byte for byte (it fails on the old code).

gtdbprep

  • irit-gtdb-prep --version (and -V) works (#9); it said "unexpected argument". The release
    workflow now checks its version like the other binaries.

dblock

  • checkm2-db-v3 is 3.08 GB on disk (measured), not ~3.5 GB (#11).
  • A database folder moved or linked in from another store is reused with its .dblock.toml
    marker rewritten to its new place; the marker kept the old store's paths (#10). fetch now says
    what reuse checked (names and sizes) and that verify --deep re-hashes. Markers are written to
    a temporary file and renamed, so a marker hard-linked from the other store (a folder copied with
    cp -al, as on the laptop run) is replaced in this store only, not edited in both.

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