Skip to content

v0.1.2 — palette color and LUT sequences decode

Choose a tag to compare

@sleuthy-sloth sleuthy-sloth released this 23 Oct 14:03
· 80 commits to main since this release

The two remaining "decode as stored values" gaps are closed — Clivus now shows what the file's own tables say, everywhere.

Research tool, not a medical device. Research and educational use only.

New in v0.1.2

  • PALETTE COLOR: palette-indexed objects map through the file's Red/Green/Blue LUT tables at decode time and render as true display RGB — no more stored-values-through-a-greyscale-window. Indexes beyond the table clamp to its last entry; 8- and 16-bit entry tables both work.
  • Non-linear Modality LUT Sequences (PS3.3 C.11.2.1.3): applied as a real lookup, replacing slope/intercept entirely when present, exactly as the standard prescribes. PixelPaddingValue maps through the LUT as well, and the window numbers (WC/WW, min/max) describe the post-LUT values — so the visible range and the numbers agree.
  • Loader tests now build palette and LUT-sequence objects directly with DCMTK and assert specific table outputs — the suite pins the mapping, not just the absence of errors.
  • Documentation synced: the manual's Limitations chapter, the README loader notes and roadmap all reflect the new coverage (v0.1.0-level claims retracted, new claims test-backed).

The Windows download (no toolchain)

clivus-v0.1.2-windows-x64.zip — unzip and run clivus.exe .\corpus (test corpus included). Licences included (GPL-3.0-or-later; Qt 6 under its GPL option; LICENSE + THIRD-PARTY.md ship in-the-box).

Source: v0.1.2 @ 4d36b31

Known limitations (documented, not hidden)

  • No orientation markers (needs Volume origin/orientation geometry — next on the roadmap, prerequisite for MPR/3D)
  • No MPR, measurements, DICOM networking or anonymisation
  • JPEG 2000 decodes where the DCMTK build carries it; macOS Homebrew's still doesn't (the vendored-DCMTK item)