Map diffraction records to a reference stress–strain curve
将衍射记录映射到参考应力–应变曲线
Overview / 项目概览 · Start / 开始使用 · Reference / 详细说明
Use a reference mechanical curve to estimate missing stress or strain values. Inspect units, alignment and interpolation before exporting the linked records.
利用参考力学曲线估计缺失的应力或应变值，检查单位、对齐方式与插值结果，再导出关联记录。
- Bidirectional mapping — 支持由应变查询应力及由应力查询应变。
- Inspect interpolation — 查看 PCHIP 或线性插值及可选平滑的影响。
- Table exchange — 读取和导出常用 Excel 与 CSV 表格。
py -m pip install pandas numpy matplotlib scipy openpyxl
py sxrd_stress_strain_mapper_gui_v3.pyMapped values are estimates from the chosen reference curve. Non-monotonic curves require care when selecting an inverse branch.
映射值是基于所选参考曲线的估计；非单调曲线的反向映射需要明确所选分支。
Cover: AI-generated conceptual illustration. 封面为 AI 生成的概念插图。
Map missing stress or strain in in-situ SXRD tensile tables using a reference σ–ε curve.
-green.svg){kind=icon}
Desktop Tk GUI (v3). Each table row is one spectrum / frame / acquisition. A complete lab reference stress–strain curve fills the missing column, converts units, checks alignment, and exports publication-ready plots.
| 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.