feat: Segmentations Settings UI - Phase 1 #1391 (#1392)

* Filter segs and fetch correct metadata. * Initiate seg loading logic on series load into viewport. Need to write. * Automatic consumption of SEG functional. * Pull in master. * Fix issues after pulling in master. * Clean up old segmentation handlers. * WIP * WIP * Poppulate viewport with metadata. * Show hide/segmentation in react-vtkjs-viewport. * feat: 🎸 View segmentations in vtkjs viewport * Filter segs and fetch correct metadata. * Initiate seg loading logic on series load into viewport. Need to write. * Automatic consumption of SEG functional. * Pull in master. * Fix issues after pulling in master. * Clean up old segmentation handlers. * WIP * WIP * Poppulate viewport with metadata. * Show hide/segmentation in react-vtkjs-viewport. * feat: 🎸 View segmentations in vtkjs viewport * Rebase on master. * format format format * add basic extension parts * Updated yarn lock * Fetch derived/referenced displaysets in sidepanel * Add buttons, expose seriesDescription, write notes for Danny. * Add growcut tool extention. -> Move to a seperate repo. * Change some text fields. * expose dialog provider * hide draggable area * No pointer events for now; need to revisit * Don't filter seg from the outset for now * fiddling about * fix path to series data * fix logic to determine next available labelmapindex * Ability to swtich between labelmaps * Return a promise so we can make sure our labelmap is loaded before pulling metadata * Better UI to toggle labelmaps * Fix accidental untoggle of active labelmap for ui * Remove brush tool from cornerstone extension * Add cstools in preInit for seg extension * Add buttons for seg magic * Hide the measurements panel for now * Slightly better seg/scissor icons * Add eraser * ability to switch segments * seg color / switcher * Fix vtk labelmap cache. * sidepanel should scroll if there's overflow * Use a fancier range slider * Slightly prettier buttons * Push in progress * A bit more reactive; handle no-meta * Update to vtk.js 11.14.0 and react-vtkjs-viewport 0.6.0 * chore: kickstart preview * Fix conflict issues * Refactor panel * Isolate increment functions * Wip segment table * Hide selector and add scroll to segmentation * Increase width of segment description * Hide not used items * Add new select for segmentations * Align ui * Fix default segmentation * Fix broken import test * Get measurements panel back and add spacing to grouped buttons * Hide brush and selector and refresh when switching segmentations * Add pointer events back and fix broken tests for measurement table * Update segment list when switching humbnails * CR Update: Minor UI adjustments * CR Update: Set active segment * Move components to components folder * Add new settings ui * Integrate configuration * Improve styles * Float numbers * Improve css * Refresh settings menu if side panel changed * Fix settings rendering logic and remove comments * Extract components * Remove not used tools * Remove non used extension * Use style variables and remove comments * Remove non used dep from lock * Remove tools * Remove segmentation from toolbar * Add todo and brushradius from config * Fix packagejson growcut import * Remove webpack config already defined in parent * Update package json description * Change component name to british english to us * Improve prop types * Rename cornerstone label map event * Scope css * Extract and add doc to helper * Update jsdocs for getDerivedDatasets * Add proptypes and cr updates * Update tablistitem proptypes * config is readonly, rollback destructuring * Remove event for side panel * Add jsdocs for util * Extract getimageid to studymetada * Use ohif log instead of console * Remove specific style from side panel * Fix default props for brush radius * Descructure configuration props from settings component to avoid invalid props * Update proptypes to be required (settings) * Update readme * Remove commandsmodule * Get configuration module inside the component * Set selected segment * Rename extension and use modality to filter * Fix for failing tests (#1423) * hello world * Finish rebase for Igor. * Re-fix cornerstoneTools version that got messed up in merge. * Fix reactivity of isDisabled, write implementation for the SEG panel. * Nuke yarn.lock to stack CST to 4.12.0 * Remove debugger statements. * fix: bump cornerstone-tools version to address toFixed issue * test: force tests for MISTER^MR to navigate to study directly * test: remove eraser tool test * test: count is off by one * test: don't save SR state for the time being * test: disable more tests Co-authored-by: James A. Petts <jamesapetts@gmail.com> Co-authored-by: dannyrb <danny.ri.brown@gmail.com> Co-authored-by: igoroctaviano] <igoroctaviano@users.noreply.github.com> Co-authored-by: Mirna Silva <mirna.silva@radicalimaging.com>
2020-03-13 15:45:26 -04:00
1 parent d426b78967
commit e8842cf8ae
@@ -1,7 +1,7 @@
 # Change Log

-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.

 ## [2.5.3](https://github.com/OHIF/Viewers/compare/@ohif/core@2.5.2...@ohif/core@2.5.3) (2020-03-09)

@@ -304,339 +304,239 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline

 # [1.9.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.8.0...@ohif/core@1.9.0) (2019-11-13)

-
 ### Features

-* expose UiNotifications service ([#1172](https://github.com/OHIF/Viewers/issues/1172)) ([5c04e34](https://github.com/OHIF/Viewers/commit/5c04e34c8fb2394ab7acd9eb4f2ab12afeb2f255))
-
-
-
-
+- expose UiNotifications service
+  ([#1172](https://github.com/OHIF/Viewers/issues/1172))
+  ([5c04e34](https://github.com/OHIF/Viewers/commit/5c04e34c8fb2394ab7acd9eb4f2ab12afeb2f255))

 # [1.8.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.7.1...@ohif/core@1.8.0) (2019-11-12)

-
 ### Features

-* 🎸 Update hotkeys and user preferences modal ([#1135](https://github.com/OHIF/Viewers/issues/1135)) ([e62f5f8](https://github.com/OHIF/Viewers/commit/e62f5f8dd28ab363f23671cd21cee115abb870ff)), closes [#923](https://github.com/OHIF/Viewers/issues/923)
-
-
-
-
+- 🎸 Update hotkeys and user preferences modal
+  ([#1135](https://github.com/OHIF/Viewers/issues/1135))
+  ([e62f5f8](https://github.com/OHIF/Viewers/commit/e62f5f8dd28ab363f23671cd21cee115abb870ff)),
+  closes [#923](https://github.com/OHIF/Viewers/issues/923)

 ## [1.7.1](https://github.com/OHIF/Viewers/compare/@ohif/core@1.7.0...@ohif/core@1.7.1) (2019-11-08)

-
 ### Bug Fixes

-* Add a fallback metadata provider which pulls metadata from WADO-… ([#1158](https://github.com/OHIF/Viewers/issues/1158)) ([31b1adf](https://github.com/OHIF/Viewers/commit/31b1adfa5993d6c8e3e9c8b03fa9856f2621b037))
-
-
-
-
+- Add a fallback metadata provider which pulls metadata from WADO-…
+  ([#1158](https://github.com/OHIF/Viewers/issues/1158))
+  ([31b1adf](https://github.com/OHIF/Viewers/commit/31b1adfa5993d6c8e3e9c8b03fa9856f2621b037))

 # [1.7.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.6.2...@ohif/core@1.7.0) (2019-11-05)

-
 ### Features

-* 🎸 Filter by url query param for seriesInstnaceUID ([#1117](https://github.com/OHIF/Viewers/issues/1117)) ([e208f2e](https://github.com/OHIF/Viewers/commit/e208f2e6a9c49b16dadead0a917f657cf023929a)), closes [#1118](https://github.com/OHIF/Viewers/issues/1118)
-
-
-
-
+- 🎸 Filter by url query param for seriesInstnaceUID
+  ([#1117](https://github.com/OHIF/Viewers/issues/1117))
+  ([e208f2e](https://github.com/OHIF/Viewers/commit/e208f2e6a9c49b16dadead0a917f657cf023929a)),
+  closes [#1118](https://github.com/OHIF/Viewers/issues/1118)

 ## [1.6.2](https://github.com/OHIF/Viewers/compare/@ohif/core@1.6.1...@ohif/core@1.6.2) (2019-11-05)

-
 ### Bug Fixes

-* [#1075](https://github.com/OHIF/Viewers/issues/1075) Returning to the Study List before all series have finishe… ([#1090](https://github.com/OHIF/Viewers/issues/1090)) ([ecaf578](https://github.com/OHIF/Viewers/commit/ecaf578f92dc40294cec7ff9b272fb432dec4125))
-
-
-
-
+- [#1075](https://github.com/OHIF/Viewers/issues/1075) Returning to the Study
+  List before all series have finishe…
+  ([#1090](https://github.com/OHIF/Viewers/issues/1090))
+  ([ecaf578](https://github.com/OHIF/Viewers/commit/ecaf578f92dc40294cec7ff9b272fb432dec4125))

 ## [1.6.1](https://github.com/OHIF/Viewers/compare/@ohif/core@1.6.0...@ohif/core@1.6.1) (2019-10-31)

-
 ### Bug Fixes

-* application crash if patientName is an object ([#1138](https://github.com/OHIF/Viewers/issues/1138)) ([64cf3b3](https://github.com/OHIF/Viewers/commit/64cf3b324da2383a927af1df2d46db2fca5318aa))
-
-
-
-
+- application crash if patientName is an object
+  ([#1138](https://github.com/OHIF/Viewers/issues/1138))
+  ([64cf3b3](https://github.com/OHIF/Viewers/commit/64cf3b324da2383a927af1df2d46db2fca5318aa))

 # [1.6.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.5.2...@ohif/core@1.6.0) (2019-10-26)

-
 ### Features

-* Snapshot Download Tool ([#840](https://github.com/OHIF/Viewers/issues/840)) ([450e098](https://github.com/OHIF/Viewers/commit/450e0981a5ba054fcfcb85eeaeb18371af9088f8))
-
-
-
-
+- Snapshot Download Tool ([#840](https://github.com/OHIF/Viewers/issues/840))
+  ([450e098](https://github.com/OHIF/Viewers/commit/450e0981a5ba054fcfcb85eeaeb18371af9088f8))

 ## [1.5.2](https://github.com/OHIF/Viewers/compare/@ohif/core@1.5.1...@ohif/core@1.5.2) (2019-10-25)

-
 ### Bug Fixes

-* set SR in ActiveViewport by clicking thumb ([#1091](https://github.com/OHIF/Viewers/issues/1091)) ([986b7ae](https://github.com/OHIF/Viewers/commit/986b7ae2bf4f7d27f326e62f93285ce20eaf0a79))
-
-
-
-
+- set SR in ActiveViewport by clicking thumb
+  ([#1091](https://github.com/OHIF/Viewers/issues/1091))
+  ([986b7ae](https://github.com/OHIF/Viewers/commit/986b7ae2bf4f7d27f326e62f93285ce20eaf0a79))

 ## [1.5.1](https://github.com/OHIF/Viewers/compare/@ohif/core@1.5.0...@ohif/core@1.5.1) (2019-10-25)

-
 ### Bug Fixes

-* 🐛 Orthographic MPR fix ([#1092](https://github.com/OHIF/Viewers/issues/1092)) ([460e375](https://github.com/OHIF/Viewers/commit/460e375f0aa75d35f7a46b4d48e6cc706019956d))
-
-
-
-
+- 🐛 Orthographic MPR fix ([#1092](https://github.com/OHIF/Viewers/issues/1092))
+  ([460e375](https://github.com/OHIF/Viewers/commit/460e375f0aa75d35f7a46b4d48e6cc706019956d))

 # [1.5.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.4.0...@ohif/core@1.5.0) (2019-10-25)

-
 ### Features

-* 🎸 Allow routes to load Google Cloud DICOM Stores in the Study List ([#1069](https://github.com/OHIF/Viewers/issues/1069)) ([21b586b](https://github.com/OHIF/Viewers/commit/21b586b08f3dde6613859712a9e0577dece564db))
-
-
-
-
+- 🎸 Allow routes to load Google Cloud DICOM Stores in the Study List
+  ([#1069](https://github.com/OHIF/Viewers/issues/1069))
+  ([21b586b](https://github.com/OHIF/Viewers/commit/21b586b08f3dde6613859712a9e0577dece564db))

 # [1.4.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.3.2...@ohif/core@1.4.0) (2019-10-15)

-
 ### Features

-* 🎸 Only allow reconstruction of datasets that make sense ([#1010](https://github.com/OHIF/Viewers/issues/1010)) ([2d75e01](https://github.com/OHIF/Viewers/commit/2d75e01)), closes [#561](https://github.com/OHIF/Viewers/issues/561)
-
-
-
-
+- 🎸 Only allow reconstruction of datasets that make sense
+  ([#1010](https://github.com/OHIF/Viewers/issues/1010))
+  ([2d75e01](https://github.com/OHIF/Viewers/commit/2d75e01)), closes
+  [#561](https://github.com/OHIF/Viewers/issues/561)

 ## [1.3.2](https://github.com/OHIF/Viewers/compare/@ohif/core@1.3.1...@ohif/core@1.3.2) (2019-10-14)

-
 ### Bug Fixes

-* Return display sets in StudyMetadata._createDisplaySetsForSeries ([#1042](https://github.com/OHIF/Viewers/issues/1042)) ([fc01532](https://github.com/OHIF/Viewers/commit/fc01532))
-
-
-
-
+- Return display sets in StudyMetadata.\_createDisplaySetsForSeries
+  ([#1042](https://github.com/OHIF/Viewers/issues/1042))
+  ([fc01532](https://github.com/OHIF/Viewers/commit/fc01532))

 ## [1.3.1](https://github.com/OHIF/Viewers/compare/@ohif/core@1.3.0...@ohif/core@1.3.1) (2019-10-11)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 # [1.3.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.2.0...@ohif/core@1.3.0) (2019-10-11)

-
 ### Features

-* 🎸 Improve usability of Google Cloud adapter, including direct routes to studies ([#989](https://github.com/OHIF/Viewers/issues/989)) ([2bc361c](https://github.com/OHIF/Viewers/commit/2bc361c))
-
-
-
-
+- 🎸 Improve usability of Google Cloud adapter, including direct routes to
+  studies ([#989](https://github.com/OHIF/Viewers/issues/989))
+  ([2bc361c](https://github.com/OHIF/Viewers/commit/2bc361c))

 # [1.2.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.1.0...@ohif/core@1.2.0) (2019-10-09)

-
 ### Bug Fixes

-* OHIF-1002 Study lazy load should be true by default ([#1004](https://github.com/OHIF/Viewers/issues/1004)) ([66d8bc6](https://github.com/OHIF/Viewers/commit/66d8bc6))
-
+- OHIF-1002 Study lazy load should be true by default
+  ([#1004](https://github.com/OHIF/Viewers/issues/1004))
+  ([66d8bc6](https://github.com/OHIF/Viewers/commit/66d8bc6))

 ### Features

-* Allow a server requestOptions.auth to be a function that returns the Authorization header. ([#928](https://github.com/OHIF/Viewers/issues/928)) ([0064a4b](https://github.com/OHIF/Viewers/commit/0064a4b))
-
-
-
-
+- Allow a server requestOptions.auth to be a function that returns the
+  Authorization header. ([#928](https://github.com/OHIF/Viewers/issues/928))
+  ([0064a4b](https://github.com/OHIF/Viewers/commit/0064a4b))

 # [1.1.0](https://github.com/OHIF/Viewers/compare/@ohif/core@1.0.2...@ohif/core@1.1.0) (2019-10-03)

-
 ### Features

-* Use QIDO + WADO to load series metadata individually rather than the entire study metadata at once ([#953](https://github.com/OHIF/Viewers/issues/953)) ([9e10c2b](https://github.com/OHIF/Viewers/commit/9e10c2b))
-
-
-
-
+- Use QIDO + WADO to load series metadata individually rather than the entire
+  study metadata at once ([#953](https://github.com/OHIF/Viewers/issues/953))
+  ([9e10c2b](https://github.com/OHIF/Viewers/commit/9e10c2b))

 ## [1.0.2](https://github.com/OHIF/Viewers/compare/@ohif/core@1.0.1...@ohif/core@1.0.2) (2019-10-02)

-
 ### Bug Fixes

-* Temporarily sort SEG files to the end of the display set list as a workaround for several metadata issues ([#987](https://github.com/OHIF/Viewers/issues/987)) ([b3b4c10](https://github.com/OHIF/Viewers/commit/b3b4c10))
-
-
-
-
+- Temporarily sort SEG files to the end of the display set list as a workaround
+  for several metadata issues
+  ([#987](https://github.com/OHIF/Viewers/issues/987))
+  ([b3b4c10](https://github.com/OHIF/Viewers/commit/b3b4c10))

 ## [1.0.1](https://github.com/OHIF/Viewers/compare/@ohif/core@1.0.0...@ohif/core@1.0.1) (2019-09-27)

-
 ### Bug Fixes

-* Check for Value in 00081155 sequence (Few patient protocol images doesn't have this value) and removed a duplicate declaration ([#921](https://github.com/OHIF/Viewers/issues/921)) ([d0ec9cf](https://github.com/OHIF/Viewers/commit/d0ec9cf))
-
-
-
-
+- Check for Value in 00081155 sequence (Few patient protocol images doesn't have
+  this value) and removed a duplicate declaration
+  ([#921](https://github.com/OHIF/Viewers/issues/921))
+  ([d0ec9cf](https://github.com/OHIF/Viewers/commit/d0ec9cf))

 # [1.0.0](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.10...@ohif/core@1.0.0) (2019-09-27)

-
 ### Bug Fixes

-* 🐛 Add DicomLoaderService & FileLoaderService to fix SR, PDF, and SEG support in local file and WADO-RS-only use cases ([#862](https://github.com/OHIF/Viewers/issues/862)) ([e7e1a8a](https://github.com/OHIF/Viewers/commit/e7e1a8a)), closes [#838](https://github.com/OHIF/Viewers/issues/838)
-
+- 🐛 Add DicomLoaderService & FileLoaderService to fix SR, PDF, and SEG support
+  in local file and WADO-RS-only use cases
+  ([#862](https://github.com/OHIF/Viewers/issues/862))
+  ([e7e1a8a](https://github.com/OHIF/Viewers/commit/e7e1a8a)), closes
+  [#838](https://github.com/OHIF/Viewers/issues/838)

 ### BREAKING CHANGES

-* DICOM Seg
-
-
-
-
+- DICOM Seg

 ## [0.50.10](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.9...@ohif/core@0.50.10) (2019-09-23)

-
 ### Bug Fixes

-* Avoid using variable name "module" ([#942](https://github.com/OHIF/Viewers/issues/942)) ([72427fe](https://github.com/OHIF/Viewers/commit/72427fe)), closes [#940](https://github.com/OHIF/Viewers/issues/940)
-
-
-
-
+- Avoid using variable name "module"
+  ([#942](https://github.com/OHIF/Viewers/issues/942))
+  ([72427fe](https://github.com/OHIF/Viewers/commit/72427fe)), closes
+  [#940](https://github.com/OHIF/Viewers/issues/940)

 ## [0.50.9](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.8...@ohif/core@0.50.9) (2019-09-17)

-
 ### Bug Fixes

-* bump cornerstone-tools version in peerDeps ([4afc88c](https://github.com/OHIF/Viewers/commit/4afc88c))
-
-
-
-
+- bump cornerstone-tools version in peerDeps
+  ([4afc88c](https://github.com/OHIF/Viewers/commit/4afc88c))

 ## [0.50.8](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.7...@ohif/core@0.50.8) (2019-09-10)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## [0.50.7](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.6...@ohif/core@0.50.7) (2019-09-10)

-
 ### Bug Fixes

-* remove requestOptions when key is not needed ([32bc47d](https://github.com/OHIF/Viewers/commit/32bc47d))
-
-
-
-
+- remove requestOptions when key is not needed
+  ([32bc47d](https://github.com/OHIF/Viewers/commit/32bc47d))

 ## [0.50.6](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.5...@ohif/core@0.50.6) (2019-09-09)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## [0.50.5](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.4...@ohif/core@0.50.5) (2019-09-04)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## [0.50.4](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.3...@ohif/core@0.50.4) (2019-09-04)

-
 ### Bug Fixes

-* measurementsAPI issue caused by production build ([#842](https://github.com/OHIF/Viewers/issues/842)) ([49d3439](https://github.com/OHIF/Viewers/commit/49d3439))
-
-
-
-
+- measurementsAPI issue caused by production build
+  ([#842](https://github.com/OHIF/Viewers/issues/842))
+  ([49d3439](https://github.com/OHIF/Viewers/commit/49d3439))

 ## [0.50.3](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.2...@ohif/core@0.50.3) (2019-08-26)

-
 ### Bug Fixes

-* **Studies:** Qidosupportsincludefield should be true by default ([#801](https://github.com/OHIF/Viewers/issues/801)) ([a88d865](https://github.com/OHIF/Viewers/commit/a88d865))
-
-
-
-
+- **Studies:** Qidosupportsincludefield should be true by default
+  ([#801](https://github.com/OHIF/Viewers/issues/801))
+  ([a88d865](https://github.com/OHIF/Viewers/commit/a88d865))

 ## [0.50.2](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.1...@ohif/core@0.50.2) (2019-08-22)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## [0.50.1](https://github.com/OHIF/Viewers/compare/@ohif/core@0.50.0-alpha.10...@ohif/core@0.50.1) (2019-08-14)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 # [0.50.0-alpha.10](https://github.com/OHIF/Viewers/compare/@ohif/core@0.11.1-alpha.9...@ohif/core@0.50.0-alpha.10) (2019-08-14)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## [0.11.1-alpha.9](https://github.com/OHIF/Viewers/compare/@ohif/core@0.11.1-alpha.8...@ohif/core@0.11.1-alpha.9) (2019-08-14)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 ## 0.11.1-alpha.8 (2019-08-14)

 **Note:** Version bump only for package @ohif/core

-
-
-
-
 # Change Log

 All notable changes to this project will be documented in this file. See
@@ -32,7 +32,7 @@
  },
  "peerDependencies": {
    "cornerstone-core": "^2.2.8",
-    "cornerstone-tools": "4.12.0",
+    "cornerstone-tools": "4.12.5",
    "cornerstone-wado-image-loader": "^3.0.0",
    "dicom-parser": "^1.8.3"
  },
@@ -1,5 +1,6 @@
 import guid from '../utils/guid.js';
 import OHIFError from './OHIFError';
+import { Vector3 } from 'cornerstone-math';

 const OBJECT = 'object';

@@ -63,6 +64,60 @@ class ImageSet {
  sortBy(sortingCallback) {
    return this.images.sort(sortingCallback);
  }
+
+  sortByImagePositionPatient() {
+    const images = this.images;
+    const referenceImagePositionPatient = _getImagePositionPatient(images[0]);
+
+    const refIppVec = new Vector3(
+      referenceImagePositionPatient[0],
+      referenceImagePositionPatient[1],
+      referenceImagePositionPatient[2]
+    );
+
+    const ImageOrientationPatient = _getImageOrientationPatient(images[0]);
+
+    const scanAxisNormal = new Vector3(
+      ImageOrientationPatient[0],
+      ImageOrientationPatient[1],
+      ImageOrientationPatient[2]
+    ).cross(
+      new Vector3(
+        ImageOrientationPatient[3],
+        ImageOrientationPatient[4],
+        ImageOrientationPatient[5]
+      )
+    );
+
+    const distanceImagePairs = images.map(function(image) {
+      const ippVec = new Vector3(..._getImagePositionPatient(image));
+      const positionVector = refIppVec.clone().sub(ippVec);
+      const distance = positionVector.dot(scanAxisNormal);
+
+      return {
+        distance,
+        image,
+      };
+    });
+
+    distanceImagePairs.sort(function(a, b) {
+      return b.distance - a.distance;
+    });
+
+    const sortedImages = distanceImagePairs.map(a => a.image);
+
+    images.sort(function(a, b) {
+      return sortedImages.indexOf(a) - sortedImages.indexOf(b);
+    });
+  }
+}
+
+function _getImagePositionPatient(image) {
+  return image.getData().metadata.ImagePositionPatient;
+}
+
+function _getImageOrientationPatient(image) {
+  return image.getData().metadata.ImageOrientationPatient;
 }

 export default ImageSet;
@@ -35,6 +35,12 @@ export class StudyMetadata extends Metadata {
        writable: false,
        value: [],
      },
+      _derivedDisplaySets: {
+        configurable: false,
+        enumerable: false,
+        writable: false,
+        value: [],
+      },
      _firstSeries: {
        configurable: false,
        enumerable: false,
@@ -121,7 +127,11 @@ export class StudyMetadata extends Metadata {
      );
      if (displaySet) {
        displaySet.sopClassModule = true;
-        displaySets.push(displaySet);
+
+        displaySet.isDerived
+          ? this._addDerivedDisplaySet(displaySet)
+          : displaySets.push(displaySet);
+
        return displaySets;
      }
    }
@@ -186,9 +196,73 @@ export class StudyMetadata extends Metadata {
  }

  /**
-   * Creates a set of series to be placed in the Study Metadata
-   * The series that appear in the Study Metadata must represent
-   * imaging modalities.
+   * Adds the displaySets to the studies list of derived displaySets.
+   * @param {object} displaySet The displaySet to append to the derived displaysets list.
+   */
+  _addDerivedDisplaySet(displaySet) {
+    this._derivedDisplaySets.push(displaySet);
+    // --> Perhaps that logic should exist in the extension sop class handler and this be a dumb list.
+    // TODO -> Get x Modality by referencedSeriesInstanceUid, FoR, etc.
+  }
+
+  /**
+   * Returns a list of derived datasets in the study, filtered by the given filter.
+   * @param {object} filter An object containing search filters
+   * @param {object} filter.modality
+   * @param {object} filter.referencedSeriesInstanceUID
+   * @param {object} filter.referencedFrameOfReferenceUID
+   * @return {Array} filtered derived display sets
+   */
+  getDerivedDatasets(filter) {
+    const {
+      modality,
+      referencedSeriesInstanceUID,
+      referencedFrameOfReferenceUID,
+    } = filter;
+    let filteredDerivedDisplaySets = this._derivedDisplaySets;
+
+    if (modality) {
+      filteredDerivedDisplaySets = filteredDerivedDisplaySets.filter(
+        displaySet => displaySet.Modality === Modality
+      );
+    }
+
+    if (referencedSeriesInstanceUID) {
+      filteredDerivedDisplaySets = filteredDerivedDisplaySets.filter(
+        displaySet => {
+          if (!displaySet.metadata.ReferencedSeriesSequence) {
+            return false;
+          }
+
+          const ReferencedSeriesSequence = Array.isArray(
+            displaySet.metadata.ReferencedSeriesSequence
+          )
+            ? displaySet.metadata.ReferencedSeriesSequence
+            : [displaySet.metadata.ReferencedSeriesSequence];
+
+          return ReferencedSeriesSequence.some(
+            ReferencedSeries =>
+              ReferencedSeries.SeriesInstanceUID === referencedSeriesInstanceUID
+          );
+        }
+      );
+    }
+
+    if (referencedFrameOfReferenceUID) {
+      filteredDerivedDisplaySets = filteredDerivedDisplaySets.filter(
+        displaySet =>
+          displaySet.ReferencedFrameOfReferenceUID ===
+          ReferencedFrameOfReferenceUID
+      );
+    }
+
+    return filteredDerivedDisplaySets;
+  }
+
+  /**
+   * Creates a set of displaySets to be placed in the Study Metadata
+   * The displaySets that appear in the Study Metadata must represent
+   * imaging modalities. A series may be split into one or more displaySets.
   *
   * Furthermore, for drag/drop functionality,
   * it is easiest if the stack objects also contain information about
@@ -482,6 +556,22 @@ export class StudyMetadata extends Metadata {
    return series;
  }

+  /**
+   * Get the first image id given display instance uid.
+   * @return {string} The image id.
+   */
+  getFirstImageId(displaySetInstanceUID) {
+    try {
+      const displaySet = this.findDisplaySet(
+        displaySet => displaySet.displaySetInstanceUID === displaySetInstanceUID
+      );
+      return displaySet.images[0].getImageId();
+    } catch (error) {
+      console.error('Failed to retrieve image metadata');
+      return null;
+    }
+  }
+
  /**
   * Get the first instance of the current study retaining a consistent result across multiple calls.
   * @return {InstanceMetadata} An instance of the InstanceMetadata class or null if it does not exist.
@@ -625,6 +715,10 @@ const makeDisplaySet = (series, instances) => {

  imageSet.isReconstructable = isReconstructable.value;

+  if (shallSort && imageSet.isReconstructable) {
+    imageSet.sortByImagePositionPatient();
+  }
+
  if (isReconstructable.missingFrames) {
    // TODO -> This is currently unused, but may be used for reconstructing
    // Volumes with gaps later on.
@@ -0,0 +1,45 @@
+import DICOMWeb from '../../../DICOMWeb';
+
+/**
+ * Function to get series sequence (sequence of pepeating items where each
+ * item includes the attributes of one or more series) based on a given sopInstance.
+ *
+ * @param {Object} instance The sop instance
+ * @returns {Promise} Referenced series sequence
+ */
+const getReferencedSeriesSequence = instance => {
+  const referencedSeriesSequenceRaw = instance['00081115'];
+
+  const referencedSeriesSequence = [];
+
+  if (referencedSeriesSequenceRaw && referencedSeriesSequenceRaw.Value) {
+    referencedSeriesSequenceRaw.Value.forEach(referencedSeries => {
+      const referencedSeriesInstanceUID = DICOMWeb.getString(
+        referencedSeries['0020000E']
+      );
+
+      const referencedInstanceSequenceRaw = referencedSeries['0008114A'];
+      const referencedInstanceSequence = [];
+
+      referencedInstanceSequenceRaw.Value.forEach(referencedInstance => {
+        referencedInstanceSequence.push({
+          referencedSOPClassUID: DICOMWeb.getString(
+            referencedInstance['00081150']
+          ),
+          referencedSOPInstanceUID: DICOMWeb.getString(
+            referencedInstance['00081155']
+          ),
+        });
+      });
+
+      referencedSeriesSequence.push({
+        referencedSeriesInstanceUID,
+        referencedInstanceSequence,
+      });
+    });
+  }
+
+  return referencedSeriesSequence;
+};
+
+export default getReferencedSeriesSequence;
@@ -2,6 +2,7 @@ import DICOMWeb from '../../../DICOMWeb';
 import metadataProvider from '../../../classes/MetadataProvider';
 import getWADORSImageId from '../../../utils/getWADORSImageId';
 import cornerstoneWADOImageLoader from 'cornerstone-wado-image-loader';
+import getReferencedSeriesSequence from './getReferencedSeriesSequence';

 /**
 * Create a plain JS object that describes a study (a study descriptor object)
@@ -23,7 +24,10 @@ function createStudy(server, aSopInstance) {
    PatientSize: DICOMWeb.getNumber(aSopInstance['00101020']),
    PatientWeight: DICOMWeb.getNumber(aSopInstance['00101030']),
    AccessionNumber: DICOMWeb.getString(aSopInstance['00080050']),
+    StudyTime: DICOMWeb.getString(aSopInstance['00080030']),
    StudyDate: DICOMWeb.getString(aSopInstance['00080020']),
+    FrameOfReferenceUID: DICOMWeb.getString(aSopInstance['00200052']),
+    ReferencedSeriesSequence: getReferencedSeriesSequence(aSopInstance),
    modalities: DICOMWeb.getString(aSopInstance['00080061']), // TODO -> Rename this.. it'll take a while to not mess this one up.
    StudyDescription: DICOMWeb.getString(aSopInstance['00081030']),
    NumberOfStudyRelatedInstances: DICOMWeb.getString(aSopInstance['00201208']),
@@ -186,7 +190,7 @@ async function makeSOPInstance(server, study, instance) {
 */
 async function addInstancesToStudy(server, study, sopInstanceList) {
  return Promise.all(
-    sopInstanceList.map(function(sopInstance) {
+    sopInstanceList.map(function (sopInstance) {
      return makeSOPInstance(server, study, sopInstance);
    })
  );
@@ -8,6 +8,7 @@ import studyMetadataManager from './studyMetadataManager';
 import writeScript from './writeScript.js';
 import DicomLoaderService from './dicomLoaderService.js';
 import b64toBlob from './b64toBlob.js';
+import loadAndCacheDerivedDisplaySets from './loadAndCacheDerivedDisplaySets.js';
 import * as urlUtil from './urlUtil';
 import makeCancelable from './makeCancelable';
 import hotkeys from './hotkeys';
@@ -24,6 +25,7 @@ const utils = {
  studyMetadataManager,
  DicomLoaderService,
  urlUtil,
+  loadAndCacheDerivedDisplaySets,
  makeCancelable,
  hotkeys,
 };
@@ -40,6 +42,7 @@ export {
  studyMetadataManager,
  DicomLoaderService,
  urlUtil,
+  loadAndCacheDerivedDisplaySets,
  makeCancelable,
  hotkeys,
 };
@@ -12,6 +12,7 @@ describe('Top level exports', () => {
      'b64toBlob',
      'StackManager',
      'studyMetadataManager',
+      'loadAndCacheDerivedDisplaySets',
      'DicomLoaderService',
      'urlUtil',
      'makeCancelable',
@@ -167,8 +167,8 @@ function _getSpacingIssue(spacing, averageSpacing) {
 function _getPerpendicularDistance(a, b) {
  return Math.sqrt(
    Math.pow(a[0] - b[0], 2) +
-      Math.pow(a[1] - b[1], 2) +
-      Math.pow(a[2] - b[2], 2)
+    Math.pow(a[1] - b[1], 2) +
+    Math.pow(a[2] - b[2], 2)
  );
 }

@@ -0,0 +1,107 @@
+import studyMetadataManager from './studyMetadataManager';
+
+/**
+ * Study schema
+ *
+ * @typedef {Object} Study
+ * @property {Array} seriesList -
+ * @property {Object} seriesMap -
+ * @property {Object} seriesLoader -
+ * @property {string} wadoUriRoot -
+ * @property {string} wadoRoot -
+ * @property {string} qidoRoot -
+ * @property {string} patientName -
+ * @property {string} patientId -
+ * @property {number} patientAge -
+ * @property {number} patientSize -
+ * @property {number} patientWeight -
+ * @property {string} accessionNumber -
+ * @property {string} studyDate -
+ * @property {string} studyTime -
+ * @property {string} modalities -
+ * @property {string} studyDescription -
+ * @property {string} imageCount -
+ * @property {string} studyInstanceUid -
+ * @property {string} institutionName -
+ * @property {Array} displaySets -
+ */
+
+/**
+ * Factory function to load and cache derived display sets.
+ *
+ * @param {object} referencedDisplaySet Display set
+ * @param {string} referencedDisplaySet.displaySetInstanceUid Display set instance uid
+ * @param {string} referencedDisplaySet.seriesDate
+ * @param {string} referencedDisplaySet.seriesTime
+ * @param {string} referencedDisplaySet.seriesInstanceUid
+ * @param {string} referencedDisplaySet.seriesNumber
+ * @param {string} referencedDisplaySet.seriesDescription
+ * @param {number} referencedDisplaySet.numImageFrames
+ * @param {string} referencedDisplaySet.frameRate
+ * @param {string} referencedDisplaySet.modality
+ * @param {boolean} referencedDisplaySet.isMultiFrame
+ * @param {number} referencedDisplaySet.instanceNumber
+ * @param {boolean} referencedDisplaySet.isReconstructable
+ * @param {string} referencedDisplaySet.studyInstanceUid
+ * @param {Array} referencedDisplaySet.sopClassUids
+ * @param {Study[]} studies Collection of studies
+ * @returns void
+ */
+const loadAndCacheDerivedDisplaySets = (referencedDisplaySet, studies) => {
+  const { StudyInstanceUID, SeriesInstanceUID } = referencedDisplaySet;
+
+  const studyMetadata = studyMetadataManager.get(StudyInstanceUID);
+
+  if (!studyMetadata) {
+    return;
+  }
+
+  const derivedDisplaySets = studyMetadata.getDerivedDatasets({
+    referencedSeriesInstanceUID: SeriesInstanceUID,
+  });
+
+  if (!derivedDisplaySets.length) {
+    return;
+  }
+
+  // Filter by type
+  const displaySetsPerModality = {};
+
+  derivedDisplaySets.forEach(displaySet => {
+    const Modality = displaySet.Modality;
+
+    if (displaySetsPerModality[Modality] === undefined) {
+      displaySetsPerModality[Modality] = [];
+    }
+
+    displaySetsPerModality[Modality].push(displaySet);
+  });
+
+  // For each type, see if any are loaded, if not load the most recent.
+  Object.keys(displaySetsPerModality).forEach(key => {
+    const displaySets = displaySetsPerModality[key];
+    const isLoaded = displaySets.some(displaySet => displaySet.isLoaded);
+
+    if (isLoaded) {
+      return;
+    }
+
+    // find most recent and load it.
+    let recentDateTime = 0;
+    let recentDisplaySet;
+
+    displaySets.forEach(displaySet => {
+      const dateTime = Number(
+        `${displaySet.SeriesDate}${displaySet.SeriesTime}`
+      );
+      if (dateTime > recentDateTime) {
+        recentDateTime = dateTime;
+        recentDisplaySet = displaySet;
+      }
+    });
+
+    recentDisplaySet.load(referencedDisplaySet, studies);
+  });
+};
+
+export default loadAndCacheDerivedDisplaySets;
@@ -0,0 +1,3 @@
+const reconstructableModalities = ['MR', 'CT', 'PT', 'NM'];
+
+export default reconstructableModalities;