feat add generate segmentation from dataset

src/adapters/Cornerstone/Segmentation.js

@@ -4,7 +4,8 @@ import Segmentation_4X from "./Segmentation_4X";
 const Segmentation = {
     generateSegmentation,
     generateToolState,
-    fillSegmentation
+    fillSegmentation,
+    generateSegmentationFromDatasets
 };
 
 export default Segmentation;
@@ -108,3 +109,30 @@ function fillSegmentation(
         `No generateSegmentation adapater for cornerstone version ${cornerstoneToolsVersion}, exiting.`
     );
 }
+
+/**
+ * generateSegmentationFromDatasets - Fills a derived segmentation dataset with cornerstoneTools `LabelMap3D` data from Dataset instead of images
+ *
+ * @param  {object[]} dataset An empty segmentation derived dataset.
+ * @param  {Object|Object[]} inputLabelmaps3D The cornerstone `Labelmap3D` object, or an array of objects.
+ * @param  {Object} userOptions Options object to override default options.
+ * @returns {Blob}           description
+ */
+function generateSegmentationFromDatasets(
+    datasets,
+    inputLabelmaps3D,
+    options = { includeSliceSpacing: true },
+    cornerstoneToolsVersion = 4
+) {
+    if (cornerstoneToolsVersion === 4) {
+        return Segmentation_4X.generateSegmentationFromDatasets(
+            datasets,
+            inputLabelmaps3D,
+            options
+        );
+    }
+
+    console.warn(
+        `No generateSegmentationFromDatasets adapater for cornerstone version ${cornerstoneToolsVersion}, exiting.`
+    );
+}

src/adapters/Cornerstone/Segmentation_4X.js

@@ -21,7 +21,8 @@ import {
 const Segmentation = {
     generateSegmentation,
     generateToolState,
-    fillSegmentation
+    fillSegmentation,
+    generateSegmentationFromDatasets
 };
 
 export default Segmentation;
@@ -39,6 +40,30 @@ const generateSegmentationDefaultOptions = {
     rleEncode: true
 };
 
+/**
+ * generateSegmentationFromDatasets - Generates cornerstoneTools brush data, given a stack of
+ * imageIds, images and the cornerstoneTools brushData.
+ *
+ * @param  {object[]} datasets An array of cornerstone image dataset that contain the metadata for each instance
+ *                             and a property _meta with empty array (required for compatibility with other dcmjs functions)
+ *                             The dataset for each instance of image can be generated with `cornerstone.metaData.get('instance', imageId)``
+ *                             but prop _meta = [] needs to be added to each element other
+ * @param  {Object|Object[]} inputLabelmaps3D The cornerstone `Labelmap3D` object, or an array of objects.
+ * @param  {Object} userOptions Options to pass to the segmentation derivation and `fillSegmentation`.
+ * @returns {Blob}
+ */
+function generateSegmentationFromDatasets(
+    datasets,
+    inputLabelmaps3D,
+    userOptions = {}
+) {
+    //make sure _meta property is present in every element of datasets with at least an empty array
+    datasets = datasets.map(ds => ({ ...ds, _meta: ds._meta || [] }));
+    const multiframe = Normalizer.normalizeToDataset(datasets);
+    const segmentation = new SegmentationDerivation([multiframe], userOptions);
+    return fillSegmentation(segmentation, inputLabelmaps3D, userOptions);
+}
+
 /**
  * generateSegmentation - Generates cornerstoneTools brush data, given a stack of
  * imageIds, images and the cornerstoneTools brushData.