zhiva-ai
DICOMweb Client
JavaScript client implementation of DICOMweb.
For further details please refer to PS3.18 of the DICOM standard.
Goal
This is work-in-progress and should not be used in clinical practice.
The main motivation for this project is:
- Support for storing, quering, retrieving DICOM objects over the web using RESTful services STOW-RS, QIDO-RS and WADO-RS, respectively
- Building a lightweight library to facilitate integration into web applications
Installation
Install the dicomweb-node-client package using the npm package manager:
npm install dicomweb-node-clientBuilding and testing
Build and test code locally:
git clone https://github.com/zhiva-ai/dicomweb-node-client ~/dicomweb-node-client
cd ~/dicomweb-node-client
npm install
npm run buildUsage
NodeJS
const DICOMWebNodeClient = require('dicomweb-node-client');
const url = 'http://localhost:8080/dicomweb';
const client = new DICOMwebClient.api.DICOMwebClient({url});
client.searchForStudies().then(studies => {
console.log(studies)
});JS Application
Exactly the same as node, you can import it as DICOMwebClient to be inline with original repo.
import * as DICOMwebClient from 'dicomweb-node-client';
const url = 'http://localhost:8080/dicomweb';
const client = new DICOMwebClient.api.DICOMwebClient({url});
client.searchForStudies().then(studies => {
console.log(studies)
});Direct browser import
<script type="text/javascript" src="https://unpkg.com/dicomweb-client"></script>const url = 'http://localhost:8080/dicomweb';
const client = new DICOMwebClient.api.DICOMwebClient({url});
client.searchForStudies().then(studies => {
console.log(studies)
});Contributions
We made a for of the original dicomweb-client library and extended it with NodeJS support. If you're using this library you don't have to contribute us, but please contribute the amazing people responsible for the original implementation. More details on their GitHub: https://github.com/dcmjs-org/dicomweb-client#citation