magnetic-particles2d¶
英語 | 日本語
Magnetophoresis of a suspended magnetizable particle in an LBM flow. --------------------------------------------------------------------------- A weakly-magnetizable particle (a magnetic bead) suspended in a quiescent fluid feels a body force in a NON-UNIFORM external magnetic field and drifts up the field-energy gradient -- the physics of lab-on-a-chip bead separation, magnetic drug targeting and ferrofluid actuation (the OpenLB magneticParticles menu). In the linear point-dipole limit the magnetophoretic force is
概要: 不均一磁場中の磁性ビーズの泳動。点双極子力と Stokes 抗力による解析軌跡と比較する。
Geometry¶

Animation¶
Fields¶
この計算が最後の出力ステップで書き出した場をそのまま描いたもの。3D ケースは中央断面。


Results¶
直線電流ワイヤの磁場中を漂う磁化ビーズの磁気泳動。200×200 周期箱、D2Q9 BGK (τ = 0.8、μ = 0.1)、ワイヤは中心 (100, 100)、ビーズは a = 2、Δχ = 1、K = 5、 半径 r0 = 60 から解放。結合は一方向(ビーズは流体を乱さない):粒子応答時間は τ_p = 2a²ρ_p/(9μ) = 2×4/0.9 = 8.89 ステップ、Re_p = 0.041。Grace CPU 72 コアで 壁時計 17.9 秒。
検証は解析解 u_mag(下の theory)に対する 3 本立てで、すべてサブ % で当たる。
- 軌道:r0 = 60 から内向きに落ち込む全経路で |v_p(r)| を局所の u_mag(r) と比較。 サンプル点 r = 59.59 で v = 1.0495e-3 vs 解析 1.0500e-3、誤差 -0.05%。
- K 掃引(a = 2 固定、K = 2..6):誤差 -0.01% 〜 -0.08%。u_mag ∝ K² の スケーリングをそのまま踏む(K=2 で 1.6513e-4 → K=6 で 1.5248e-3)。
- a 掃引(K = 5 固定、a = 1.5..3.5):誤差 -0.02% 〜 -0.47%。u_mag ∝ a²。 掃引全体の最大誤差 0.47%(ログの結び)。
軌道 CSV の端は正直に読む必要がある。step 0 の行は誤差 -89.9% — 静止から解放した 直後で、τ_p ≈ 9 ステップの緩和が終わる step 100 には -0.05% に落ちる。逆に ワイヤ近傍では誤差が再び育ち、r = 12.67 で -15.7%、最終行 r = 11.97 で -18.1%。 u_mag ∝ 1/r³ が 1 ステップの移動距離のうちに大きく変わり、準定常(終端速度)近似が 壊れる領域である。有効な検証区間は解放過渡後〜ワイヤ数半径手前まで。
Governing equations¶
線形点双極子極限の磁気泳動力と、静止流体中の Stokes 抗力との釣り合い:
\[
\boldsymbol{F}_m=\frac{V_p\,\Delta\chi}{\mu_0}(\boldsymbol{B}\cdot\nabla)\boldsymbol{B},
\qquad
u_{\mathrm{mag}}=\frac{F_m}{6\pi\mu a}
=\frac{2a^{2}\Delta\chi}{9\mu\mu_0}\,|(\boldsymbol{B}\cdot\nabla)\boldsymbol{B}|
\]
外場は直線電流ワイヤの真の(curl-free/divergence-free)場:
\[
\boldsymbol{B}=K\,\frac{(-y,\;x)}{r^{2}},\qquad K=\frac{\mu_0 I}{2\pi},\qquad
|(\boldsymbol{B}\cdot\nabla)\boldsymbol{B}|=\frac{K^{2}}{r^{3}}\ (\text{内向き})
\]
r0 = 60 では u_mag = (2×4×1)/(9×0.1×1) × 25/60³ = 1.0288e-3(ログと一致)。
なぜ一方向結合の点粒子か:2D には Stokes 抗力の極限が存在しない (Stokes のパラドックス)。解像した 2D 円板の抗力は解析式に固定できないため、 LBM 場から流速を双線形サンプリングし 3D の Stokes 抗力 \(6\pi\mu a(\boldsymbol{u}_f-\boldsymbol{v}_p)\) を課す点粒子が、解析解に対する クリーンな定量検証になる(詳細は magnetic-particles-design.md)。 流体は静止のまま乱されない。運動方程式(中性浮力で重力は落ちる):
\[
m_p\frac{d\boldsymbol{v}_p}{dt}=\boldsymbol{F}_m+6\pi\mu a(\boldsymbol{u}_f-\boldsymbol{v}_p),
\qquad m_p=\rho_p\tfrac43\pi a^{3}
\]
Code walkthrough¶
ソース(405 行)。
%%{init: {'themeVariables': {'fontSize': '11px'}}}%%
flowchart LR
subgraph BOX["200×200 周期箱・D2Q9 BGK・静止流体"]
W(("ワイヤ<br/>(100,100)")) -. "B = K(-y,x)/r²" .-> P["点ビーズ<br/>Stokes 抗力 + F_m<br/>双線形補間で u_f"]
end
P --> T["traj.csv / sweep.csv"]
- 場の評価 — ワイヤ場はビーズ中心で毎ステップ解析的に評価(格子に載せない)。
- 粒子更新 — 半陰的 Euler、dt = 1。r < rmin で停止。
- 軌道モード — r0 = 60 から 1 個を追い、各サンプルで v と局所 u_mag を併記。
- 掃引モード — K を 5 点、a を 5 点。各点とも固定 r0 近傍の終端速度を測って 解析値との誤差を CSV に 1 行ずつ。
- 二方向変種 — Guo 体積力での書き戻しはコードにあるが既定 off(twoway キー)。
Build & run¶
cmake -S native -B native/build && cmake --build native/build -j
./native/build/orheo-magnetic-particles2d
このページの図を作った計算のコスト(Miyabi-G Grace CPU (72 cores, -stdpar=multicore)): 17.9 s wall。
Things to try¶
- twoway=1 にする。ビーズの反作用を Guo 強制で流体に返すと誤差がどう動くか。 a = 2 セルの点粒子では効果は小さいはずで、それ自体が一方向近似の妥当性の確認。
- a を 4, 6 と上げる。a 掃引の誤差増大(-0.02% → -0.47%)の傾向線を外挿し、 「粒子上で場の勾配が一様」という点双極子近似が崩れる粒径を見つける。
- rmin を下げて近接域の誤差曲線を描く。traj.csv の err_pct vs r をプロットし、 準定常近似の破綻半径が τ_p と 1/r³ からの見積もりと合うか確かめる。
- τ を 0.6 に下げる。μ が変わるので τ_p, u_mag が両方動く。解析式が追従する ことを見れば、検証がパラメータの偶然でないことが分かる。
Validation¶
| Tier | T2 — 単点比較 |
| QoI | 泳動軌跡 |
| Reference | 点双極子力 + Stokes 抗力(解析) |
| Gate | — ゲートなし |
Source & run details¶
| Item | Value |
|---|---|
| Target | orheo-magnetic-particles2d |
| Source | native/benchmarks/magnetic_particles2d.cpp |
| Lattice | D2Q9 |
| GPU twin | no |
| Gallery run | 2026-07-27 @ 7628c0cf |
| Args | `` |
| Wall time | 17.93 s |
| CPU time | 346.99 s |
| Device | Miyabi-G Grace CPU (72 cores, -stdpar=multicore) |
Computation log¶
この計算の実際の出力(先頭と末尾)。
Magnetophoresis of a point bead in a wire field (D2Q9, one-way Stokes-drag point particle)
grid 200x200 tau=0.800 mu=1.0000e-01 wire @ (100.0,100.0) coupling=one-way
bead a=2.00 dchi=1.00 mu0=1.00 K=5.00 rho_p=1.00 r0=60.0
tau_p=8.89 steps u_mag(r0)=1.0288e-03 Re_p=0.041
[trajectory] releasing bead at r0=60.0 ...
[trajectory] wrote ./magnetic_particles2d_traj.csv (sample r=59.59 v=1.0495e-03 ana=1.0500e-03 err=-0.05%)
[sweep K] a=2.00 fixed, K in {2,3,4,5,6}
K=2.0 r=59.94 v=1.6513e-04 ana=1.6514e-04 err=-0.01%
K=3.0 r=59.85 v=3.7301e-04 ana=3.7308e-04 err=-0.02%
K=4.0 r=59.74 v=6.6684e-04 ana=6.6706e-04 err=-0.03%
K=5.0 r=59.59 v=1.0495e-03 ana=1.0500e-03 err=-0.05%
K=6.0 r=59.41 v=1.5248e-03 ana=1.5260e-03 err=-0.08%
[sweep a] K=5.00 fixed, a in {1.5,2,2.5,3,3.5}
a=1.5 r=59.77 v=5.8532e-04 ana=5.8542e-04 err=-0.02%
References¶
- M. A. M. Gijs, "Magnetic bead handling on-chip", Microfluid. Nanofluid. 1 (2004) 22–40.
- N. Pamme, "Magnetism and microfluidics", Lab Chip 6 (2006) 24–38.
- E. P. Furlani, "Analysis of particle transport in a magnetophoretic microsystem", J. Appl. Phys. 99 (2006) 024912.