cloudmr-ux 4.3.3 → 4.3.5

package/dist/CmrComponents/niivue-roi-histogram/NiivueRoiHistogram.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+export interface NiivueRoiHistogramProps {
+    /** DOM id used by `resampleNiivueRoiHistogram` / `document.getElementById`. Default: `histoplot`. */
+    plotElementId?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Mount point for the Plotly ROI histogram. Default id `histoplot` matches MROptimum WebGUI.
+ */
+export declare function NiivueRoiHistogram(props: NiivueRoiHistogramProps): import("react/jsx-runtime").JSX.Element;

package/dist/CmrComponents/niivue-roi-histogram/NiivueRoiHistogram.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Mount point for the Plotly ROI histogram. Default id `histoplot` matches MROptimum WebGUI.
+ */
+export function NiivueRoiHistogram(props) {
+    var _a;
+    var id = (_a = props.plotElementId) !== null && _a !== void 0 ? _a : "histoplot";
+    return (_jsx("div", { id: id, className: props.className, style: props.style }));
+}

package/dist/CmrComponents/niivue-roi-histogram/resampleNiivueRoiHistogram.d.ts

@@ -0,0 +1,29 @@
+import type { Layout } from "plotly.js-dist-min";
+/** Maps Niivue label index (e.g. "1".."7") to a display name in the legend / ROI table. */
+export type RoiLabelMapping = Record<string, string>;
+export interface NiivueRoiHistogramRow {
+    label: string;
+    alias: string;
+    visibility: boolean;
+    color: string;
+    mu: number;
+    std: number;
+    opacity: number;
+    count: number;
+    sample: number[];
+}
+/** Plotly layout matching MROptimum WebGUI ROI histogram defaults. */
+export declare function getDefaultRoiHistogramLayout(): Partial<Layout>;
+/**
+ * Recomputes per-ROI voxel samples from the Niivue instance, updates the Plotly histogram
+ * at `plotRoot`, and returns the row data for tables / export.
+ *
+ * @returns `null` if `plotRoot` is missing (caller should retain prior ROI state), otherwise
+ *          the new ROI rows (empty when drawing was cleared).
+ */
+export declare function resampleNiivueRoiHistogram(options: {
+    nv: any;
+    labelMapping?: RoiLabelMapping;
+    plotRoot: HTMLElement | null | undefined;
+    layout?: Partial<Layout>;
+}): NiivueRoiHistogramRow[] | null;

package/dist/CmrComponents/niivue-roi-histogram/resampleNiivueRoiHistogram.js

@@ -0,0 +1,134 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import Plotly from "plotly.js-dist-min";
+import { calculateMean, calculateStandardDeviation } from "./roiHistogramStats";
+var ROI_HISTOGRAM_COLORS = [
+    "#bbb",
+    "#f00",
+    "#0f0",
+    "#00f",
+    "yellow",
+    "cyan",
+    "#e81ce8",
+    "#e8dbc7",
+];
+/** Plotly layout matching MROptimum WebGUI ROI histogram defaults. */
+export function getDefaultRoiHistogramLayout() {
+    return {
+        barmode: "overlay",
+        title: { text: "ROI Histogram" },
+        margin: {
+            l: 50,
+            r: 50,
+            b: 50,
+            t: 60,
+            pad: 4
+        },
+        xaxis: {
+            title: { text: "Voxel value" },
+            showgrid: true
+        },
+        yaxis: {
+            title: { text: "Bin frequency" },
+            showgrid: true
+        }
+    };
+}
+/**
+ * Recomputes per-ROI voxel samples from the Niivue instance, updates the Plotly histogram
+ * at `plotRoot`, and returns the row data for tables / export.
+ *
+ * @returns `null` if `plotRoot` is missing (caller should retain prior ROI state), otherwise
+ *          the new ROI rows (empty when drawing was cleared).
+ */
+export function resampleNiivueRoiHistogram(options) {
+    var _a, _b, _c, _d;
+    var nv = options.nv, _e = options.labelMapping, labelMapping = _e === void 0 ? {} : _e, plotRoot = options.plotRoot, layoutOverrides = options.layout;
+    if (typeof document === "undefined" || !plotRoot) {
+        return null;
+    }
+    var image = (_a = nv.volumes) === null || _a === void 0 ? void 0 : _a[0];
+    var layout = __assign(__assign({}, getDefaultRoiHistogramLayout()), layoutOverrides);
+    if (nv.drawBitmap == null) {
+        Plotly.newPlot(plotRoot, [], layout, { responsive: true });
+        return [];
+    }
+    if (!image) {
+        return null;
+    }
+    var min = image.robust_min;
+    var max = image.robust_max;
+    var samples = {
+        1: [],
+        2: [],
+        3: [],
+        4: [],
+        5: [],
+        6: [],
+        7: []
+    };
+    for (var i = 0; i < nv.drawBitmap.length; i++) {
+        var k = nv.drawBitmap[i];
+        if (samples[k] === undefined) {
+            samples[k] = [];
+        }
+        samples[k].push(image.img[i]);
+    }
+    if (nv.hiddenBitmap !== undefined) {
+        for (var i = 0; i < nv.hiddenBitmap.length; i++) {
+            var k = nv.hiddenBitmap[i];
+            if (samples[k] === undefined) {
+                samples[k] = [];
+            }
+            samples[k].push(image.img[i]);
+        }
+    }
+    var rois = [];
+    for (var sk in samples) {
+        var key = Number(sk);
+        var sample = samples[key];
+        if (sample.length > 0 && key > 0) {
+            rois.push({
+                label: String(key),
+                alias: (_c = (_b = labelMapping[sk]) !== null && _b !== void 0 ? _b : labelMapping[String(key)]) !== null && _c !== void 0 ? _c : String(key),
+                visibility: nv.getLabelVisibility(Number(key)),
+                color: (_d = ROI_HISTOGRAM_COLORS[key]) !== null && _d !== void 0 ? _d : ROI_HISTOGRAM_COLORS[0],
+                mu: calculateMean(sample),
+                std: calculateStandardDeviation(sample),
+                opacity: nv.drawOpacity,
+                count: sample.length,
+                sample: sample
+            });
+        }
+    }
+    var traces = [];
+    for (var _i = 0, rois_1 = rois; _i < rois_1.length; _i++) {
+        var roi = rois_1[_i];
+        traces.push({
+            x: roi.sample,
+            type: "histogram",
+            name: roi.alias,
+            opacity: roi.visibility ? 0.5 : 0.1,
+            marker: {
+                color: roi.color
+            },
+            autobinx: false,
+            xbins: {
+                start: min,
+                end: max,
+                size: (max - min) / 100
+            }
+        });
+    }
+    Plotly.newPlot(plotRoot, traces, layout, { responsive: true });
+    return rois;
+}

package/dist/CmrComponents/niivue-roi-histogram/roiHistogramStats.d.ts

@@ -0,0 +1,2 @@
+export declare function calculateMean(numbers: number[]): number;
+export declare function calculateStandardDeviation(numbers: number[]): number;

package/dist/CmrComponents/niivue-roi-histogram/roiHistogramStats.js

@@ -0,0 +1,13 @@
+export function calculateMean(numbers) {
+    var sum = numbers.reduce(function (acc, val) { return acc + val; }, 0);
+    return sum / numbers.length;
+}
+export function calculateStandardDeviation(numbers) {
+    var mean = calculateMean(numbers);
+    var squareDiffs = numbers.map(function (value) {
+        var diff = value - mean;
+        return diff * diff;
+    });
+    var avgSquareDiff = calculateMean(squareDiffs);
+    return Math.sqrt(avgSquareDiff);
+}

package/dist/CmrComponents/niivue-roi-histogram/useNiivueRoiHistogram.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="react" />
+import type { Layout } from "plotly.js-dist-min";
+import { type NiivueRoiHistogramRow, type RoiLabelMapping } from "./resampleNiivueRoiHistogram";
+export declare function useNiivueRoiHistogram(nv: any, options?: {
+    plotElementId?: string;
+    /** Optional Plotly layout overrides passed through to each resample. */
+    layout?: Partial<Layout>;
+}): {
+    rois: NiivueRoiHistogramRow[];
+    setRois: import("react").Dispatch<import("react").SetStateAction<NiivueRoiHistogramRow[]>>;
+    labelMapping: RoiLabelMapping;
+    setLabelMapping: import("react").Dispatch<import("react").SetStateAction<RoiLabelMapping>>;
+    resample: (mapping?: RoiLabelMapping) => void;
+};

package/dist/CmrComponents/niivue-roi-histogram/useNiivueRoiHistogram.js

@@ -0,0 +1,31 @@
+import { useCallback, useState } from "react";
+import { resampleNiivueRoiHistogram, } from "./resampleNiivueRoiHistogram";
+export function useNiivueRoiHistogram(nv, options) {
+    var _a;
+    var plotElementId = (_a = options === null || options === void 0 ? void 0 : options.plotElementId) !== null && _a !== void 0 ? _a : "histoplot";
+    var layout = options === null || options === void 0 ? void 0 : options.layout;
+    var _b = useState({}), labelMapping = _b[0], setLabelMapping = _b[1];
+    var _c = useState([]), rois = _c[0], setRois = _c[1];
+    var resample = useCallback(function (mapping) {
+        if (mapping === void 0) { mapping = labelMapping; }
+        var el = typeof document !== "undefined"
+            ? document.getElementById(plotElementId)
+            : null;
+        var next = resampleNiivueRoiHistogram({
+            nv: nv,
+            labelMapping: mapping,
+            plotRoot: el,
+            layout: layout
+        });
+        if (next !== null) {
+            setRois(next);
+        }
+    }, [nv, labelMapping, plotElementId, layout]);
+    return {
+        rois: rois,
+        setRois: setRois,
+        labelMapping: labelMapping,
+        setLabelMapping: setLabelMapping,
+        resample: resample
+    };
+}

package/dist/index.d.ts

@@ -27,6 +27,10 @@ export { NiivueContrastAdjustments } from "./CmrComponents/niivue-contrast-adjus
 export type { NiivueContrastAdjustmentsProps } from "./CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments";
 export { DrawToolkit } from "./CmrComponents/draw-toolkit/DrawToolkit";
 export type { DrawToolkitProps } from "./CmrComponents/draw-toolkit/DrawToolkit";
+export { resampleNiivueRoiHistogram, getDefaultRoiHistogramLayout, } from "./CmrComponents/niivue-roi-histogram/resampleNiivueRoiHistogram";
+export type { NiivueRoiHistogramRow, RoiLabelMapping, } from "./CmrComponents/niivue-roi-histogram/resampleNiivueRoiHistogram";
+export { NiivueRoiHistogram } from "./CmrComponents/niivue-roi-histogram/NiivueRoiHistogram";
+export { useNiivueRoiHistogram } from "./CmrComponents/niivue-roi-histogram/useNiivueRoiHistogram";
 import type { FC } from "react";
 import type { CmrTableProps } from "./CmrTable/CmrTable";
 export declare const CmrTable: FC<CmrTableProps>;

package/dist/index.js

@@ -25,6 +25,9 @@ export { InvertibleDualSlider } from "./CmrComponents/double-slider/InvertibleDu
 export { NiivueSlicePosition } from "./CmrComponents/niivue-slice-position/NiivueSlicePosition";
 export { NiivueContrastAdjustments } from "./CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments";
 export { DrawToolkit } from "./CmrComponents/draw-toolkit/DrawToolkit";
+export { resampleNiivueRoiHistogram, getDefaultRoiHistogramLayout, } from "./CmrComponents/niivue-roi-histogram/resampleNiivueRoiHistogram";
+export { NiivueRoiHistogram } from "./CmrComponents/niivue-roi-histogram/NiivueRoiHistogram";
+export { useNiivueRoiHistogram } from "./CmrComponents/niivue-roi-histogram/useNiivueRoiHistogram";
 import CmrTableComponent from "./CmrTable/CmrTable";
 export var CmrTable = CmrTableComponent;
 export * from "./core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudmr-ux",
-  "version": "4.3.3",
+  "version": "4.3.5",
   "author": "erosmontin@gmail.com",
   "license": "MIT",
   "repository": "erosmontin/cloudmr-ux",