Skip to content

Commit fae5695

Browse files
committed
Update readme
1 parent 1bf509d commit fae5695

File tree

1 file changed

+17
-25
lines changed

1 file changed

+17
-25
lines changed

README.md

Lines changed: 17 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,29 @@
1-
[![Build Status](https://travis-ci.com/mghcomputationalpathology/dicom-microscopy-viewer.svg?branch=master)](https://travis-ci.com/mghcomputationalpathology/dicom-microscopy-viewer)
1+
[![Build Status](https://github.com/herrmannlab/dicom-microscopy-viewer/actions/workflows/run_unit_tests.yml/badge.svg)](https://github.com/herrmannlab/dicom-microscopy-viewer/actions)
2+
[![NPM version](https://badge.fury.io/js/dicom-microscopy-viewer.svg)](http://badge.fury.io/js/dicom-microscopy-viewer)
23

34
# DICOM Microscopy Viewer
45

5-
Vanilla JS library for web-based visualization of [DICOM VL Whole Slide Microscopy Image](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.32.8.html) datasets.
6+
Vanilla JS library for web-based visualization of [DICOM VL Whole Slide Microscopy Image](http://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.32.8.html) datasets and derived information.
67

78
The viewer allows visualization of slide microscopy images stored in a [DICOMweb](https://www.dicomstandard.org/dicomweb/) compatible archive.
89
It leverages the [dicomweb-client](https://github.com/dcmjs-org/dicomweb-client) JavaScript library to retrieve data from the archive.
910

1011
## Features
1112

12-
* Display of different image types: `VOLUME`, `OVERVIEW`, `LABEL`
13+
* Display of different image types: `VOLUME`/`THUMBNAIL`, `OVERVIEW`, `LABEL`
1314
* Annotation of regions of interest (ROI) as vector graphics based on 3-dimensional spatial coordinates (SCOORD3D): `POINT`, `MULTIPOINT`, `POLYLINE`, `POLYGON`, `ELLIPSE`, `ELLIPSOID`
1415
* Assembly of concatenations
15-
* Decoding of compressed pixel data, supporting baseline JPEG, JPEG 2000 and JPEG-LS codecs
16+
* Decoding of compressed pixel data, supporting baseline JPEG, JPEG 2000, and JPEG-LS codecs
17+
* Correction of color images using ICC profiles
1618
* Additive blending and coloring of monochromatic images of multiple optical paths (channels), supporting highly-multiplexed immunofluorescence imaging
17-
18-
## Live demo
19-
20-
Check out the online examples at [microscopy.dcmjs.org](https://microscopy.dcmjs.org/).
19+
* Overlay of image analysis results in the form of [DICOM Segmentation](https://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.51.html), [Parametric Map](https://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.75.html), [Comprehensive 3D SR](https://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.35.13.html), or [Microscopy Bulk Simple Annotations](https://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_A.87.html)
2120

2221
## Documentation
2322

24-
The online Application Programming Interface (API) documentation is available at [mghcomputationalpathology.github.io/dicom-microscopy-viewer](https://mghcomputationalpathology.github.io/dicom-microscopy-viewer/).
23+
Documentation of the JavaScript Application Programming Interface (API) is available online at [mghcomputationalpathology.github.io/dicom-microscopy-viewer](https://mghcomputationalpathology.github.io/dicom-microscopy-viewer/).
2524

2625
## Getting started
2726

28-
Take a look at the examples in the `/examples` directory.
29-
They are also available online at [microscopy.dcmjs.org](https://microscopy.dcmjs.org/).
30-
3127
### Basic usage
3228

3329
```html
@@ -60,9 +56,11 @@ client.searchForInstances(searchInstanceOptions).then((instances) => {
6056
sopInstanceUID,
6157
};
6258
const promise = client.retrieveInstanceMetadata(retrieveInstanceOptions).then(metadata => {
63-
const imageType = metadata[0]["00080008"]["Value"];
64-
if (imageType[2] === "VOLUME") {
65-
return(metadata[0]);
59+
const image = new DICOMMicroscopyViewer.metadata.VLWholeSlideMicroscopyViewer({
60+
metadata
61+
})
62+
if (image.imageType[2] === "VOLUME") {
63+
return(image);
6664
}
6765
});
6866
promises.push(promise);
@@ -98,7 +96,6 @@ Please cite the following article when using the viewer for scientific studies:
9896
Volume={9},
9997
Number={37}
10098
}
101-
10299
```
103100

104101
## Installation
@@ -111,26 +108,21 @@ npm install dicom-microscopy-viewer
111108

112109
## Building & Testing
113110

114-
Build code locally:
111+
We use [webpack](https://webpack.js.org/) for bundling and [Jest](https://github.com/facebook/jest) for testing.
112+
113+
Build:
115114

116115
```None
117-
git clone https://github.com/mghcomputationalpathology/dicom-microscopy-viewer ~/dicom-microscopy-viewer
118-
cd ~/dicom-microscopy-viewer
119116
npm install
120117
npm run build
121118
```
122119

123-
test code locally:
120+
Test:
124121

125122
```None
126-
git clone https://github.com/mghcomputationalpathology/dicom-microscopy-viewer ~/dicom-microscopy-viewer
127-
cd ~/dicom-microscopy-viewer
128-
npm install
129123
npm test
130124
```
131125

132-
We use [rollup](https://rollupjs.org/guide/en) for bundling and [Jest](https://github.com/facebook/jest) for testing.
133-
134126
Build the documentation:
135127

136128
```None

0 commit comments

Comments
 (0)