@cornerstonejs/core 4.15.0 → 4.15.2

package/dist/esm/cache/classes/ImageVolume.d.ts

@@ -35,6 +35,7 @@ export declare class ImageVolume {
     referencedImageIds?: string[];
     hasPixelSpacing: boolean;
     additionalDetails?: Record<string, unknown>;
+    numDimensionGroups: number;
     voxelManager?: IVoxelManager<number> | IVoxelManager<RGB>;
     dataType?: PixelDataTypedArrayString;
     get numTimePoints(): number;

package/dist/esm/utilities/index.d.ts

@@ -82,7 +82,7 @@ import { buildMetadata } from './buildMetadata';
 import getDynamicVolumeInfo from './getDynamicVolumeInfo';
 import autoLoad from './autoLoad';
 import scaleArray from './scaleArray';
-import splitImageIdsBy4DTags from './splitImageIdsBy4DTags';
+import splitImageIdsBy4DTags, { handleMultiframe4D, generateFrameImageId } from './splitImageIdsBy4DTags';
 import { deepClone } from './deepClone';
 import { jumpToSlice } from './jumpToSlice';
 import scroll from './scroll';
@@ -97,4 +97,4 @@ import { asArray } from './asArray';
 export { updatePlaneRestriction } from './updatePlaneRestriction';
 declare const getViewportModality: (viewport: IViewport, volumeId?: string) => string;
 export * from './isEqual';
-export { FrameRange, eventListener, csUtils as invertRgbTransferFunction, createSigmoidRGBTransferFunction, getVoiFromSigmoidRGBTransferFunction, createLinearRGBTransferFunction, scaleRgbTransferFunction, triggerEvent, imageIdToURI, fnv1aHash, calibratedPixelSpacingMetadataProvider, clamp, uuidv4, getMinMax, getRuntimeId, isOpposite, getViewportModality, windowLevel, convertToGrayscale, getClosestImageId, getSpacingInNormalDirection, getTargetVolumeAndSpacingInNormalDir, getVolumeActorCorners, indexWithinDimensions, getVolumeViewportsContainingSameVolumes, getViewportsWithVolumeId, transformWorldToIndex, transformIndexToWorld, loadImageToCanvas, renderToCanvasCPU, renderToCanvasGPU, worldToImageCoords, imageToWorldCoords, getVolumeSliceRangeInfo, getVolumeViewportScrollInfo, getSliceRange, snapFocalPointToSlice, getImageSliceDataForVolumeViewport, isImageActor, isPTPrescaledWithSUV, actorIsA, getViewportsWithImageURI, getClosestStackImageIndexForPoint, getCurrentVolumeViewportSlice, calculateViewportsSpatialRegistration, spatialRegistrationMetadataProvider, getViewportImageCornersInWorld, hasNaNValues, applyPreset, deepMerge, PointsManager, getScalingParameters, colormap, getImageLegacy, ProgressiveIterator, decimate, imageRetrieveMetadataProvider, transferFunctionUtils, updateVTKImageDataWithCornerstoneImage, sortImageIdsAndGetSpacing, makeVolumeMetadata, isValidVolume, genericMetadataProvider, isVideoTransferSyntax, HistoryMemo, generateVolumePropsFromImageIds, getBufferConfiguration, VoxelManager, RLEVoxelMap, convertStackToVolumeViewport, convertVolumeToStackViewport, roundNumber, roundToPrecision, getViewportImageIds, getRandomSampleFromArray, getVolumeId, color, hasFloatScalingParameters, getDynamicVolumeInfo, autoLoad, scaleArray, deepClone, splitImageIdsBy4DTags, pointInShapeCallback, deepEqual, jumpToSlice, scroll, clip, transformWorldToIndexContinuous, createSubVolume, getVolumeDirectionVectors, calculateSpacingBetweenImageIds, getImageDataMetadata, buildMetadata, calculateNeighborhoodStats, asArray, };
+export { FrameRange, eventListener, csUtils as invertRgbTransferFunction, createSigmoidRGBTransferFunction, getVoiFromSigmoidRGBTransferFunction, createLinearRGBTransferFunction, scaleRgbTransferFunction, triggerEvent, imageIdToURI, fnv1aHash, calibratedPixelSpacingMetadataProvider, clamp, uuidv4, getMinMax, getRuntimeId, isOpposite, getViewportModality, windowLevel, convertToGrayscale, getClosestImageId, getSpacingInNormalDirection, getTargetVolumeAndSpacingInNormalDir, getVolumeActorCorners, indexWithinDimensions, getVolumeViewportsContainingSameVolumes, getViewportsWithVolumeId, transformWorldToIndex, transformIndexToWorld, loadImageToCanvas, renderToCanvasCPU, renderToCanvasGPU, worldToImageCoords, imageToWorldCoords, getVolumeSliceRangeInfo, getVolumeViewportScrollInfo, getSliceRange, snapFocalPointToSlice, getImageSliceDataForVolumeViewport, isImageActor, isPTPrescaledWithSUV, actorIsA, getViewportsWithImageURI, getClosestStackImageIndexForPoint, getCurrentVolumeViewportSlice, calculateViewportsSpatialRegistration, spatialRegistrationMetadataProvider, getViewportImageCornersInWorld, hasNaNValues, applyPreset, deepMerge, PointsManager, getScalingParameters, colormap, getImageLegacy, ProgressiveIterator, decimate, imageRetrieveMetadataProvider, transferFunctionUtils, updateVTKImageDataWithCornerstoneImage, sortImageIdsAndGetSpacing, makeVolumeMetadata, isValidVolume, genericMetadataProvider, isVideoTransferSyntax, HistoryMemo, generateVolumePropsFromImageIds, getBufferConfiguration, VoxelManager, RLEVoxelMap, convertStackToVolumeViewport, convertVolumeToStackViewport, roundNumber, roundToPrecision, getViewportImageIds, getRandomSampleFromArray, getVolumeId, color, hasFloatScalingParameters, getDynamicVolumeInfo, autoLoad, scaleArray, deepClone, splitImageIdsBy4DTags, handleMultiframe4D, generateFrameImageId, pointInShapeCallback, deepEqual, jumpToSlice, scroll, clip, transformWorldToIndexContinuous, createSubVolume, getVolumeDirectionVectors, calculateSpacingBetweenImageIds, getImageDataMetadata, buildMetadata, calculateNeighborhoodStats, asArray, };

package/dist/esm/utilities/index.js

@@ -83,7 +83,7 @@ import cache from '../cache/cache';
 import getDynamicVolumeInfo from './getDynamicVolumeInfo';
 import autoLoad from './autoLoad';
 import scaleArray from './scaleArray';
-import splitImageIdsBy4DTags from './splitImageIdsBy4DTags';
+import splitImageIdsBy4DTags, { handleMultiframe4D, generateFrameImageId, } from './splitImageIdsBy4DTags';
 import { deepClone } from './deepClone';
 import { jumpToSlice } from './jumpToSlice';
 import scroll from './scroll';
@@ -98,4 +98,4 @@ import { asArray } from './asArray';
 export { updatePlaneRestriction } from './updatePlaneRestriction';
 const getViewportModality = (viewport, volumeId) => _getViewportModality(viewport, volumeId, cache.getVolume);
 export * from './isEqual';
-export { FrameRange, eventListener, csUtils as invertRgbTransferFunction, createSigmoidRGBTransferFunction, getVoiFromSigmoidRGBTransferFunction, createLinearRGBTransferFunction, scaleRgbTransferFunction, triggerEvent, imageIdToURI, fnv1aHash, calibratedPixelSpacingMetadataProvider, clamp, uuidv4, getMinMax, getRuntimeId, isOpposite, getViewportModality, windowLevel, convertToGrayscale, getClosestImageId, getSpacingInNormalDirection, getTargetVolumeAndSpacingInNormalDir, getVolumeActorCorners, indexWithinDimensions, getVolumeViewportsContainingSameVolumes, getViewportsWithVolumeId, transformWorldToIndex, transformIndexToWorld, loadImageToCanvas, renderToCanvasCPU, renderToCanvasGPU, worldToImageCoords, imageToWorldCoords, getVolumeSliceRangeInfo, getVolumeViewportScrollInfo, getSliceRange, snapFocalPointToSlice, getImageSliceDataForVolumeViewport, isImageActor, isPTPrescaledWithSUV, actorIsA, getViewportsWithImageURI, getClosestStackImageIndexForPoint, getCurrentVolumeViewportSlice, calculateViewportsSpatialRegistration, spatialRegistrationMetadataProvider, getViewportImageCornersInWorld, hasNaNValues, applyPreset, deepMerge, PointsManager, getScalingParameters, colormap, getImageLegacy, ProgressiveIterator, decimate, imageRetrieveMetadataProvider, transferFunctionUtils, updateVTKImageDataWithCornerstoneImage, sortImageIdsAndGetSpacing, makeVolumeMetadata, isValidVolume, genericMetadataProvider, isVideoTransferSyntax, HistoryMemo, generateVolumePropsFromImageIds, getBufferConfiguration, VoxelManager, RLEVoxelMap, convertStackToVolumeViewport, convertVolumeToStackViewport, roundNumber, roundToPrecision, getViewportImageIds, getRandomSampleFromArray, getVolumeId, color, hasFloatScalingParameters, getDynamicVolumeInfo, autoLoad, scaleArray, deepClone, splitImageIdsBy4DTags, pointInShapeCallback, deepEqual, jumpToSlice, scroll, clip, transformWorldToIndexContinuous, createSubVolume, getVolumeDirectionVectors, calculateSpacingBetweenImageIds, getImageDataMetadata, buildMetadata, calculateNeighborhoodStats, asArray, };
+export { FrameRange, eventListener, csUtils as invertRgbTransferFunction, createSigmoidRGBTransferFunction, getVoiFromSigmoidRGBTransferFunction, createLinearRGBTransferFunction, scaleRgbTransferFunction, triggerEvent, imageIdToURI, fnv1aHash, calibratedPixelSpacingMetadataProvider, clamp, uuidv4, getMinMax, getRuntimeId, isOpposite, getViewportModality, windowLevel, convertToGrayscale, getClosestImageId, getSpacingInNormalDirection, getTargetVolumeAndSpacingInNormalDir, getVolumeActorCorners, indexWithinDimensions, getVolumeViewportsContainingSameVolumes, getViewportsWithVolumeId, transformWorldToIndex, transformIndexToWorld, loadImageToCanvas, renderToCanvasCPU, renderToCanvasGPU, worldToImageCoords, imageToWorldCoords, getVolumeSliceRangeInfo, getVolumeViewportScrollInfo, getSliceRange, snapFocalPointToSlice, getImageSliceDataForVolumeViewport, isImageActor, isPTPrescaledWithSUV, actorIsA, getViewportsWithImageURI, getClosestStackImageIndexForPoint, getCurrentVolumeViewportSlice, calculateViewportsSpatialRegistration, spatialRegistrationMetadataProvider, getViewportImageCornersInWorld, hasNaNValues, applyPreset, deepMerge, PointsManager, getScalingParameters, colormap, getImageLegacy, ProgressiveIterator, decimate, imageRetrieveMetadataProvider, transferFunctionUtils, updateVTKImageDataWithCornerstoneImage, sortImageIdsAndGetSpacing, makeVolumeMetadata, isValidVolume, genericMetadataProvider, isVideoTransferSyntax, HistoryMemo, generateVolumePropsFromImageIds, getBufferConfiguration, VoxelManager, RLEVoxelMap, convertStackToVolumeViewport, convertVolumeToStackViewport, roundNumber, roundToPrecision, getViewportImageIds, getRandomSampleFromArray, getVolumeId, color, hasFloatScalingParameters, getDynamicVolumeInfo, autoLoad, scaleArray, deepClone, splitImageIdsBy4DTags, handleMultiframe4D, generateFrameImageId, pointInShapeCallback, deepEqual, jumpToSlice, scroll, clip, transformWorldToIndexContinuous, createSubVolume, getVolumeDirectionVectors, calculateSpacingBetweenImageIds, getImageDataMetadata, buildMetadata, calculateNeighborhoodStats, asArray, };

package/dist/esm/utilities/splitImageIdsBy4DTags.d.ts

@@ -1,5 +1,12 @@
+interface MultiframeSplitResult {
+    imageIdGroups: string[][];
+    splittingTag: string;
+}
+declare function generateFrameImageId(baseImageId: string, frameNumber: number): string;
+declare function handleMultiframe4D(imageIds: string[]): MultiframeSplitResult | null;
 declare function splitImageIdsBy4DTags(imageIds: string[]): {
     imageIdGroups: string[][];
     splittingTag: string | null;
 };
 export default splitImageIdsBy4DTags;
+export { handleMultiframe4D, generateFrameImageId };

package/dist/esm/utilities/splitImageIdsBy4DTags.js

@@ -1,4 +1,72 @@
 import * as metaData from '../metaData';
+function generateFrameImageId(baseImageId, frameNumber) {
+    const framePattern = /\/frames\/\d+/;
+    if (!framePattern.test(baseImageId)) {
+        throw new Error(`generateFrameImageId: baseImageId must contain a "/frames/" pattern followed by a digit. ` +
+            `Expected format: e.g., "wadouri:http://example.com/image/frames/1" or "wadors:/path/to/image.dcm/frames/1". ` +
+            `Received: ${baseImageId}`);
+    }
+    return baseImageId.replace(framePattern, `/frames/${frameNumber}`);
+}
+function handleMultiframe4D(imageIds) {
+    if (!imageIds || imageIds.length === 0) {
+        return null;
+    }
+    const baseImageId = imageIds[0];
+    const instance = metaData.get('instance', baseImageId);
+    if (!instance) {
+        return null;
+    }
+    const numberOfFrames = instance.NumberOfFrames;
+    if (!numberOfFrames || numberOfFrames <= 1) {
+        return null;
+    }
+    const timeSlotVector = instance.TimeSlotVector;
+    if (!timeSlotVector || !Array.isArray(timeSlotVector)) {
+        return null;
+    }
+    const sliceVector = instance.SliceVector;
+    const numberOfSlices = instance.NumberOfSlices;
+    if (timeSlotVector.length !== numberOfFrames) {
+        console.warn('TimeSlotVector length does not match NumberOfFrames:', timeSlotVector.length, 'vs', numberOfFrames);
+        return null;
+    }
+    if (sliceVector) {
+        if (!Array.isArray(sliceVector)) {
+            console.warn('SliceVector exists but is not an array. Expected length:', numberOfFrames);
+            return null;
+        }
+        if (sliceVector.length !== numberOfFrames ||
+            sliceVector.some((val) => val === undefined)) {
+            console.warn('SliceVector exists but has invalid length or undefined entries. Expected length:', numberOfFrames, 'Actual length:', sliceVector.length);
+            return null;
+        }
+    }
+    const timeSlotGroups = new Map();
+    for (let frameIndex = 0; frameIndex < numberOfFrames; frameIndex++) {
+        const timeSlot = timeSlotVector[frameIndex];
+        const sliceIndex = sliceVector?.[frameIndex] ?? frameIndex;
+        if (!timeSlotGroups.has(timeSlot)) {
+            timeSlotGroups.set(timeSlot, []);
+        }
+        timeSlotGroups.get(timeSlot).push({ frameIndex, sliceIndex });
+    }
+    const sortedTimeSlots = Array.from(timeSlotGroups.keys()).sort((a, b) => a - b);
+    const imageIdGroups = sortedTimeSlots.map((timeSlot) => {
+        const frames = timeSlotGroups.get(timeSlot);
+        frames.sort((a, b) => a.sliceIndex - b.sliceIndex);
+        return frames.map((frame) => generateFrameImageId(baseImageId, frame.frameIndex + 1));
+    });
+    const expectedSlicesPerTimeSlot = numberOfSlices || imageIdGroups[0]?.length;
+    const allGroupsHaveSameLength = imageIdGroups.every((group) => group.length === expectedSlicesPerTimeSlot);
+    if (!allGroupsHaveSameLength) {
+        console.warn('Multiframe 4D split resulted in uneven time slot groups. Expected', expectedSlicesPerTimeSlot, 'slices per time slot.');
+    }
+    return {
+        imageIdGroups,
+        splittingTag: 'TimeSlotVector',
+    };
+}
 const groupBy = (array, key) => {
     return array.reduce((rv, x) => {
         (rv[x[key]] = rv[x[key]] || []).push(x);
@@ -120,6 +188,10 @@ function getPetFrameReferenceTime(imageId) {
     return moduleInfo ? moduleInfo['frameReferenceTime'] : 0;
 }
 function splitImageIdsBy4DTags(imageIds) {
+    const multiframeResult = handleMultiframe4D(imageIds);
+    if (multiframeResult) {
+        return multiframeResult;
+    }
     const positionGroups = getIPPGroups(imageIds);
     if (!positionGroups) {
         return { imageIdGroups: [imageIds], splittingTag: null };
@@ -159,3 +231,4 @@ function splitImageIdsBy4DTags(imageIds) {
     return { imageIdGroups: [imageIds], splittingTag: null };
 }
 export default splitImageIdsBy4DTags;
+export { handleMultiframe4D, generateFrameImageId };

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const version = "4.15.0";
+export declare const version = "4.15.2";

package/dist/esm/version.js

@@ -1 +1 @@
-export const version = '4.15.0';
+export const version = '4.15.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cornerstonejs/core",
-  "version": "4.15.0",
+  "version": "4.15.2",
   "description": "Cornerstone3D Core",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -97,5 +97,5 @@
     "type": "individual",
     "url": "https://ohif.org/donate"
   },
-  "gitHead": "e115fd3cf5e0fe7c0f1f216f3d1bda0d05e9ea14"
+  "gitHead": "c18cad49aa3f5276bd5251b81843437bee76e552"
 }