Skip to content

v0.23.0

Latest

Choose a tag to compare

@github-actions github-actions released this 30 Aug 10:59

⚠️ You must rebuild your indexes

piscem 0.23.0 changes the on-disk index format (sshash dictionary
format 5.0). Indexes built by piscem ≤ 0.22.x are rejected at load with an
explicit message and must be rebuilt with piscem build:

Error: failed to load dictionary: ... Incompatible index format version 4.0
(this build reads 5.0): the index was written by a different sshash-rs
release and must be rebuilt

Mapping results are unchanged — per-fragment RAD output is verified
bit-identical against 0.22.x on the same inputs. The rebuild buys a
smaller, faster index.

One nuance: indexes carrying tiny-dictionary artifacts (.tdct) remain
loadable across the break via --dict tiny/auto in both directions —
sound (the tiny dictionary is self-contained; outputs are bit-identical),
but --dict sshash and the tiny path can therefore differ in which
indexes they accept.

What changed

This release adopts piscem-rs 0.10 / sshash-lib 0.7 — a port of C++ SSHash
v6.0.0's unified canonical indexing modality: the minimizer is chosen by
hashing the canonical m-mer at each position, which is mirror-equivariant
(one probe answers both strands, with orientation) at plain forward density.
Practically: ~8–13% smaller dictionaries, faster builds at lower peak memory,
and ~33% faster streaming lookups on error-containing reads (v6's
same-minimizer memos). The dictionary header now records the build seed and a
hash-library guard, so environment drift fails loudly at load.

The old --canonical modality flag no longer exists in the underlying
piscem-rs build CLI (accepted for one release with a warning there); the
piscem wrapper never exposed it, so no piscem command-line options
change
.

Install piscem 0.23.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/COMBINE-lab/piscem/releases/download/v0.23.0/piscem-installer.sh | sh

Download piscem 0.23.0

File Platform Checksum
piscem-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
piscem-x86_64-apple-darwin.tar.xz Intel macOS checksum
piscem-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
piscem-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum