安装与使用

pip install sawsim
pip install "sawsim[fast]"     # 可选：MKL PARDISO 直接求解器

from sawsim import Model, sweep

r = sweep(Model("sp_double_layer", pitch_um=1.085, points=101), "out/dbl")
r.frequency_ghz, r.admittance, r.peak_frequency_ghz

sawsim templates
sawsim run config.json -o out/dbl

无图形界面的 Linux 上 Gmsh 需要 libglu1-mesa libopengl0。详见 快速开始。

能力

验证

每个模板与独立的参考有限元解逐点比对；主谐振与反谐振频率全部一致，主谐振区误差 0.1 – 2 %，2D 多层模板在 2.4 GHz 以上高阶模态区存在偏差。完整误差表、图和说明见 验证。pytest 在 5 – 6 个频点上复现该比对。

_{2.5D SP 双层（LiNbO₃ 0.6 µm / Si 6.51 µm），251 频点。虚线 sawsim，实线参考解，幅值相对 L2 误差 0.15 %。}

文档

• 快速开始 — 安装、第一个算例、输出文件、单位
• 模型库 — 九种模板、参数、位移模型、边界与已知限制
• 材料库与晶体取向 — 内置材料、记录格式、自定义导入、ZXZ 欧拉角
• 验证 — 与参考解的逐点比对及解读

项目结构

src/sawsim/        Python 包（api、cli、config、models、solver、saw2d、sp_meshes、sp_hex_meshes、material_library）
tests/             回归与 API 测试，tests/data 为参考曲线
docs/              文档与图
matlab/            v0.x 的 MATLAB + Gmsh 实现（历史版本，MIT）
tools/             维护脚本

许可

Python 包 sawsim 以 AGPL-3.0-or-later 发布（它通过 Python API 链接 GPL 许可的 Gmsh）。matlab/ 下的历史 MATLAB 实现保持 MIT。其他授权方式请联系作者。

引用

引用具体版本请用版本 DOI（v2.0.0：10.5281/zenodo.22728471）；引用项目整体请用概念 DOI 10.5281/zenodo.20362278，它始终指向最新版本。格式见 CITATION.cff。