coreyt / gdcm-js

GDCM port to js using emscripten

GDCM

This is the GDCM Library ported to JavaScript using Emscripten. It is useful to convert DICOMs between formats inside browser, ionic, hybrid apps, node... I personally created this to convert and decompress some exotic DICOM types.

Building

In order to build it, just run the buildLinuxMac.sh or buildwin.bat. It generates the javascript version of the malaterre's gdcm built with emscripten then transpiled to JavaScript. For each application it will create two files: gdcmXXX.js and gdcmXXX.mem where is XXX is the original app name.

Using

I created a npm wrapper that

• Receives the dicom files as Uint8Array through MEMFS and the array of terminal parameters;
• Returns the MEMFS with converted files as Uint8Array;
• Stdout and Stderr with console output;

Using GDCM End User Applications

You can use it in same way you you use in the terminal. Please read how to use them here: gdcm referece

Example via node

var fs = require("fs");
var gdcm = require("gdcm-js");
// read dicom bytes
var dicomoriginal = new Uint8Array(fs.readFileSync('data/deflated.dcm')); 
// create a memfs with the file
var memfs = [{name: "input.dcm", data: dicomoriginal}]
// write down the params you have to write into terminal
var args = ["-i", "input.dcm", "-o", "output.dcm", "-w"]
// run the app
var result = gdcm.gdcmconv({MEMFS:memfs,arguments:args});
// get results from result
// output files will be stored into MEMFS variable
console.log("input size: " + dicomoriginal.length + ", output size: " + result.MEMFS[0].data.length);

Using directly from browser

You can load directly the desired application instead of the app from npm version. Just download and serve both files "appname.js" and "appname.mem" and use like this:

For this instance my appname is gdcmconv.

<script src="https://raw.githubusercontent.com/InfiniBrains/gdcm-js/master/gdcmconv.js"></script>

And use it:

var dicomoriginal = new Uint8Array(????); // you must provide this
var memfs = [{name: "input.dcm", data: dicomoriginal}]; 
var args = ["-i", "input.dcm", "-o", "output.dcm", "-w"]; // the very same arguments you should pass via terminal
var result =  gdcmFunc({MEMFS:memfs,arguments:args}); // run the app
console.log(result.MEMFS[0].data); // print the file output contents

Running Example

• https://infinibrains.github.io/gdcm-js/

ToDo:

If you are planning to use more than one application, all of them will have the functioname gdcmFunc so be careful when importing many apps via browser. Via node this must be fine.

Authors

• Alexandre Tolstenko
• Cândido Sales