Agent-almanac analyze-magnetic-field
git clone https://github.com/pjt222/agent-almanac
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/wenyan-lite/skills/analyze-magnetic-field" ~/.claude/skills/pjt222-agent-almanac-analyze-magnetic-field-5b7a9a && rm -rf "$T"
i18n/wenyan-lite/skills/analyze-magnetic-field/SKILL.md析磁場
藉刻劃源幾何、擇宜法(任意幾何用 Biot-Savart、高對稱配置用安培定律)、評場積分、查極限情況、納磁性材料效應、視覺化所成場線拓撲,計算給定電流分佈所生之磁場。
適用時機
- 自任意載流導體(線圈、螺旋、不規則路徑)計算 B 場
- 利用圓柱、平面或環形對稱直施安培定律
- 經磁偶極近似估遠場行為
- 多電流源之場疊加
- 析磁性材料:線性磁導率、B-H 曲線、磁滯、飽和
輸入
- 必要:電流分佈規格(幾何、電流大小與方向)
- 必要:所需場之關注區域(觀測點或體積)
- 選擇性:材料性質(相對磁導率、B-H 曲線資料、矯頑場、剩磁)
- 選擇性:所需精度等級(精確積分、多極展開階、數值解析度)
- 選擇性:視覺化需求(2D 截面、3D 場線、幅值等高線圖)
步驟
步驟一:刻劃電流分佈與幾何
擇法前先全規源:
- 電流路徑:描述每載流元素之幾何。對線電流,將路徑作參數曲線 r'(t)。對面電流,述面電流密度 K (A/m)。對體電流,述 J (A/m^2)
- 座標系:擇與主對稱對齊之座標。線與螺管用圓柱 (rho, phi, z)。遠距偶極與環圈用球面 (r, theta, phi)。平面片用直角
- 對稱分析:辨平移、旋轉、反射對稱。源之對稱即場之對稱。記何 B 分量按對稱非零、何者消
- 電流連續:驗電流分佈滿足 div(J) = 0(穩態)或 div(J) = -d(rho)/dt(時變)。不一致之電流分佈生非物理之場
## Source Characterization - **Current type**: [line I / surface K / volume J] - **Geometry**: [parametric description] - **Coordinate system**: [and justification] - **Symmetries**: [translational / rotational / reflection] - **Nonzero B-components by symmetry**: [list] - **Current continuity**: [verified / issue noted]
預期: 完整之電流分佈幾何描述,已擇座標系,已列對稱,已驗電流連續。
失敗時: 若幾何過繁難閉式參數描述,離散為短直段(數值 Biot-Savart)。若電流連續違,先加位移電流或回流電荷積累項再續。
步驟二:擇宜法
擇合於問題對稱與繁複之法:
-
安培定律(高對稱):電流分佈具足對稱使 B 可自線積分提出時用。適用:
- 無限直線(圓柱對稱)-> 圓形安培環
- 無限螺管(平移 + 旋轉)-> 矩形安培環
- 環形(繞環軸旋轉)-> 圓形安培環
- 無限平面電流片(二向平移)-> 矩形環
-
Biot-Savart 定律(一般):安培定律不能化簡之任意幾何用:
- dB = (mu_0 / 4 pi) * (I dl' x r_hat) / r^2
- 對體電流:B(r) = (mu_0 / 4 pi) * integral of (J(r') x r_hat) / r^2 dV'
-
磁偶極近似(遠場):觀測點離源遠時用(r >> 源尺寸 d):
- 計磁偶極矩:m = I * A * n_hat(面積 A 之平面圈)
- B_dipole(r) = (mu_0 / 4 pi) * [3(m . r_hat) r_hat - m] / r^3
- r/d > 5 時有效,約 1% 精度
-
疊加:多源時,獨立計各 B 並向量和。Maxwell 方程之線性保此精確。
## Method Selection - **Primary method**: [Ampere / Biot-Savart / dipole] - **Justification**: [symmetry argument or distance criterion] - **Expected complexity**: [closed-form / single integral / numerical] - **Fallback method**: [if primary fails or for cross-validation]
預期: 法之選擇有理,明陳所擇定律何以合於問題之對稱層次。
失敗時: 若擇安培定律然對稱不足(B 不能自積分提取),退用 Biot-Savart。若源幾何過繁難解析 Biot-Savart,數值離散。
步驟三:設立並評場積分
以步驟二所擇法執計算:
-
安培定律路徑:對每安培環:
- 將環路徑參數化並計 B . dl 之線積分
- 計穿環之全電流 I_enc,數一切穿過環之電流
- 解:contour_integral(B . dl) = mu_0 * I_enc
- 用步驟一所立對稱由積分提出 B
-
Biot-Savart 積分:對每場點 r:
- 將源參數化:dl' = (dr'/dt) dt,或於體上述 J(r')
- 計位移向量:r - r' 與其大小 |r - r'|
- 評叉積:dl' x (r - r') 或 J x (r - r')
- 對源(線、面或體)積分
- 解析評:用對稱降維(如圈之軸上場僅一積分)
- 數值評:離散為 N 段,計和,倍 N 查收斂
-
偶極計算:
- 計總磁矩:m = (1/2) integral of (r' x J) dV'(體電流),或 m = I * A * n_hat(平面圈)
- 於每觀測點施偶極場公式
- 估誤差:下一多極(四極)修正以 (d/r)^4 縮放
-
疊加組裝:於每觀測點和諸源貢獻。分別追各分量以保抵銷精度。
## Field Calculation - **Integral setup**: [explicit expression] - **Evaluation method**: [analytic / numeric with N segments] - **Result**: B(r) = [expression with units] - **Convergence check** (if numerical): [N vs. 2N comparison]
預期: 觀測點 B(r) 之明確表達式,附正確單位(特斯拉或高斯)與數值結果之收斂查。
失敗時: 若積分發散,查缺正則化(如導線本身之場對無限細線發散——用有限線徑)。若數值結果隨 N 振盪,被積函式有近奇異須適應性求積或解析減去奇異部。
步驟四:查極限情況
信任結果前對已知物理驗:
-
遠場偶極極限:大 r 時,任局部電流分佈應產一場合於磁偶極公式。自結果計 r -> infinity 之 B 並比 (mu_0 / 4 pi) * [3(m . r_hat) r_hat - m] / r^3。
-
近場無限線極限:近導體之長直段(距 rho << 長 L),場應趨 B = mu_0 I / (2 pi rho)。對幾何之相關部分查此。
-
軸上特殊情況:對圈與螺管,軸上場有簡明閉式:
- 半徑 R 之單圓圈於軸上距 z 處:B_z = mu_0 I R^2 / [2 (R^2 + z^2)^(3/2)]
- 長 L、每長 n 匝之螺管:B_interior = mu_0 n I(L >> R 時)
-
對稱一致:驗按對稱(步驟一)應消之分量於計算結果中確為零。非零之禁分量表錯誤。
-
量綱分析:驗 B 為特斯拉單位。每項應帶 mu_0 * [電流] / [長] 或同等。
## Limiting Case Verification | Case | Condition | Expected | Computed | Match | |------|-----------|----------|----------|-------| | Far-field dipole | r >> d | mu_0 m / (4 pi r^3) scaling | [result] | [Yes/No] | | Near-field wire | rho << L | mu_0 I / (2 pi rho) | [result] | [Yes/No] | | On-axis formula | [geometry] | [known result] | [result] | [Yes/No] | | Symmetry zeros | [component] | 0 | [result] | [Yes/No] | | Units | -- | Tesla | [check] | [Yes/No] |
預期: 一切極限情況皆合。場具正確之單位、對稱與漸近行為。
失敗時: 失敗之極限表積分設立或評估有誤。最常見之因:叉積符號錯、缺 2 或 pi 之因子、積分極限有誤、源與場點參數化之座標系不符。
步驟五:納磁性材料並視覺化
延分析以含材料效應並產場視覺化:
-
線性磁性材料:於材料內以 mu = mu_r * mu_0 代 mu_0。施材料介面之邊界條件:
- 法分量:B1_n = B2_n(連續)
- 切分量:H1_t - H2_t = K_free(面自由電流)
- 無自由面電流時:H1_t = H2_t
-
非線性材料(B-H 曲線):對鐵磁芯:
- 用材料之 B-H 曲線於每點關聯 B 與 H
- 為設計目的,以分段線性近似:線性區(B = mu H)、膝區與飽和區(B 約常)
- 若操作點循環則計磁滯:剩磁 B_r 與矯頑場 H_c 定環
-
退磁效應:對有限幾何之磁性材料(如短桿、球),內場由退磁因子 N_d 減:H_internal = H_applied - N_d * M。
-
場視覺化:
- 以流函式或沿場方向積分 dB/ds 繪場線
- 繪幅值等高線(|B| 為色圖)
- 對 2D 截面,標電流方向(出頁為點,入頁為叉)
- 驗場線形成閉環(div B = 0)——開場線表視覺化或計算錯誤
-
物理直覺查:確場型於質性上合理。場應於電流源近最強,應繞電流循環(右手定則),並隨距衰減。
## Material Effects and Visualization - **Material model**: [vacuum / linear mu_r / nonlinear B-H / hysteretic] - **Boundary conditions applied**: [list interfaces] - **Visualization**: [field lines / magnitude contour / both] - **Div B = 0 check**: [field lines close / verified numerically]
預期: 完整之場解,含相關材料效應,附呈閉場線(合 div B = 0)與合物理直覺之質性行為之視覺化。
失敗時: 若場線不閉,計算有發散誤——重查積分或數值法。若材料引非預期之場放大,驗 mu_r 僅施於材料體積內,且邊界條件於每介面正確施行。
驗證
- 電流分佈以幾何、大小、方向全規定
- 電流連續(穩態下 div J = 0)已驗
- 座標系與主對稱對齊
- 法之選擇(安培/Biot-Savart/偶極)以對稱分析為理
- 場積分以正確之叉積與極限設立
- 數值結果呈收斂(N 對 2N 試)
- 遠場偶極極限已驗
- 近場與軸上極限合已知公式
- 禁對稱分量為零
- 全程單位為特斯拉
- 材料邊界條件正確施行(若適用)
- 場線形成閉環(div B = 0)
常見陷阱
- 叉積方向錯:Biot-Savart 之叉積為 dl' x r_hat(源至場),非 r_hat x dl'。反之則整場方向反。以右手定則速查
- 混 B 與 H:真空中 B = mu_0 H,然磁性材料內 B = mu H。安培定律以 H 表時僅用自由電流;以 B 表時含束縛(磁化)電流。混慣例致 mu_r 因子之誤
- 無足對稱即施安培定律:安培定律恆真,然僅於對稱可使 B 自積分提取時方有用。若 B 沿安培環變,定律對空間變化之函式僅給單一純量方程——不足以定
- 忽「無限」線之有限長:實螺管與線有端。無限線或無限螺管公式僅於遠端時有效(距端 >> 半徑)。近端用完整 Biot-Savart 積分或有限螺管修正
- 有限幾何中忽退磁:磁化球或短桿於同施場下之內場與長桿不同。退磁因子可依長寬比減有效內場 30-100%
- 非物理之場線:若視覺化呈於自由空間中始或終之場線(非於電流源或無限),計算或繪圖演算法有誤。磁場線恆形成閉環
相關技能
— 用所計 B 場析時變磁通與感應 EMFsolve-electromagnetic-induction
— 推廣至 Maxwell 方程之全套,含位移電流與波傳播formulate-maxwell-equations
— 將磁場分析施於電磁鐵、馬達、變壓器之設計design-electromagnetic-device
— 磁交互之量子處理(Zeeman 效應、自旋軌道耦合)formulate-quantum-problem