Skip to content

v0.4.0 — grouped browser, progressive import, honest pixel readout

Choose a tag to compare

@sleuthy-sloth sleuthy-sloth released this 24 Oct 23:10
· 19 commits to main since this release

Clivus v0.4.0. Free software (GPL-3.0-or-later); research and engineering tooling, not a certified
medical device, and nothing here has been validated for diagnosis.

What changed

The series browser shows the study, not just a list. Patient header, study header, series rows
with thumbnails. Two patients whose series share a description were previously indistinguishable,
because the boundary between them was not on screen. A group header opens its first series.

Series appear while the folder is still being scanned. The walk reports what it has found every
64 objects, so a large nested folder shows something usable immediately instead of an empty pane until
the last header is parsed. Cancelling keeps the series found so far instead of discarding a nearly
finished scan.

Grouping is keyed on (StudyInstanceUID, SeriesInstanceUID). A malformed export that reuses one
series UID across two studies used to produce a single row carrying the first patient's identity and
every file. Now a UID proven to carry two patient identities is split, and the count is reported.
Objects with no SeriesInstanceUID — two of the committed corpus files are like this — are kept in a
labelled quarantine group instead of being dropped silently.

Zoom where you are looking. Ctrl+wheel zooms about the pointer, so the pixel under the cursor stays
under it. Zoom and pan survive slice changes and reset only when the series or its matrix changes.

Drag the stack to scroll it. Middle-drag scrubs slices through the same coalesced decode path as
the wheel; left-drag stays window/level, right-drag stays pan.

Read the pixel under the cursor. Row and column, the stored value, the modality value, and a unit
only when the object earns one: HU needs a rescale pair, RT Dose reads in Gy, and an object whose values
came from a LUT reports no stored number rather than inventing one. Colour pixels say RGB.

Fixed along the way: the top-left overlay was drawn in the measurement accent colour instead of
light grey (it inherited whatever pen the previous drawing pass left behind); measurement labels were
clipped at the canvas edges; DICOM text was decoded as UTF-8 regardless of the charset the file
declares, so Latin-1 names rendered as replacement characters; a cache schema bump dropped its tables
after creating them, which broke the first save after an upgrade.

Verification

  • 27 test targets green: 26 in the full build plus the core-only parity gate. Every behaviour above
    has a test that was checked to fail without its change — see docs/UNIT-*-EVIDENCE.md and
    docs/PIXEL-POINTER-EVIDENCE.md for the verbatim runs.
  • Built and tested on Debian 13 / aarch64, Qt 6.8.2, DCMTK 3.6.9; the macOS lane builds with
    DCMTK 3.7.1. The 3.6 build is what keeps the two DCMTK generations honest.
  • A Windows build accompanies this tag: clivus-0.4.0-windows-x64.zip, built by
    .github/workflows/windows-app.yml (manual dispatch) from this tag's commit on 2026-10-25 with MSVC and
    Qt 6.8.1 — 26/26 ctest targets green. Unzip it and run clivus.exe; it carries the Qt and DCMTK DLLs,
    the corpus, the assets and the licence texts. That workflow is still manual-dispatch: tagging alone does
    not build Windows.

Not verified, stated plainly

  • Nobody has launched a packaged Windows build on Windows hardware.
  • No clinical validation, no regulatory assessment, no diagnostic claims.
  • The slice-step latency improvement from separating speculative decode from the foreground pool has
    no measurement behind it: that bench needs a machine with a working GL context and was not run.
  • Rendering, DPI scaling and font behaviour were checked by painted-image tests and by the report
    author's photographs, not on a calibrated display.

Upgrading

The index cache schema is now version 5. An older cache is dropped and rebuilt the first time a folder
is opened, so the first open after upgrading is a cold scan. Patient names and identifiers are still
never written to the cache.