/x-to-dicom

Creates DICOM files from GIFs or other motion picture formats for testing purposes

Primary LanguageC#

Multipurpose DICOM Converter (name WIP)

Background

Inspired by shared frustrations with a coworker about not having any "fun" test images to use when developing our company software, I built this in my spare time. It's built to solve a couple of problems:

  1. No easy way to get test medical images.
  2. Any medical images you get might have real patient data.
  3. Even if the data is blinded, some studies are pretty gnarly.
  4. So if your requirements are low, why not use something fun like a cat GIF from the internet?

Supported Formats

  1. GIF
  2. MP4
  3. AVI

Getting Started

  1. Install FFMPEG and make sure it's added to your path
  2. Acquire a file in any format above from your favorite source (i.e. https://www.reddit.com/r/cinemagraphs)
  3. Build the solution
  4. In a command prompt, cd to the bin folder

Usage & Examples

Generate a DICOM file from an mp4 on Windows:

.\XToDicom.Cli.exe --in C:\sample.mp4 --out C:\dicomOut.dcm

Then, open it up with any free DICOM viewer (for example, MicroDICOM) and it should look something like this:

Creator credit: Reddit user InfinitySandwich's post

Generated from a scene in the movie Back to the Future

TODO: Linux & MacOS instructions

TODO: Build a pre-packaged binary in GitHub releases or publish a dotnet tool install compatible nuget package.