Input
Read supported scanner formats
Convert any whole-slide input that the selected wsi-rs release can open, including supported SVS, NDPI, DICOM, TIFF and other vendor formats.
DICOM VL WSI / Rust / Digital pathology
DICOM Whole-Slide Conversion
wsi-dicom converts supported scanner files into DICOM VL Whole Slide Microscopy instances. Use it as a Rust library, command-line tool or optional native GUI.
01 / Responsibilities
From scanner container to DICOM objects.
wsi-rs reads the source; the Frames codecs handle supported compressed pixels; wsi-dicom owns export planning, metadata validation, transfer-syntax routing and DICOM writing.
Output
Write tiled VL WSI instances
Plan image geometry, route JPEG/JPEG 2000/HTJ2K payloads where supported, validate bounded metadata, and publish DICOM files through staged output.
Derived objects
Carry profiled annotations
Convert explicitly mapped QuPath GeoJSON into supported ANN, SEG and SR outputs through wsi-dicom-annotations. Clinical terminology is never guessed from class labels.
02 / Guardrails
Conversion choices stay visible.
Provide governed values or opt into research placeholders
Real workflows supply metadata JSON or FHIR input. Placeholder metadata is an explicit, mutually exclusive research option rather than an implicit default.
Select an ICC policy for every export
Use source profiles, sRGB fallback, a governed calibration registry or an explicit profile. Conflicts are handled by the selected policy.
Validation reports what was checked
Intrinsic and optional external validators provide release evidence. Passing those checks is not a claim of formal DICOM certification.
03 / Quick start
Convert a slide.
This research command makes both the placeholder metadata choice and the ICC policy visible. Use governed metadata and calibration for production workflows.
$ cargo install wsi-dicom $ wsi-dicom convert slide.ndpi --out dicom-out --research-placeholder --icc source-or-srgb
The command writes its complete set through a staging directory before promoting the output files.
[dependencies] wsi-dicom = "0.8"
GPU features are opt-in for supported Metal and CUDA routes.