Load Sanying CT Image Files（加载三英 CT 重构 RAW 数据）
Load Sanying CT Image Files - User Manual
Dragonfly Prototype Apps · Load Sanying CT Image Files...
版本 Version 1.0 · 2026-07-26
第一部分 中文手册
目录
1. 简介
2. 尺寸与参数如何确定
3. 使用步骤
4. 环境需求
1. 简介
Load Sanying CT Image Files 用于把三英（Sanying）显微 CT 重建后的 RAW 体数据导入 Dragonfly。三英重建完成后，Recon 文件夹里通常包含 FdkRecon-<类型>-<X>x<Y>x<Z>.raw（默认 ushort，即 16 位无符号整型）和一个 Reconstruct.txt。本插件自动解析这些信息，预览中间切片，并作为图像 Channel 加载。
本功能由第三方（Prototype Labs / Prototype Apps）提供，非 Dragonfly 官方开发或支持，使用风险自负。
2. 尺寸与参数如何确定
参数来自 Reconstruct.txt 的 [ReconstructItem] 段与 raw 文件名：
- X = VoxelX，Y = VoxelY（始终取自 txt）。
- Z：圆轨迹扫描（
CircleNum = 1）时取VoxelZ；螺旋扫描（CircleNum ≠ 1，如 4）时VoxelZ不准确，Z 取自 raw 文件名中的第三个整数。 - 体素大小 = VoxelDis（毫米，各向同性）。
- 数据类型默认 16 位无符号整型（文件名里的
ushort）。
插件还会用文件大小做交叉校验，必要时自动修正 Z。所有参数在界面上都可手动修改。
3. 使用步骤
1. 点击“浏览文件…”选择 FdkRecon-*.raw，或“浏览文件夹…”选择 Recon 文件夹（自动查找 raw）。
2. 核对自动识别的尺寸 / 数据类型 / 字节序 / 体素大小 / 扫描模式（可修改）。
3. 体数据很大时，选择合适的降采样倍数，或用 Z from / Z to 只加载部分层；界面会显示预计占用内存。
4. 查看“中间切片预览”确认读取正确。
5. 点击“Load into Dragonfly”，体数据将作为新的图像 Channel 出现在对象列表中。
4. 环境需求
无需安装、无需联网、无需 GPU、无需虚拟环境。使用 Dragonfly 自带 Python 的 numpy 以内存映射方式读取，大体数据按切片读取；降采样以 stride 抽样方式进行，峰值内存约为“一层 + 结果体数据”。
Part II English Manual
Contents
1. Introduction
2. How dimensions & parameters are determined
3. How to use
4. Requirements
1. Introduction
Load Sanying CT Image Files imports Sanying (三英) micro-CT reconstructed RAW volumes into Dragonfly. After reconstruction the Recon folder typically holds FdkRecon-<type>-<X>x<Y>x<Z>.raw (default ushort = 16-bit unsigned) and a Reconstruct.txt. The plugin auto-parses these, previews a mid-slice, and loads the volume as an image Channel.
This feature is provided by a third party (Prototype Labs / Apps), not officially developed or supported by Dragonfly. Use at your own risk.
2. How dimensions & parameters are determined
Parameters come from the [ReconstructItem] section of Reconstruct.txt plus the raw filename:
- X = VoxelX, Y = VoxelY (always from the txt).
- Z: for a circle-trajectory scan (
CircleNum = 1) useVoxelZ; for a helical scan (CircleNum ≠ 1, e.g. 4)VoxelZis wrong, so Z is the 3rd integer in the raw filename. - Voxel size = VoxelDis (millimetres, isotropic).
- Data type defaults to 16-bit unsigned (the
ushortin the filename).
The plugin also cross-checks against the file size and auto-corrects Z if needed. Every parameter is editable in the panel.
3. How to use
1. Click 'Browse File…' to pick FdkRecon-*.raw, or 'Browse Folder…' to pick the Recon folder (the raw is found automatically).
2. Check the auto-detected dimensions / data type / byte order / voxel size / scan mode (edit if needed).
3. For very large volumes, pick a Downsample factor or set Z from / Z to to load a sub-range; the estimated loaded size is shown.
4. Use 'Preview mid-slice' to confirm the read is correct.
5. Click 'Load into Dragonfly' — the volume appears as a new image Channel in the object list.
4. Requirements
No install, no internet, no GPU, no venv. Reads with Dragonfly's own numpy via memory-mapping, slice-by-slice for big volumes; downsampling is stride subsampling, so peak memory ≈ one slice + the output volume.