Repository navigation
irit 0.3.0
msascope
- msaview is now msascope; the name MSAView belongs to an existing viewer, GMOD's. The binary,
msascope.app(bundle idcom.dzulfikar.irit.msascope),msascope.dmgand the
msascope-<arch>-linux.tar.gzarchives take the new name. The installer replaces anmsaview
it installed earlier withmsascope, and still installsmsaviewfrom releases up to 0.2.1. - Colour schemes: Clustal X with its per-column rules (Jalview's table), percent identity,
hydrophobicity (Kyte–Doolittle), nucleotide and differences from the consensus, each with a
"by conservation" fade, in light and dark. Letters on every fill keep at least 4.5:1 contrast
(a test). Chosen from the toolbar's colour menu;scycles,ddifferences,cconservation.
Residues a scheme leaves unfilled are drawn as muted letters on the background, and gaps are
the background with a faint dot, also in the dark theme. - Low zoom shows density, not sampled cells: below one pixel per cell each pixel takes the
majority residue and the share of differing cells of the cells it covers (from the pyramid or
the cells, up to 32 samples). "Fit all" on Pfam PF00042 full (32,112 × 698) now shows conserved
columns as stripes instead of noise. - Overview panel on the right: the whole alignment, the visible area as a box (click or drag
to pan), the visible range and the scheme's legend. Toggle in the toolbar. - Hover card next to the pointer: sequence name, accession (
#=GS AC) and range, residue
with its position in the ungapped sequence (from the name's/start-end), column in the
alignment's numbering and among the shown columns, consensus, identity and gaps. It replaces
the hover text in the status bar. - Insert and gappy columns can be hidden (toolbar,
iandg). Insert columns are now kept
at load: the columns where every row has lower case or., or#=GC RFwhen the file has it.
Residues are still stored as upper case, at 1 bit per column extra. Gappy means at least 25, 50
(default), 75, 90 or 100% gaps. The ruler keeps the original column numbers and marks hidden
runs; go-to takes original numbers. Inserts are hidden by default when a file has them. - Selection: click names for rows (Ctrl adds or removes, Shift extends, drag extends), click
or drag on the track header for columns, Shift+click or Shift+drag in the alignment for a
block; plain drag still pans. Ctrl+A selects all, Escape clears. Selected rows show in the name
panel, columns in the ruler, blocks with an accent wash and outline; the status bar gives the
size. - Copy and FASTA export: Ctrl+C copies the selection as FASTA, Ctrl+Shift+C as residues only;
the Export menu writes the selection or all rows to a FASTA file. Hidden columns are left out
unless "Include hidden columns" is on; "Leave out gaps" writes ungapped sequences. Rows come in
the order shown. Above 64 MiB the copy goes to a file. - Cell cursor: arrows move it (Shift extends a block, Ctrl jumps over runs of residues),
Page Up/Down and Home/End move it by a page or to the row's ends; Alt+arrows pan as the arrows
did before. The cursor shows in the ruler and the name panel, and the hover card follows it. - Drag-and-drop: drop an alignment, a tree, or both on the window. Open… also takes trees.
- Newick tree panel: from
--tree, Open or a drop, Stockholm#=GF NH, or a sibling
.nwk/.newick/.tree/.treefilewith the alignment's stem. Rows follow the tree (Sort:
tree / file,t); clicking a node collapses its clade into one row showing the clade
consensus; the status bar counts collapsed clades and reports unmatched leaves and sequences.
The parser handles quoted labels, branch lengths, comments and NHX, and internal labels, without
recursion. A synthetic 230,000-leaf tree reads and parses in 0.1–0.5 s and matches in
0.3–0.8 s on the test laptop, in the background. - The ruler's marks for hidden columns are now thin ticks, merged when closer than 6 px; the hover
card over the ruler lists the hidden columns next to the column. msagen --tree TREE.nwkwrites a tree matching the generated alignment.- Toolbar icons that were not in the bundled icon set (the columns button) now use bundled ones,
so they no longer show blank.
dblock
- Identical files inside a database are hard-linked after unpacking, so they take disk space
once. Files are matched by size, permissions and the SHA-256 dblock already records, so nothing
is read twice.gtdbtk-r232-placementtakes 2.7 GB on disk instead of 7.4 GB, and
gtdbtk-r232-placement-lite1.7 GB instead of 5.9 GB (measured withduon Linux).
verify,verify --deepand GTDB-Tk folder hashes give the same results. The marker and lock
entry recordlinked_filesandlinked_bytes. If the file system refuses hard links the copies
are kept, with a note.fetch --no-dedupekeeps copies. gtdbtk-r232-ani-screen(2.1 GB download, 2.3 GB unpacked): the screen index forgtdbprep ani,
from a new unofficial irit-data release derived from GTDB R232 (CC BY-SA 4.0).
irit-mcp
- Third-party tools for the microbial isolate path:
fastp,bakta,checkm2and
gtdbtk_classify_wf. Each one offers exactly the flags of a pinned upstream version (fastp 1.4.0,
Bakta 1.12.2, CheckM2 1.1.0, GTDB-Tk 2.8.0), read from that release's source. The calls go into
the same run record andreplay.shas the irit tools, so a whole run from reads to taxonomy can
be replayed without the AI.- The program is found on
PATHor through the new--tool-path NAME=PATH. If it's missing,
the call fails with a Bioconda install hint. - Inputs are checked before running (FASTQ or FASTA, plain or gzip, not empty). So are the
databases: Bakta'sversion.jsonand files, CheckM2's.dmnd, and GTDB-Tk's data folders,
includingskani/, whichclassify_wfalways needs, and the split-tree files unless
full_treeis set. - The program's
--versionis recorded. A version other than the pinned one adds a warning to
the result;replay.shwarns on a mismatch. - Exit 0 without the files the program always writes is an error (
missing_outputs), recorded
as a failed call. - Results carry small summaries: fastp totals, Bakta feature counts, CheckM2 completeness and
contamination, and GTDB-Tk classifications. fastp, CheckM2 and GTDB-Tk files are read with
isotable's parsers.
- The program is found on
versionin run records is now the first line of--version, as the docs said.
isotable
- The output parsers are now also a library (
isotable::parse), so irit-mcp reads tool outputs the
same way isotable grades them. The command-line tool is unchanged.
gtdbprep
gtdbprep ani: GTDB-Tk's ANI species screen without the 85 GB skani database. The genomes
are screened locally against a compact index of every R232 reference's marker k-mers. Only the
references skani would compare in full are fetched, by HTTP range requests, and GTDB-Tk's own
ANIScreenerthen runs on just those. Sketches can come from GTDB's own.tar.gz(through a
gzip seek index, the default), an unpackedsketches.db(local or hosted), or one split into
parts. On test genomes the output was byte-identical to GTDB-Tk against the full database. See
the research page.gtdbprep ani-index build | gz-scan | gz-attachmake the screen index and the seek index from
a full skani database and GTDB's archive (maintainers).- Reading sketches from GTDB's archive is a stopgap (about 5.7 times the sketch bytes, and load
on GTDB's server): keep a--cache. Peak memory 1.9 GB for 9 genomes; GTDB-Tk on the full
database takes 14.7 GB.
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.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.3.0-universal-macos.tar.gz
- msascope for macOS (signed, notarised): msascope-0.3.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.3.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/