comsol-model-check
/comsol-model-check
Sprawdza model COMSOL przed długim obliczeniem: jednostki, geometrię, warunki brzegowe, siatkę i solver, i podaje tabelę poprawek.
- Autor
- meaning-infinite ↗
- Repozytorium
- comsol-model-check ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Sprawdza model COMSOL przed długim obliczeniem: jednostki, geometrię, warunki brzegowe, siatkę i solver, i podaje tabelę poprawek.
Wyzwalacze z opisu
Oryginalny opis (EN)
上机长跑前体检 COMSOL 模型(频域电磁 ewfd):材料折射率单位与截断、几何尺寸链与域编号、周期性边界、端口类型/激励/狭缝、PML、衍射级、网格、求解器是否 PARDISO、研究与解的状态。用户说"帮我检查模型""能不能上机跑""这个模型还有问题吗""跑之前看一眼""结果不对/全白跑了",或要把 .mph 传公共电脑跑、复现别人的模型时使用。输出逐项通过/不通过表 + 可照抄的修复表达式。
Jak działa
- 流程
- 判据
- 输出格式
- 参考
Podgląd SKILL.md
---
name: comsol-model-check
description: 上机长跑前体检 COMSOL 模型(频域电磁 ewfd):材料折射率单位与截断、几何尺寸链与域编号、周期性边界、端口类型/激励/狭缝、PML、衍射级、网格、求解器是否 PARDISO、研究与解的状态。用户说"帮我检查模型""能不能上机跑""这个模型还有问题吗""跑之前看一眼""结果不对/全白跑了",或要把 .mph 传公共电脑跑、复现别人的模型时使用。输出逐项通过/不通过表 + 可照抄的修复表达式。
---
# COMSOL 模型体检
`problems()` 为空只说明表达式能解析,查不出单位错、取值被钳、端口口径错。先 dump 事实,再逐项判。
## 流程
1. `open_model` → 跑 `scripts/dump_model.py`(整段贴进 MCP comsol 的 `python`)
2. 按下表逐项判,**材料不过就别往后看**
3. 按"输出格式"给表,报告写进任务 `docs\\`
4. 结束 `reset` 释放 .lock
## 判据
### 1 材料 —— 最高频作废来源
每个材料查三项,必须自洽:表达式 / 插值表横轴单位 / 实际传入数值是否落在表内。
不一致时 COMSOL **不报错**,按 `extrap` 静默取端点值 → 材料变常数。
| 表横轴 | 正确写法 | 误写的后果 |
|---|---|---|
| nm(LN 的 no/ne,275–2066) | `no(c_const[1/nm]/freq)` | 传 8.7e-7 被钳到 2066 nm 端 |
| um(ITO 0.401–1.0、PMMA 0.2–1.1) | `n(c_const[1/um]/freq)` | 传 8.7e-7 被钳到 0.401 um 端 |
| m(介电常数 3e-7–2.3e-6) | `sqrt(eps(c_const/freq))` | 传 875 被钳到 2325 nm 端 |
- 表 x 范围 0.4–1.0 → um;275–2066 → nm;1e-7 级 → m。别猜,dump 里有。
- `getString("n")` 返回空串 = 没写,取默认值,物理无意义(柯西/插值函数拖进来但没接到 n 上就长这样)。
- 表降序(2066→275)合法,不用反序。
### 2 几何
- 各块 (z 中心, 厚度) 排序后必须首尾相接,无重叠无缝隙。
- 域→材料:用域包围盒中心 z 排序核对上下顺序,域编号本身不可靠。
- 孔是否贯穿该贯穿的层;孔内填充块的起始 z。
### 3 ewfd 边界
- **周期条件**:`Continuity` + `kFloquet=0` = 正入射。两侧面数一致、能配对;日志出现"未配对"即漏面。
- **端口类型**:周期结构用 `Periodic`;`UserDefined` 要手写 E0/Eampl(全 0 = 注不进功率);周期结构用 `Numeric` 会丢掉周期性。
- **模式数**:周期端口 `PortModeNumber` 填 1–2,填 10 无意义。
- **狭缝**:`PortSlit` / `SlitType`(DomainBacked 需端口后面有域支撑)。
- **激励**:哪个端口 on、`Pin` 多少、另一端口是否只吸收。
- **衍射级**:`Λ/λ > 1` 就有 ±1 级。`AddDiffractionOrders=0` 时端口只收 0 阶,`Ttotal` 会低估。级次数按每个偏振 #{(m,n): m²+n² < (Λ/λ_min)²} 算,或改用通量积分 `∫ n·Poav`。
- **不算错的口径**:端口放内部面、外侧再留一段块、端面压 PEC,是常见建法,别当问题报;只有 T>1、R+T 明显偏离 1 时才回头查这里。
### 4 网格
- 单元数 10^5 正常;10^6 扫 300 点会非常慢。
- 体网格每个域只能被一套覆盖(`自由四面体` 与 `扫掠` 同时存在时确认域不冲突)。
- `hmax <= λ_min/(5·n_max)`(400 nm、n≈2.2 → <=36 nm)。
- 薄层(80–200 nm)至少 2–3 层单元。
### 5 求解器
- `Stationary` 下只启用一个 `Direct`,`linsolver=pardiso`;MUMPS 停用。
- 迭代求解器停用。
- 研究里**逐个特征**看 active:`Parametric` / `Wavelength` 的 plist 数相乘相加才是总点数。
### 6 解
改过材料/几何后旧解变"未初始化",派生前先确认 `sol` 有效。
## 输出格式
```markdown
## 结论
能跑 / 不能跑(一句话 + 最要紧那条)
## 必须改(不改结果就是错的)
| # | 位置 | 现状 | 应改为 | 影响(带数) |
## 建议改
| # | 位置 | 现状 | 建议 |
## 通过项
材料 LN / 求解器 PARDISO / 网格 …
## 上机前最后一眼
求解点数、预计机时、日志里要盯的警告
```
"影响"必须带数(例:ITO n 1.73→2.06、k 翻倍 → 吸收高估近一倍)。不替用户改模型,只给可照抄的表达式和面/域编号;要删块、移端口先问。
## 参考
- `references/checklist.md`:API 取值写法、报告检查项
- `scripts/dump_model.py`:一次 dump 全部事实
Pliki w paczce (4)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 4 KB
- SKILL.md 4 KB
Wersje
W bazie nie ma innych skilli o nazwie comsol-model-check.
Migawka bazy z 13.11.2026 · wersja paczki 6707c164c175 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 82comsol-materials
Podpowiada, jak poprawnie korzystać z systemu materiałów w COMSOL, opierając się na praktycznych doświadczeniach. - 98comsol
Automatyzuje COMSOL Multiphysics przez bibliotekę mph i Java API: tworzy modele, uruchamia badania, eksportuje wyniki i debuguje wywołania. - 88comsol-sim
Pomaga agentowi budować, sprawdzać, uruchamiać i poprawiać modele COMSOL Multiphysics, wybierając najprostszą ścieżkę sterowania, na przykład batch lub plik .mph. - 98comsol-cli-modeling
Buduje, naprawia i uruchamia modele COMSOL przez Java API i CLI, w tym import geometrii STEP, akustykę, przewodzenie ciepła i przemiany fazowe. - 100sim-guard
Planuje, zleca i raportuje długie symulacje naukowe w COMSOL, Lumerical, Fluent lub MATLAB z kolejką i niezależnym sprawdzeniem wyniku. - 100comsol-motor-nvh-evidence
Prowadzi oparty na dowodach przepływ COMSOL Java API dla NVH silnika z magnesami trwałymi: siły Maxwella, mody konstrukcyjne, akustyka, SPL i sweepy Campbella.