brainsmatics 1.2.6 → 1.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -1
- package/dist/component/3d/aichat/index.d.ts +0 -1
- package/dist/component/3d/atlasSiderBar/index.d.ts +1 -1
- package/dist/component/3d/auxiliary/ModeSelector.d.ts +10 -0
- package/dist/component/3d/auxiliary/panels.d.ts +34 -0
- package/dist/component/3d/core/brainOutlineTransform.d.ts +10 -0
- package/dist/component/3d/functionLoop/ConnectivityCard.d.ts +2 -4
- package/dist/component/3d/functionLoop/LiteratureModal.d.ts +14 -0
- package/dist/component/3d/functionLoop/index.d.ts +1 -0
- package/dist/component/3d/index.d.ts +1 -0
- package/dist/component/3d/sequenceRegistration/SequenceRegistrationPanel.d.ts +11 -2
- package/dist/component/3d/sequenceRegistration/api.d.ts +4 -4
- package/dist/component/3d/sequenceRegistration/atlasReslicingReference.d.ts +64 -0
- package/dist/component/3d/sequenceRegistration/brainShellConstraint.d.ts +6 -0
- package/dist/component/3d/sequenceRegistration/connection.d.ts +8 -0
- package/dist/component/3d/sequenceRegistration/exportResult.d.ts +4 -0
- package/dist/component/3d/sequenceRegistration/handoff.d.ts +11 -0
- package/dist/component/3d/sequenceRegistration/poseEditor.d.ts +26 -0
- package/dist/component/3d/sequenceRegistration/stamPlane.d.ts +99 -0
- package/dist/component/3d/sequenceRegistration/transformControls.d.ts +4 -0
- package/dist/component/3d/sequenceRegistration/types.d.ts +113 -0
- package/dist/component/3d/sideBar/ExactMatchButton.d.ts +9 -0
- package/dist/component/3d/sideBar/RegionFilterSelect.d.ts +13 -0
- package/dist/component/3d/sideBar/regionSearch.d.ts +21 -0
- package/dist/component/store/auxiliaryPanelStore.d.ts +2 -8
- package/dist/component/store/auxiliaryStore.d.ts +2 -1
- package/dist/component/store/functionLoopStore.d.ts +24 -67
- package/dist/{deflate-B5uvPjLy.js → deflate-CowmveuV.js} +1 -1
- package/dist/{deflate-C2RXIyq6.mjs → deflate-_ZycUeZq.mjs} +1 -1
- package/dist/{index-rnHO1IdP.js → index-DEgHZlr6.js} +572 -572
- package/dist/{index-D_EhKvAR.mjs → index-tBE0HArS.mjs} +81133 -77973
- package/dist/index.js +1 -1
- package/dist/index.mjs +70 -69
- package/dist/{lerc-BibtwHRJ.mjs → lerc-DtHzaIbU.mjs} +1 -1
- package/dist/{lerc-16CE6ylr.js → lerc-LVs7qdot.js} +1 -1
- package/dist/style.css +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -54,7 +54,12 @@ export default function App() {
|
|
|
54
54
|
|
|
55
55
|
- 展示 3D 标准脑图谱。
|
|
56
56
|
- 在同一个 Three.js 场景中展示脑区、核团、血管、神经元等对象。
|
|
57
|
-
-
|
|
57
|
+
- 各场景共用的模型右键菜单仅在右击时打开,并保留当次模型的操作目标;从模型移入菜单后可正常选择,移出菜单卡片、选择菜单项或点击外部后关闭,重新悬停模型不会自动打开。
|
|
58
|
+
- 加载并展示 SWC 神经元形态数据;悬停时红色高亮,移至空白、其他神经元或画布外后恢复原色,快速移开同样生效。
|
|
59
|
+
- SideBar 搜索支持脑区缩写、英文全名和中文名,不区分大小写,忽略首尾及重复空格,支持多个关键词;Neurons 的脑区选项和已选标签仅显示缩写与英文全名,搜索结果优先显示精确匹配。输入搜索词不会修改已选筛选条件。
|
|
60
|
+
- Regions 搜索框内的 `Cc` 小图标用于切换严格匹配,悬浮显示说明,开启后高亮;严格模式仅完整匹配脑区缩写、英文全名或中文名(仍忽略大小写及多余空格)。原样式的放大镜按钮和回车均可立即执行搜索,修改文字仍自动搜索。Neurons 保持原来的下拉输入框样式,不显示 `Cc` 或额外搜索按钮,输入即搜索。
|
|
61
|
+
- 连续输入时,Neurons 脑区框独立维护搜索文本,匹配结果采用低优先级更新,不触发神经元表格重绘;Regions 树只渲染可视区节点,搜索高亮不重建节点标题和颜色选择器。
|
|
62
|
+
- Neurons 的投射脑区支持独立多选:选择 `grey` 等父脑区只保存该节点,不会批量勾选子节点;筛选范围仍覆盖其后代脑区,多选投射条件取并集,与胞体所在脑区条件取交集。投射集合缓存并去重,避免勾选神经元时重复汇总。
|
|
58
63
|
- 将用户上传的数据插入 3D 场景并进行平移、旋转、缩放、调色和透明度调整。
|
|
59
64
|
- 加载 `.tif`、`.tiff` 图像栈,并以体数据方式渲染。
|
|
60
65
|
- 加载 `.nii.gz` 压缩 NIfTI 体数据。
|
|
@@ -66,11 +71,15 @@ export default function App() {
|
|
|
66
71
|
- 支持 TIFF 图像栈体积分析相关工作流。
|
|
67
72
|
- 提供基于 Ant Design X 的 AI 对话界面,支持 Markdown、工具调用结果和图表结果展示。
|
|
68
73
|
- 支持功能环路分析,包括连接关系、基因表达、突触、单神经元等数据展示。
|
|
74
|
+
- 病毒示踪连接使用按端点距离弯曲的贝塞尔弧线,反向连接向另一侧展开,减少共线管道重叠;方向箭头沿曲线切线显示,保留证据数量对应的粗细与强度对应的透明度。鼠标悬停在弧线或自连接点上时高亮且光标变为手势指针,点击可弹出证据来源文献弹窗(与 Knowledge 卡片书籍按钮弹出的文献框一致),支持点击 DOI 跳转原文献。同一脑区到自身、或起终坐标重合的连接显示为单个蓝点,不生成管道、箭头或注射器;蓝点在脑区表面遮挡下仍可见。弧线仅表示脑区连接关系,不代表真实轴突轨迹或手术进针路径。
|
|
69
75
|
- Knowledge 页签跟随全局语言(`en_us` / `zh_cn`)显示中英文:包括脑区选择提示、分析按钮、证据类型、分子指纹/连接卡片、图例、统计、悬浮说明及证据来源弹窗;脑区标识、基因/受体名称和文献内容保持原始数据。
|
|
70
76
|
- Knowledge 基因分布按“基因名(不区分大小写)+脑区”过滤重复圆球和标签;保留原有圆球材质、颜色、透明度和立体文字,标签仍选取该组有 DOI 且影响因子最高的文献。
|
|
71
77
|
- 文献文字不再显示“双击查看”悬浮提示;双击 DOI 跳转保持不变。
|
|
72
78
|
- 文献立体文字在加入场景时立即对齐相机,字体首次异步加载和命中缓存时均生效,无需先操作场景。
|
|
73
79
|
- 突触受体预览使用非负的固定随机种子计算球面偏移,避免部分受体(如 `beta2-containing nAChRs`)生成 NaN 坐标而无法显示。
|
|
80
|
+
- Knowledge 子项小眼睛、类型总开关及 AI 展示共用同一份选中状态:单次操作不会重复绘制,AI 展示后可直接用小眼睛关闭。神经递质/受体分布与突触连接独立控制,关闭一类不会改变另一类。
|
|
81
|
+
- 分析、连接展示及基因/受体预览复用现有 Loading 遮罩;并发或嵌套加载全部结束后才收起,失败时释放 loading 并提示错误。关闭或清空展示会取消在途预览,迟到的数据不会重新显示。
|
|
82
|
+
- `FunctionLoop` controller 的 `loadMethodData`、`previewGene`、`previewReceptor` 返回 `Promise<void>`,调用方应等待展示完成并处理失败;`removeGroupData` 同时更新场景与开关状态。
|
|
74
83
|
|
|
75
84
|
## 主要导出
|
|
76
85
|
|
|
@@ -103,6 +112,17 @@ import {
|
|
|
103
112
|
|
|
104
113
|
这些组件主要用于完整的 3D 神经科学工作台。部分组件需要宿主应用提供 Three.js 的 renderer、camera、scene、controls、图谱状态、回调函数或后端接口。
|
|
105
114
|
|
|
115
|
+
#### 右侧功能面板导航
|
|
116
|
+
|
|
117
|
+
- 模式选择器由 `Auxiliary` 内部渲染,与下方 Tabs 共用宽度和纵向布局;宿主不再另放一条绝对定位的模式栏。英文、长译文和放大字体可以换行,折叠后模式选项纵向排列。未配置对应工具的模式不可选。
|
|
118
|
+
- 普通面板内容保持左右等量留白,清除右侧 Tabs 默认的额外页内边距。Knowledge 卡片使用完整内容宽度,其高度跟随 Tabs 的实际可用空间,不再按视口减固定值计算;只有内容超长时由 Knowledge 自身滚动,外层不叠加滚动条。
|
|
119
|
+
- `src/component/3d/auxiliary/panels.ts` 集中维护 `AuxiliaryPanelId`、工具名、URL 类型、页面标题及引导信息。新增面板时先更新此注册表,再添加对应内容,不要另建 index/URL 映射。
|
|
120
|
+
- 代码入口使用公开导出的 `AuxiliaryPanelId`,通过 `task3DStore.auxiliary.controller?.tabChange(AuxiliaryPanelId.FunctionalLoop)`(或 `Auxiliary` ref 上同一 controller)切换。已选页签不会重复重置;离开面板只清理该功能的临时对象,不清空核团、血管、神经元选择。直接设置 `rightTabIndex` 不是功能切换入口。
|
|
121
|
+
- 初始链接按 `rightTab` → `rightTabIndex` → `type` → `index` → 首个可用面板的优先级解析,并检查工具配置和模式。已有数字 ID、`type=slicing`、`index=Slicing` 等链接仍可打开;`rightTab=sequence-registration` 可直接打开序列配准。显式面板优先于旧链接残留的模式值。
|
|
122
|
+
- 切换后统一写入分享链接缓冲区的 `rightTab`、`rightTabIndex`、`type`、`mode`,移除旧引导 `index`;与原有分享机制一致,不修改浏览器地址栏。功能环路不会再落入体积分析的 URL/标题分支。
|
|
123
|
+
- 引导只维护一个 `activeTour` 面板 ID。旧链接的 `index` 只触发实际打开面板的引导,并遵守原有“不再显示”设置;工具栏引导入口可手动重新打开当前面板的引导。切换面板会关闭旧引导,长引导内容在视口内滚动。
|
|
124
|
+
|
|
125
|
+
|
|
106
126
|
### 2D 组件
|
|
107
127
|
|
|
108
128
|
```tsx
|
|
@@ -61,7 +61,6 @@ interface SideBarProps {
|
|
|
61
61
|
childRef?: React.MutableRefObject<undefined>;
|
|
62
62
|
setEchartValue?: React.Dispatch<React.SetStateAction<string>>;
|
|
63
63
|
echartValue?: string;
|
|
64
|
-
auxRef?: React.MutableRefObject<any>;
|
|
65
64
|
PointShow?: React.MutableRefObject<{
|
|
66
65
|
start: boolean;
|
|
67
66
|
end: boolean;
|
|
@@ -87,6 +86,7 @@ interface SideBarProps {
|
|
|
87
86
|
pluginTreeDatas?: dataType[];
|
|
88
87
|
pluginRegionData?: string;
|
|
89
88
|
pluginRegionFiles?: string[];
|
|
89
|
+
rightTabIndex?: number;
|
|
90
90
|
}
|
|
91
91
|
export declare let sphereflag: boolean;
|
|
92
92
|
declare const AtlasSideBar: React.FC<SideBarProps>;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
export interface AuxiliaryModeSelectorProps {
|
|
3
|
+
mode: number;
|
|
4
|
+
onChange: (mode: number) => void;
|
|
5
|
+
expanded: boolean;
|
|
6
|
+
availableModes?: readonly number[];
|
|
7
|
+
t: (key: string) => string;
|
|
8
|
+
}
|
|
9
|
+
declare const AuxiliaryModeSelector: React.FC<AuxiliaryModeSelectorProps>;
|
|
10
|
+
export default AuxiliaryModeSelector;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export declare enum AuxiliaryPanelId {
|
|
2
|
+
Assembling = 1,
|
|
3
|
+
VirtualSurgery = 2,
|
|
4
|
+
Reslicing = 3,
|
|
5
|
+
Registration = 4,
|
|
6
|
+
Download = 5,
|
|
7
|
+
Mapping = 6,
|
|
8
|
+
Connectivity = 7,
|
|
9
|
+
NeuronAnalysis = 10,
|
|
10
|
+
FunctionalLoop = 12,
|
|
11
|
+
VolumeAnalysis = 13,
|
|
12
|
+
TerminalAnalysis = 14,
|
|
13
|
+
SequenceRegistration = 15
|
|
14
|
+
}
|
|
15
|
+
export interface AuxiliaryPanelDefinition {
|
|
16
|
+
readonly id: AuxiliaryPanelId;
|
|
17
|
+
readonly tool: string;
|
|
18
|
+
readonly urlType: string;
|
|
19
|
+
readonly title: string;
|
|
20
|
+
readonly tour?: {
|
|
21
|
+
readonly storageKey: string;
|
|
22
|
+
readonly urlIndex: string;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
export declare const AUXILIARY_PANELS: readonly AuxiliaryPanelDefinition[];
|
|
26
|
+
export declare function getPanel(id: number | string): AuxiliaryPanelDefinition | undefined;
|
|
27
|
+
export declare function resolveInitialMode(params: URLSearchParams, fallback?: number): number;
|
|
28
|
+
export declare function isPanelAvailable(id: AuxiliaryPanelId, tools: readonly string[], mode: number): boolean;
|
|
29
|
+
export declare function resolveInitialPanel(params: URLSearchParams, tools: readonly string[], mode: number): AuxiliaryPanelId | undefined;
|
|
30
|
+
export declare function getPanelRoute(id: AuxiliaryPanelId, mode: number): {
|
|
31
|
+
type: string;
|
|
32
|
+
title: string;
|
|
33
|
+
};
|
|
34
|
+
export declare function writePanelParams(params: URLSearchParams, id: AuxiliaryPanelId, mode: number): void;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import * as THREE from "three";
|
|
2
|
+
/** The same model-space -> Viewer transform used by the existing FBX scene. */
|
|
3
|
+
export declare function applyBrainOutlineTransform(object: THREE.Object3D, options?: {
|
|
4
|
+
scale?: number;
|
|
5
|
+
offsetScale?: number;
|
|
6
|
+
translateX?: number;
|
|
7
|
+
translateY?: number;
|
|
8
|
+
translateZ?: number;
|
|
9
|
+
offsetZ?: number;
|
|
10
|
+
}): THREE.Object3D<THREE.Object3DEventMap>;
|
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
import React from 'react';
|
|
2
2
|
import './ConnectivityCard.css';
|
|
3
|
+
import { type LiteratureItem } from './LiteratureModal';
|
|
4
|
+
export type { LiteratureItem };
|
|
3
5
|
interface ProgressSegment {
|
|
4
6
|
value: number;
|
|
5
7
|
color: string;
|
|
6
8
|
count?: number;
|
|
7
9
|
label?: string;
|
|
8
10
|
}
|
|
9
|
-
interface LiteratureItem {
|
|
10
|
-
summary_statement: string;
|
|
11
|
-
DOI: string;
|
|
12
|
-
}
|
|
13
11
|
export interface ProgressItem {
|
|
14
12
|
name: string;
|
|
15
13
|
segments: ProgressSegment[];
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
import './ConnectivityCard.css';
|
|
3
|
+
export interface LiteratureItem {
|
|
4
|
+
summary_statement: string;
|
|
5
|
+
DOI: string;
|
|
6
|
+
}
|
|
7
|
+
export interface LiteratureModalProps {
|
|
8
|
+
open: boolean;
|
|
9
|
+
onCancel: () => void;
|
|
10
|
+
title?: string;
|
|
11
|
+
literature?: LiteratureItem[];
|
|
12
|
+
}
|
|
13
|
+
export declare const LiteratureModal: React.NamedExoticComponent<LiteratureModalProps>;
|
|
14
|
+
export default LiteratureModal;
|
|
@@ -2,6 +2,7 @@ export { default as SideBar } from "./sideBar";
|
|
|
2
2
|
export { default as PipeLine } from "./pipeline";
|
|
3
3
|
export { default as ModalLoader } from "./modalLoader";
|
|
4
4
|
export { default as Auxiliary } from "./auxiliary";
|
|
5
|
+
export { AuxiliaryPanelId } from "./auxiliary/panels";
|
|
5
6
|
export { default as AiViewer } from "./aichat";
|
|
6
7
|
export { default as Sections } from "./section";
|
|
7
8
|
export { default as StlLoader, type StlLoaderProps } from "./stlLoader";
|
|
@@ -1,12 +1,21 @@
|
|
|
1
1
|
import React from "react";
|
|
2
|
+
import type { SequenceLivePose, SequenceVolumeGeometry } from "./stamPlane";
|
|
2
3
|
import type { SequenceDisplayMode, SequenceSlice, SequenceTransform, SequenceTransformMode } from "./types";
|
|
3
4
|
import "./index.css";
|
|
4
5
|
interface Props {
|
|
5
|
-
onShowSlice?: (slice: SequenceSlice, mode: SequenceDisplayMode) => void
|
|
6
|
+
onShowSlice?: (slice: SequenceSlice, mode: SequenceDisplayMode) => void | Promise<void>;
|
|
6
7
|
onHideSlice?: (sliceId: string) => void;
|
|
8
|
+
onSectionChange?: (slice: SequenceSlice, section: 0 | 1 | 2) => Promise<void>;
|
|
7
9
|
onTransformModeChange?: (mode: SequenceTransformMode) => void;
|
|
8
10
|
onSaveTransform?: (slice: SequenceSlice, transform: SequenceTransform) => Promise<number>;
|
|
9
|
-
onRegisterTransformSaver?: (saver: (sliceId: string, transform: SequenceTransform) => Promise<
|
|
11
|
+
onRegisterTransformSaver?: (saver: (sliceId: string, transform: SequenceTransform) => Promise<number>) => void;
|
|
12
|
+
onRegisterLivePoseListener?: (listener: ((sliceId: string, pose: SequenceLivePose, committed: boolean) => void) | null) => void;
|
|
13
|
+
onSequenceVolumeGeometry?: (geometry: SequenceVolumeGeometry | null) => void;
|
|
14
|
+
onGetExportPose?: (slice: SequenceSlice, size: {
|
|
15
|
+
width: number;
|
|
16
|
+
height: number;
|
|
17
|
+
}) => SequenceLivePose | null;
|
|
18
|
+
onGetLivePose?: (sliceId: string) => SequenceLivePose | null;
|
|
10
19
|
}
|
|
11
20
|
declare const SequenceRegistrationPanel: React.FC<Props>;
|
|
12
21
|
export default SequenceRegistrationPanel;
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { SequenceSession, SequenceSlice, SequenceTransform } from "./types";
|
|
2
|
+
export declare function configureSequenceConnection(token: unknown, loginId: unknown): boolean;
|
|
3
|
+
export declare function clearSequenceConnection(): void;
|
|
2
4
|
export declare function sequenceAuthToken(): string;
|
|
3
5
|
export declare function sequenceRequest<T>(path: string, init?: RequestInit): Promise<T>;
|
|
4
6
|
export declare function sequenceImageBlob(url: string): Promise<Blob>;
|
|
@@ -14,10 +16,8 @@ export declare function updateSequenceSlice(sessionId: string, slice: SequenceSl
|
|
|
14
16
|
export declare function reorderSequenceSlices(sessionId: string, sliceIds: string[]): Promise<{
|
|
15
17
|
ok: boolean;
|
|
16
18
|
}>;
|
|
17
|
-
export declare function submitSequenceRegistration(sessionId: string, slice: SequenceSlice, typeName: string): Promise<SequenceJob>;
|
|
18
|
-
export declare const getSequenceJob: (jobId: string) => Promise<SequenceJob>;
|
|
19
|
-
export declare const retrySequenceJob: (jobId: string) => Promise<SequenceJob>;
|
|
20
19
|
export declare function saveSequenceTransform(sessionId: string, sliceId: string, revision: number, transform: SequenceTransform): Promise<{
|
|
21
20
|
revision: number;
|
|
22
21
|
transform: SequenceTransform;
|
|
23
22
|
}>;
|
|
23
|
+
export declare function deleteSequenceSlice(sessionId: string, sliceId: string): Promise<void>;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/** Coordinate conversions shared with the existing Atlas Reslicing routes. */
|
|
2
|
+
export type AtlasReferencePositionMm = readonly [x: number, y: number, z: number];
|
|
3
|
+
export type AtlasReferenceVoxelXYZ = [x: number, y: number, z: number];
|
|
4
|
+
export interface TargetTifGeometry {
|
|
5
|
+
available: boolean;
|
|
6
|
+
reason?: string;
|
|
7
|
+
atlas_id?: string;
|
|
8
|
+
geometry_revision?: string;
|
|
9
|
+
shape_zyx?: [number, number, number];
|
|
10
|
+
target_volume?: {
|
|
11
|
+
dataset_id?: string;
|
|
12
|
+
dataset_version?: string;
|
|
13
|
+
shape_zyx?: [number, number, number];
|
|
14
|
+
pixel_size_x_um?: number | null;
|
|
15
|
+
pixel_size_y_um?: number | null;
|
|
16
|
+
pixel_size_z_um?: number | null;
|
|
17
|
+
};
|
|
18
|
+
axis_order?: "xyz";
|
|
19
|
+
frame_axis?: "cor";
|
|
20
|
+
coordinate_unit?: "um";
|
|
21
|
+
physical_to_voxel_um?: number[][];
|
|
22
|
+
}
|
|
23
|
+
export type TargetTifFrameMapping = {
|
|
24
|
+
available: false;
|
|
25
|
+
reason: string;
|
|
26
|
+
} | {
|
|
27
|
+
available: true;
|
|
28
|
+
datasetId: string;
|
|
29
|
+
datasetRevision: string;
|
|
30
|
+
mappingId: string;
|
|
31
|
+
frameAxis: "cor";
|
|
32
|
+
voxelXYZ: [number, number, number];
|
|
33
|
+
continuousFrameIndex: number;
|
|
34
|
+
frameIndex: number;
|
|
35
|
+
systemFrame: number;
|
|
36
|
+
frameCount: number;
|
|
37
|
+
mappingType?: "physical-affine" | "reference-resolution-scale";
|
|
38
|
+
referenceResolutionUm?: number;
|
|
39
|
+
targetResolutionUm?: number;
|
|
40
|
+
shapeZYX?: [number, number, number];
|
|
41
|
+
};
|
|
42
|
+
/** Existing standard coronal reference page number (`inp`, 1-based). */
|
|
43
|
+
export declare function coronalReferenceInput(positionZMm: number): number | null;
|
|
44
|
+
/**
|
|
45
|
+
* Position in the legacy higher-resolution reference image coordinate
|
|
46
|
+
* system. These values are voxel-like reference coordinates, not physical
|
|
47
|
+
* micrometers; they must never be fed directly into a physical affine.
|
|
48
|
+
*/
|
|
49
|
+
export declare function atlasReferenceVoxelCoordinates(positionMm: AtlasReferencePositionMm): AtlasReferenceVoxelXYZ | null;
|
|
50
|
+
/** JavaScript parseInt(number.toString()) behavior used by the legacy URL. */
|
|
51
|
+
export declare function truncateAtlasReferencePosition(position: AtlasReferenceVoxelXYZ): AtlasReferenceVoxelXYZ;
|
|
52
|
+
/**
|
|
53
|
+
* Map the 1 µm Atlas Reslicing reference grid to the matching 10 µm
|
|
54
|
+
* annotation volume. This mapping is only valid for the full atlas volume
|
|
55
|
+
* dimensions; cropped or differently sampled TIFFs need a physical affine.
|
|
56
|
+
*/
|
|
57
|
+
export declare function mapAtlasReferencePositionTo10umTif(referenceVoxelXYZ: readonly [number, number, number] | null | undefined, geometry: TargetTifGeometry | null | undefined, sourceAtlasId: string | null | undefined): TargetTifFrameMapping;
|
|
58
|
+
/**
|
|
59
|
+
* Map a canonical STAM physical center (µm) to a target TIFF only when both
|
|
60
|
+
* Atlas ID and geometry revision agree. Legacy reference-image coordinates
|
|
61
|
+
* are intentionally not accepted here because their physical calibration is
|
|
62
|
+
* not established by the old URL formula.
|
|
63
|
+
*/
|
|
64
|
+
export declare function mapAtlasPhysicalPoseToTifFrame(physicalXYZUm: readonly [number, number, number] | null | undefined, geometry: TargetTifGeometry | null | undefined, sourceAtlasId: string | null | undefined, sourceGeometryRevision: string | null | undefined): TargetTifFrameMapping;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import * as THREE from "three";
|
|
2
|
+
export interface BrainShellClampResult {
|
|
3
|
+
point: THREE.Vector3;
|
|
4
|
+
constrained: boolean;
|
|
5
|
+
}
|
|
6
|
+
export declare const clampPointToBrainShell: (root: THREE.Object3D, candidate: THREE.Vector3, previousLegalPoint?: THREE.Vector3 | null) => BrainShellClampResult;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** Storybook's manager owns the opener; its preview iframe uses a narrow bridge. */
|
|
2
|
+
export declare function sequenceLaunchParams(win?: Window): URLSearchParams;
|
|
3
|
+
export declare function sequenceConnection(win?: Window): {
|
|
4
|
+
handoffId: string;
|
|
5
|
+
returnOrigin: string;
|
|
6
|
+
peer: Window;
|
|
7
|
+
transportOrigin: string;
|
|
8
|
+
} | null;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { SequenceLivePose } from "./stamPlane";
|
|
2
|
+
import type { SequenceRegistrationExportV3, SequenceSlice } from "./types";
|
|
3
|
+
export declare function createSequenceExportResult(slice: SequenceSlice, pose: SequenceLivePose, exportId: string): SequenceRegistrationExportV3;
|
|
4
|
+
export declare function mapSequenceExports<T, R>(items: T[], operation: (item: T, index: number) => Promise<R>): Promise<R[]>;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export interface SequenceRegistrationAckExpectation {
|
|
2
|
+
exportId: string;
|
|
3
|
+
sliceId: string;
|
|
4
|
+
}
|
|
5
|
+
export declare function isMatchingSequenceRegistrationAck(data: unknown, expected: SequenceRegistrationAckExpectation, handoffId: string): data is {
|
|
6
|
+
type: "stam.sequence-registration.ack";
|
|
7
|
+
handoffId: string;
|
|
8
|
+
exportId: string;
|
|
9
|
+
sliceId: string;
|
|
10
|
+
accepted: boolean;
|
|
11
|
+
};
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export { sequenceSectionFromAngles } from "./stamPlane";
|
|
2
|
+
import type { SequencePoseGeometry } from "./types";
|
|
3
|
+
type Options = {
|
|
4
|
+
geometry: SequencePoseGeometry;
|
|
5
|
+
shape: number[];
|
|
6
|
+
center: number[];
|
|
7
|
+
angles: number[];
|
|
8
|
+
imageUrl?: string;
|
|
9
|
+
outlineUrl?: string;
|
|
10
|
+
onOutlineStatus?: (status: string) => void;
|
|
11
|
+
onChange: (center: number[], angles: number[]) => void;
|
|
12
|
+
onCommit?: (center: number[], angles: number[]) => void;
|
|
13
|
+
};
|
|
14
|
+
/** Standalone build of the Viewer controls; no auth or annotation state. */
|
|
15
|
+
export declare function mountPoseEditor(host: HTMLElement, options: Options): {
|
|
16
|
+
setPose: (center: number[], angles: number[]) => void;
|
|
17
|
+
setSection: (section: 0 | 1 | 2) => void;
|
|
18
|
+
setSliceImage: (url?: string, definition?: {
|
|
19
|
+
centerVoxelXYZ: number[];
|
|
20
|
+
uExtentVoxelXYZ: number[];
|
|
21
|
+
vExtentVoxelXYZ: number[];
|
|
22
|
+
}) => void;
|
|
23
|
+
fit: () => void;
|
|
24
|
+
setMode: (mode: "translate" | "rotate") => void;
|
|
25
|
+
dispose: () => void;
|
|
26
|
+
};
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import * as THREE from "three";
|
|
2
|
+
import type { SequenceSlice, StamPlane } from "./types";
|
|
3
|
+
import type { TargetTifFrameMapping, TargetTifGeometry } from "./atlasReslicingReference";
|
|
4
|
+
export interface SequenceSlicePose {
|
|
5
|
+
centerMm: [number, number, number];
|
|
6
|
+
orientation: THREE.Quaternion;
|
|
7
|
+
}
|
|
8
|
+
export declare function standardSequenceQuaternion(section: 0 | 1 | 2): THREE.Quaternion;
|
|
9
|
+
export declare function sequenceSectionFromAngles(angles?: number[]): -1 | 0 | 1 | 2;
|
|
10
|
+
export interface AtlasReslicingPose extends SequenceSlicePose {
|
|
11
|
+
angles: [number, number, number];
|
|
12
|
+
}
|
|
13
|
+
export interface SequencePhysicalPose {
|
|
14
|
+
centerUm: [number, number, number];
|
|
15
|
+
uAxis: [number, number, number];
|
|
16
|
+
vAxis: [number, number, number];
|
|
17
|
+
normal: [number, number, number];
|
|
18
|
+
}
|
|
19
|
+
export interface SequenceVolumeGeometry extends TargetTifGeometry {
|
|
20
|
+
}
|
|
21
|
+
type DefaultSequencePlacement = Pick<SequenceSlice, "targetFrame" | "sequenceOrder" | "positionOffsetUm">;
|
|
22
|
+
export interface SequenceLivePose {
|
|
23
|
+
annotationTarget?: {
|
|
24
|
+
datasetId: string;
|
|
25
|
+
datasetVersion: string;
|
|
26
|
+
};
|
|
27
|
+
poseGeometry?: import("./types").SequencePoseGeometry;
|
|
28
|
+
centerMm: [number, number, number];
|
|
29
|
+
/** Scene-local XYZ Euler degrees used by the original high-resolution jump. */
|
|
30
|
+
angles: [number, number, number];
|
|
31
|
+
referenceVoxelXYZ?: [number, number, number];
|
|
32
|
+
referenceVoxelXYZRaw?: [number, number, number];
|
|
33
|
+
referenceInp?: number;
|
|
34
|
+
targetTif?: Extract<TargetTifFrameMapping, {
|
|
35
|
+
available: true;
|
|
36
|
+
}>;
|
|
37
|
+
physicalXYZUm?: [number, number, number];
|
|
38
|
+
uAxis?: [number, number, number];
|
|
39
|
+
vAxis?: [number, number, number];
|
|
40
|
+
normal?: [number, number, number];
|
|
41
|
+
voxelXYZ?: [number, number, number];
|
|
42
|
+
frameAxis?: "cor";
|
|
43
|
+
systemFrame?: number;
|
|
44
|
+
frameIndex?: number;
|
|
45
|
+
tifFrameCount?: number;
|
|
46
|
+
frameCalculationReason?: string;
|
|
47
|
+
atlasId?: string;
|
|
48
|
+
atlasGeometryRevision?: string;
|
|
49
|
+
poseRevision?: string;
|
|
50
|
+
poseSaved?: boolean;
|
|
51
|
+
obliquePlane?: {
|
|
52
|
+
schemaVersion: 1;
|
|
53
|
+
coordinateSpace: "target-tif-voxel-xyz";
|
|
54
|
+
datasetId: string;
|
|
55
|
+
datasetRevision: string;
|
|
56
|
+
mappingId: string;
|
|
57
|
+
centerVoxelXYZ: [number, number, number];
|
|
58
|
+
uExtentVoxelXYZ: [number, number, number];
|
|
59
|
+
vExtentVoxelXYZ: [number, number, number];
|
|
60
|
+
widthPx: number;
|
|
61
|
+
heightPx: number;
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export interface StamGeometryMetadata {
|
|
65
|
+
atlasId: string;
|
|
66
|
+
atlasGeometryRevision: string;
|
|
67
|
+
sliceCoordinateToPhysicalUm: number[];
|
|
68
|
+
}
|
|
69
|
+
export declare function applyStamGeometryMetadata(brain: THREE.Object3D, value: unknown): boolean;
|
|
70
|
+
/**
|
|
71
|
+
* Derive the default coronal plane position from the sequence's one-based
|
|
72
|
+
* target frame and physical spacing. The known 10 µm reference mapping uses
|
|
73
|
+
* the same [-7, +7] mm Z range as Atlas Reslicing; other volumes use their
|
|
74
|
+
* declared physical affine and the Viewer-to-STAM geometry manifest.
|
|
75
|
+
*/
|
|
76
|
+
export declare function getDefaultSequencePlaneCenter(placement: DefaultSequencePlacement, brain: THREE.Object3D, geometry: SequenceVolumeGeometry | null | undefined, fallbackCenter: THREE.Vector3): THREE.Vector3 | null;
|
|
77
|
+
export declare function getSequenceSlicePose(mesh: THREE.Mesh, brain: THREE.Object3D): SequenceSlicePose | null;
|
|
78
|
+
/**
|
|
79
|
+
* Convert a viewer plane to the pose convention used by the slicing API:
|
|
80
|
+
* center in the slicing coordinate frame and XYZ Euler angles after the same
|
|
81
|
+
* +90 degree X correction used by `/c-api/slicing`.
|
|
82
|
+
*/
|
|
83
|
+
export declare function getAtlasReslicingPose(mesh: THREE.Mesh, brain: THREE.Object3D): AtlasReslicingPose | null;
|
|
84
|
+
export declare function getSequenceSlicePhysicalPose(mesh: THREE.Mesh, brain: THREE.Object3D): SequencePhysicalPose | null;
|
|
85
|
+
export declare function getSequenceLivePose(mesh: THREE.Mesh, brain: THREE.Object3D): SequenceLivePose | null;
|
|
86
|
+
/** Export the same geometry used above, rather than making the annotation UI
|
|
87
|
+
* guess the Atlas Euler baseline, scene scale or the TIFF's voxel spacing. */
|
|
88
|
+
export declare function getSequencePoseEditGeometry(mesh: THREE.Mesh, brain: THREE.Object3D, pose: SequenceLivePose): {
|
|
89
|
+
outlineModelMatrix: THREE.Matrix4Tuple;
|
|
90
|
+
schemaVersion: 1;
|
|
91
|
+
voxelFromAtlasLinear: number[][];
|
|
92
|
+
voxelFromViewerAffine: number[][];
|
|
93
|
+
planeAxes: [[number, number, number], [number, number, number]];
|
|
94
|
+
planeSize: [number, number];
|
|
95
|
+
} | undefined;
|
|
96
|
+
export declare function buildStamPlane(mesh: THREE.Mesh, brain: THREE.Object3D): StamPlane | null;
|
|
97
|
+
export declare function hasCurrentStamPlane(plane: StamPlane | undefined, brain: THREE.Object3D): boolean;
|
|
98
|
+
export declare function quaternionFromStamPlane(plane: StamPlane): THREE.Quaternion;
|
|
99
|
+
export {};
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import * as THREE from "three";
|
|
2
|
+
import { TransformControls } from "three/examples/jsm/controls/TransformControls.js";
|
|
3
|
+
/** Shared by the full Viewer and the annotation pose dialog. */
|
|
4
|
+
export declare function createSequenceTransformControls(camera: THREE.Camera, element: HTMLElement, plane: THREE.Object3D, mode: "translate" | "rotate"): TransformControls;
|
|
@@ -3,6 +3,18 @@ export type SequenceJobStatus = "queued" | "processing" | "succeeded" | "failed"
|
|
|
3
3
|
export type SequenceSliceStatus = "uploaded" | "queued" | "processing" | "registered" | "failed" | "stale";
|
|
4
4
|
export type SequenceDisplayMode = "source" | "atlas";
|
|
5
5
|
export type SequenceTransformMode = "translate" | "rotate";
|
|
6
|
+
export interface StamPlane {
|
|
7
|
+
schemaVersion: 1;
|
|
8
|
+
atlasId: string;
|
|
9
|
+
atlasGeometryRevision: string;
|
|
10
|
+
centerUm: [number, number, number];
|
|
11
|
+
uAxis: [number, number, number];
|
|
12
|
+
vAxis: [number, number, number];
|
|
13
|
+
normal: [number, number, number];
|
|
14
|
+
widthPx: number;
|
|
15
|
+
heightPx: number;
|
|
16
|
+
pixelSpacingUm: [number, number];
|
|
17
|
+
}
|
|
6
18
|
export interface SequenceTransform {
|
|
7
19
|
position: {
|
|
8
20
|
x: number;
|
|
@@ -15,7 +27,108 @@ export interface SequenceTransform {
|
|
|
15
27
|
z: number;
|
|
16
28
|
w: number;
|
|
17
29
|
};
|
|
30
|
+
plane?: StamPlane;
|
|
31
|
+
}
|
|
32
|
+
export interface SequenceRegistrationExportV2 {
|
|
33
|
+
schemaVersion: 2;
|
|
34
|
+
sessionId: string;
|
|
35
|
+
sliceId: string;
|
|
36
|
+
filename: string;
|
|
37
|
+
sequenceOrder: number;
|
|
38
|
+
systemFrame: number;
|
|
39
|
+
frameIndex: number;
|
|
40
|
+
tifFrameCount: number;
|
|
41
|
+
frameSource: "atlas-geometry";
|
|
42
|
+
frameVoxelAxis: "Z";
|
|
43
|
+
frameVoxelCoordinate: number;
|
|
44
|
+
frameAxis: "cor";
|
|
45
|
+
angles: [number, number, number];
|
|
46
|
+
angleUnit: "degree";
|
|
47
|
+
angleSource: "atlas-reslicing";
|
|
48
|
+
angleConvention: "atlas-reslicing-xyz";
|
|
49
|
+
physicalCoordinateUnit: "um";
|
|
50
|
+
voxelCoordinateUnit: "voxel";
|
|
51
|
+
centerCoordinateUnit: "mm";
|
|
52
|
+
physicalXYZUm?: [number, number, number];
|
|
53
|
+
voxelXYZ?: [number, number, number];
|
|
54
|
+
centerMm: [number, number, number];
|
|
55
|
+
uAxis?: [number, number, number];
|
|
56
|
+
vAxis?: [number, number, number];
|
|
57
|
+
normal?: [number, number, number];
|
|
58
|
+
atlasId?: string;
|
|
59
|
+
atlasGeometryRevision?: string;
|
|
60
|
+
exportedAt: string;
|
|
61
|
+
}
|
|
62
|
+
export interface SequenceRegistrationExportV3 {
|
|
63
|
+
schemaVersion: 3;
|
|
64
|
+
exportId: string;
|
|
65
|
+
sessionId: string;
|
|
66
|
+
sliceId: string;
|
|
67
|
+
filename: string;
|
|
68
|
+
sequenceOrder: number;
|
|
69
|
+
exportedAt: string;
|
|
70
|
+
/** Snapshot id; `poseSaved` says whether this exact snapshot reached the server. */
|
|
71
|
+
poseRevision: string;
|
|
72
|
+
poseSaved: boolean;
|
|
73
|
+
annotationTarget?: {
|
|
74
|
+
datasetId: string;
|
|
75
|
+
datasetVersion: string;
|
|
76
|
+
};
|
|
77
|
+
/** Mappings sampled from the original Atlas Reslicing geometry, for annotation-side editing. */
|
|
78
|
+
poseGeometry?: SequencePoseGeometry;
|
|
79
|
+
atlasReference: {
|
|
80
|
+
section: "arbitrary";
|
|
81
|
+
referenceInp?: number;
|
|
82
|
+
centerMm: [number, number, number];
|
|
83
|
+
/** Coordinates produced by the existing higher-resolution URL formula. */
|
|
84
|
+
referenceVoxelXYZ?: [number, number, number];
|
|
85
|
+
/** Untruncated 1 µm reference coordinates used for resolution conversion. */
|
|
86
|
+
referenceVoxelXYZRaw?: [number, number, number];
|
|
87
|
+
angles: [number, number, number];
|
|
88
|
+
angleUnit: "degree";
|
|
89
|
+
angleSource: "atlas-reslicing";
|
|
90
|
+
angleConvention: "atlas-reslicing-xyz";
|
|
91
|
+
};
|
|
92
|
+
/** A display-only plane in the target annotation TIFF's XYZ voxel space. */
|
|
93
|
+
obliquePlane?: {
|
|
94
|
+
schemaVersion: 1;
|
|
95
|
+
coordinateSpace: "target-tif-voxel-xyz";
|
|
96
|
+
datasetId: string;
|
|
97
|
+
datasetRevision: string;
|
|
98
|
+
mappingId: string;
|
|
99
|
+
centerVoxelXYZ: [number, number, number];
|
|
100
|
+
/** Full-width and full-height plane vectors, in target TIFF voxels. */
|
|
101
|
+
uExtentVoxelXYZ: [number, number, number];
|
|
102
|
+
vExtentVoxelXYZ: [number, number, number];
|
|
103
|
+
widthPx: number;
|
|
104
|
+
heightPx: number;
|
|
105
|
+
};
|
|
106
|
+
/** Missing means the pose cannot be associated with this TIFF's geometry. */
|
|
107
|
+
targetTif?: {
|
|
108
|
+
datasetId: string;
|
|
109
|
+
datasetRevision: string;
|
|
110
|
+
mappingId: string;
|
|
111
|
+
frameAxis: "cor";
|
|
112
|
+
frameIndex: number;
|
|
113
|
+
systemFrame: number;
|
|
114
|
+
frameCount: number;
|
|
115
|
+
continuousFrameIndex: number;
|
|
116
|
+
voxelXYZ: [number, number, number];
|
|
117
|
+
mappingType?: "physical-affine" | "reference-resolution-scale";
|
|
118
|
+
referenceResolutionUm?: number;
|
|
119
|
+
targetResolutionUm?: number;
|
|
120
|
+
shapeZYX?: [number, number, number];
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
export interface SequencePoseGeometry {
|
|
124
|
+
outlineModelMatrix?: number[];
|
|
125
|
+
schemaVersion: 1;
|
|
126
|
+
voxelFromAtlasLinear: number[][];
|
|
127
|
+
voxelFromViewerAffine: number[][];
|
|
128
|
+
planeSize: [number, number];
|
|
129
|
+
planeAxes?: [[number, number, number], [number, number, number]];
|
|
18
130
|
}
|
|
131
|
+
export type SequenceRegistrationExport = SequenceRegistrationExportV2 | SequenceRegistrationExportV3;
|
|
19
132
|
export interface SequenceRegistration {
|
|
20
133
|
url?: string;
|
|
21
134
|
angles?: number[];
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
interface ExactMatchButtonProps {
|
|
3
|
+
active: boolean;
|
|
4
|
+
label: string;
|
|
5
|
+
hint: string;
|
|
6
|
+
onToggle: () => void;
|
|
7
|
+
}
|
|
8
|
+
export default function ExactMatchButton({ active, label, hint, onToggle }: ExactMatchButtonProps): React.JSX.Element;
|
|
9
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
import { type RegionSearchEntry } from './regionSearch';
|
|
3
|
+
interface RegionFilterSelectProps {
|
|
4
|
+
index: RegionSearchEntry[];
|
|
5
|
+
entries: RegionSearchEntry[];
|
|
6
|
+
value: string | string[] | undefined;
|
|
7
|
+
placeholder: string;
|
|
8
|
+
multiple?: boolean;
|
|
9
|
+
onChange: (values: string[]) => void;
|
|
10
|
+
}
|
|
11
|
+
/** Typing updates only this control, not SideBar's table, charts or scene controls. */
|
|
12
|
+
declare const RegionFilterSelect: React.NamedExoticComponent<RegionFilterSelectProps>;
|
|
13
|
+
export default RegionFilterSelect;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export interface RegionSearchNode {
|
|
2
|
+
name: string;
|
|
3
|
+
fullname?: string;
|
|
4
|
+
cname?: string;
|
|
5
|
+
nameflag?: string;
|
|
6
|
+
children?: RegionSearchNode[];
|
|
7
|
+
}
|
|
8
|
+
export interface RegionSearchEntry {
|
|
9
|
+
name: string;
|
|
10
|
+
key: string;
|
|
11
|
+
value: string;
|
|
12
|
+
label: string;
|
|
13
|
+
ancestors: string[];
|
|
14
|
+
fields: string[];
|
|
15
|
+
children: RegionSearchEntry[];
|
|
16
|
+
}
|
|
17
|
+
export declare function normalizeRegionSearch(value: string): string;
|
|
18
|
+
export declare function indexRegions(nodes: RegionSearchNode[]): RegionSearchEntry[];
|
|
19
|
+
export declare function flattenRegions(nodes: RegionSearchEntry[]): RegionSearchEntry[];
|
|
20
|
+
/** Exact abbreviations first, then prefixes, substrings, and multi-word matches. */
|
|
21
|
+
export declare function searchRegions(entries: RegionSearchEntry[], value: string, strict?: boolean): RegionSearchEntry[];
|