Skip to content

v0.3.0 — de-identified export, image and series PNG export

Choose a tag to compare

@sleuthy-sloth sleuthy-sloth released this 24 Oct 02:29
· 44 commits to main since this release

Getting data out, without the patient coming along

Export a de-identified copy

File ▸ Export de-identified copy… writes a second copy of the open folder with identity removed
from the metadata, then re-reads every file it wrote and searches for the original values. The
report says Verification: PASSED only when none survive; a copy that fails is reported as a copy
you should not share.

Always removed or replaced: Patient Name → ANONYMOUS, Patient ID → generated, birth date/time,
other patient IDs and names, address, telephone numbers, patient comments, accession number, study
ID, institution name/address/department, referring/performing/reading physicians, operators, station
name, device serial number, and free-text study/series descriptions and protocol names.

Your choice: remap Study/Series/SOP Instance UIDs (references followed through nested sequences),
shift dates by one random offset per export (intervals preserved — a 2-day gap stays 2 days),
remove private vendor tags (on by default — 179 of them in the committed corpus alone), remove
patient sex.

Safety properties: the destination must be empty, so verification covers exactly what this run wrote;
non-DICOM files are skipped rather than copied; a UID element is never rewritten while the dataset is
being walked; pixel data is written back byte-identical in its original transfer syntax, so the copy
still measures the same.

Export images

  • Export image as PNG… — the canvas exactly as displayed at the current window/level, no overlay
    text. Refuses with a reason instead of writing a black file when there is no GL context.
  • Export series as PNGs… — every slice at the current window/level, on a worker, cancellable;
    slices that fail to decode are counted and named rather than written as blank frames.

What this release does not claim

  • Pixel data is untouched, so text burned into an image (annotations, ultrasound overlays,
    photographed films) survives. Clivus does no OCR and cannot detect it. Review the images yourself.
  • Not a legal determination. De-identification ≠ anonymity: a rare diagnosis, a distinctive
    implant, a face in a reconstruction can still identify someone. No HIPAA/GDPR/PS3.15 conformance
    assessment has been performed; the tag set is the core identity list, not the full basic profile.
  • No real patient study has been de-identified in testing — identifiers were fabricated on synthetic
    objects.
  • Nobody has launched the packaged app on Windows hardware. CI builds, tests (23 targets) and
    packages it; docs/VALIDATION.md records that as unrun.
  • Not a medical device.

Install

Unzip anywhere, run clivus.exe. LICENSE, THIRD-PARTY.md and assets/ ship beside the binaries.

Provenance

Commit d9dfa85 (tag v0.3.0), 23 test targets green on Linux and on the Windows CI runner
(run 40053785138). The first Windows run failed one test: it assumed the second series in the list
had multiple frames, which depends on directory order — fixed to select a multi-frame series
explicitly rather than relying on platform sort.