Skip to content

irit 0.3.2

Choose a tag to compare

@github-actions github-actions released this 11 Nov 17:48
· 93 commits to main since this release

msascope

  • Annotation tracks: Stockholm #=GC lines of every tag are shown under the track header,
    aligned to the columns and following hidden columns: SS_cons as helix and strand bands, RNA
    base pairs and coil, PP_cons as bars, other tags (seq_cons, RF, …) as text. The Tracks
    menu switches each one; the hover card over a track gives its character in words. #=GR
    lines are read too: the hover card over a cell lists the row's values, and the reference row's
    lines can be shown as tracks. Lines of the wrong length (or for a sequence that isn't in the
    file) are left out with a warning in the status bar and the terminal; at most 64 MiB of #=GR
    lines are kept.
  • Reference row: set from the Tracks or Sort menu, by right-clicking a name, or with m (the
    cursor's row); marked "ref" in the name panel. It can be pinned under the tracks, the ruler can
    count its residues (from its /start-end), and Differences, the identity track, the density
    view, the overview and figures compare with it instead of the consensus. It stays with its
    sequence through sorting, filtering and tree order.
  • Cheaper track header: the consensus, identity and gaps tracks (and the new ones) are drawn
    as cached image tiles instead of quads every frame; on a 20,000 × 10,000 alignment the paint
    median at the fit zoom went from 2.7–4.6 ms to 0.2 ms, at 1 px per cell from 3.9 ms to
    0.3–0.4 ms.
  • --stats prints the annotation read and any lines left out.
  • The --bench peak RSS difference reported for 0.3.1 was measured again: 0.3.0 and 0.3.1 peak
    within 2 MiB of each other, at the end of loading.

dblock

  • gtdbtk-r232-mockup is fetched again: GTDB corrected the stale MD5 in its MD5SUM.txt
    (GTDBTk#726), and the entry now uses it.
    gtdbtk-r232-client keeps the same file and now cites the published MD5.
  • amrfinderplus-db-4.2-2026-10-29.1: AMRFinderPlus's database, release 2026-10-29.1 (format
    4.2), from NCBI's FTP: the 38 files amrfinder_update 4.2.7 downloads, with MD5 and SHA-256 we
    computed (NCBI publishes none). 126 MB download, 256 MB once indexed.
  • Multi-part entries can be plain files ("format": "file"): each part is kept under its name.
  • prepare: a fixed step run on the downloaded files before the folder is sealed. The only one is
    amrfinder_index (needs AMRFinderPlus on PATH); the lock records the program and its version
    (prepared).
  • The Bakta entries' notes now say how to give Bakta this database as amrfinderplus-db/latest
    through a folder of links, instead of running amrfinder_update into the dblock folder.

gtdbprep

  • gtdbprep ani no longer reads GTDB's server unless asked. --source has no default:
    pass an unpacked sketches.db (path or URL), or --source gtdb to range-read GTDB's archive,
    as GTDB's maintainers asked (GTDBTk#727).
    A run whose sketches are all cached needs no --source.
  • Fetched sketches go to one cache per user ($XDG_CACHE_HOME/irit/gtdbprep-ani, or
    ~/.cache/irit/gtdbprep-ani) instead of <work>/cache, so a sketch is fetched once per machine,
    not once per work folder. --cache still overrides it. Runs sharing a cache no longer write
    through the same temporary file.

irit-mcp

  • shovill (Shovill 1.4.2, the current Bioconda release): paired-end Illumina assembly with
    SPAdes, SKESA, MEGAHIT or Velvet. Only Shovill 1.4.2's flags (--opts, which goes into a shell
    command, and --tmpdir are left out); reads checked as FASTQ, ram at least 8 GB as Shovill
    requires, gsize, namefmt and kmers checked the way Shovill parses them, an outdir whose
    path a shell would split refused. Returns contig count, total length, N50, longest contig and GC.
  • mlst (mlst 2.35.0): sequence type from the PubMLST schemes bundled with mlst. outfile must
    be named so isotable finds it (<sample>.mlst.tsv), and with one assembly its sample part becomes
    mlst's --label, so Shovill's contigs.fa joins to the right sample.
  • amrfinder (AMRFinderPlus 4.2.7): resistance genes and point mutations from an assembly,
    proteins, or both with a GFF (Bakta's with annotation_format: bakta). The database is checked
    like amrfinder does (files, indexes, format not newer than 4.2.7, data at least 2025-09-22.2,
    organism one the database knows) and its version.txt is hashed into the record; --update is
    not offered. output must be named <sample>.amrfinder.tsv (or contain amrfinder) for isotable.
  • AMRFINDER_DB is the default database, as for amrfinder itself; --tool-path takes the three
    new names.
  • The real-tools workflow also runs fastp → Shovill → mlst → AMRFinderPlus on real
    Staphylococcus aureus reads (ERR044595, nf-core/bacass's test data) and AMRFinderPlus on
    Bakta's proteins, then isotable over all of it, twice, then replay.sh.

isotable

  • parse::mlst and parse::amrfinder are public, for irit-mcp's summaries. No change in what
    isotable reads.

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