⚠️ You must rebuild your indexespiscem 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 withpiscem 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 rebuiltMapping 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/autoin both directions —
sound (the tiny dictionary is self-contained; outputs are bit-identical),
but--dict sshashand 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 | shDownload 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 |