将逐帧衍射记录中的应力或应变，与完整参考应力–应变曲线对应起来。
A Tk desktop tool for mapping frame-level stress or strain against a laboratory reference curve. It supports unit checks, overlay review, aligned tables, and plot export.
安装与启动 · 数据映射步骤 · 输入条件 · 图像应变工具 StrainTrace
flowchart TD
A[完整参考应力–应变曲线] --> C[核对列、单位与对应关系]
B[逐帧记录表] --> C
C --> D{逐帧记录中已有哪一列}
D -->|应变| E[插值得到应力]
D -->|应力| F[反向插值得到应变]
D -->|两列都有| G[检查对应关系]
E --> H[叠加检查并导出表格和图]
F --> H
G --> H
每行代表一次谱线、帧或采集。 对应结果是参考曲线的插值估计，不是从衍射峰重新测量应力或应变。使用前必须核对应变的小数/百分数及应力单位；反向映射还需确认所选参考区段的对应关系。
| Station has… | Mapper does… |
|---|---|
| Strain only | Interpolate → stress |
| Stress only | Inverse-interpolate → strain |
| Both | Units · alignment check · export |
- PCHIP shape-preserving interpolation when SciPy is available; otherwise linear fallback
- Optional Savitzky–Golay / smoothing guides (SciPy signal)
- Unit warnings (fraction vs percent strain; stress in MPa)
- High-contrast plotting and publication export presets
- Excel / CSV friendly table I/O via pandas + openpyxl
Windows (double-click):
start_stress_strain_mapper.bat
From source:
pip install pandas numpy matplotlib scipy openpyxl
python sxrd_stress_strain_mapper_gui_v3.pyRequires Python 3 with tkinter (standard on most Windows / macOS Python installs).
- Load a complete lab reference σ–ε curve.
- Load the beamline / station table (one row per frame).
- Choose which column is missing (stress or strain) and confirm units.
- Map → review overlay → export aligned table and plots.
- Not a constitutive material model, crystal plasticity solver, or FEM post-processor
- Not a DIC / virtual-extensometer strain extractor (see StrainTrace, formerly ezDIC, for image-based strain)
- Output quality tracks the reference curve; garbage in → garbage out
- Always verify fraction vs percent strain before publishing figures or tables
python -m unittest tests/test_stress_strain_mapper.py -vMIT — see LICENSE.