帮助文档
使用文档
快速上手 StrainCorr，掌握 DIC 分析全流程
快速入门
完成以下 5 个步骤，即可完成您的第一次 DIC 应变分析：
- 新建项目：点击仪表盘「新建项目」，输入项目名称
- 导入图像：将参考帧（Reference）和变形帧（Deformed）图像拖入数据中心
- 绘制 AOI：切换到 AOI 编辑页，框选感兴趣测量区域
- 配置参数：在计算页面设置 Subset Size、Step 等参数（或使用 AI 向导自动推荐）
- 运行计算：点击「开始计算」，等待进度条完成后查看应变云图
DIC 参数说明
以下为 StrainCorr 核心计算参数，默认值适合大多数场景：
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
subset_size |
整数（奇数） | 31 |
子集大小（像素），需包含足够散斑特征 |
step |
整数 | 7 |
计算网格间距（像素） |
search_range |
整数 | 31 |
粗搜索半径（像素），应大于最大预期位移量 |
znssd_cutoff |
浮点数 | 2.0 |
ZNSSD 相关系数截止值 |
strain_method |
枚举 | least_squares |
应变计算方法：least_squares / savgol / central_diff / gradient |
分析工作流
1. 准备散斑图像
确保参考帧清晰，散斑图案均匀分布，避免过曝/欠曝。推荐使用 16-bit TIFF 格式以保留最大动态范围。
2. 创建项目
在仪表盘点击「新建项目」，将图像序列拖入数据中心。软件自动识别参考帧（序号最小）和变形帧序列。
3. 设置 AOI
在 AOI 编辑器中用多边形工具框选测量区域，排除夹具、边缘等非测量区域以提高计算效率。
4. 配置计算参数
根据散斑特征调整 subset_size（建议为散斑直径的 3-5 倍）和 step（影响结果密度）。
5. 查看与导出结果
计算完成后在结果视图切换 Exx/Eyy/Exy/EVM 分量，使用报告页面一键导出 PDF 或原始数据。
AI 功能使用
安装 Ollama
StrainClaw AI 依赖 Ollama 在本地运行大模型。进入「设置 → AI 配置」，按界面提示安装 Ollama 并拉取推荐模型。
配置 AI 提供商
支持以下配置方式：
- 本地 Ollama（推荐）：完全离线，数据不出本机
- OpenAI 兼容 API：支持 GPT-4 等云端模型
- Anthropic Claude API：高质量分析能力
使用 AI Studio
切换到 AI Studio 标签页，在对话框输入问题，例如：
- 「分析这个试样的应变集中区域在哪里？」
- 「帮我推荐适合这组图像的 DIC 参数」
- 「生成这次实验的分析报告」
数据导出
PDF 报告
点击报告页面「生成 PDF 报告」，自动生成包含项目封面、参数配置表、全场应变云图和统计摘要的专业报告。
CSV 数据
导出格式为逗号分隔的矩阵数据，包含每个计算点的坐标 (X, Y)、位移 (U, V) 和应变分量 (EXX, EYY, EXY, EVM)。可直接导入 Excel、MATLAB 或 Python 进行后处理。
PNG 图像
以高分辨率（匹配原始图像尺寸）导出带色谱的应变云图，适合论文插图和报告使用。
常见问题
计算引擎显示「未就绪」怎么办？
StrainCorr 使用自研 IC-GN C++ 内核，已内置于安装包中，无需额外配置。若提示未就绪，请检查安装是否完整，或尝试重新安装最新版本。
如何使用 StrainClaw AI？
进入「AI Studio」页面，选择 AI 服务提供商：支持智谱 GLM、Kimi、MiniMax、通义千问、DeepSeek、Ollama（本地离线）及自定义接口。Ollama 本地模式需先安装 Ollama 并拉取模型（如 qwen2.5）。
支持哪些图像格式？
支持 TIFF/TIF（推荐，无损）、PNG、BMP、JPG/JPEG、WEBP、JP2 等 20+ 格式。工业散斑图像建议使用 16-bit TIFF 以获得最佳精度。
如何提高计算精度？
增大 subset_size（获取更多纹理特征）、减小 step（更密集的计算网格）、确保图像清晰无运动模糊，以及使用高质量散斑喷涂。
计算结果中出现大量无效点？
可能原因：散斑质量差、图像过曝/欠曝、search_range 设置过小（位移超出搜索范围）。尝试增大 search_range 或调整 znssd_cutoff。
技术规格
| 计算引擎 | 自研 IC-GN（C++ 内核 · pybind11） |
| 开发语言 | Python 3.12 + 自研 C++ 内核 |
| 界面框架 | PySide6 (Qt6) |
| AI 框架 | GLM / Kimi / MiniMax / Qwen / DeepSeek / Ollama |
| 平台 | Windows 10/11 (x64) |
| 图像格式 | 20+ 格式（TIFF/PNG/BMP/JPG 等） |