test_vdPauw_refactored.py ドキュメント

概要

test_vdPauw_refactored.py は、van der Pauw 法におけるシート抵抗の補正因子を計算する外部モジュール vdPauw_refactored.py の動作を検証するための単体テストプログラムである。 Python標準の unittest フレームワークを用いて、補正因子の計算結果が支配方程式を満たすかどうかの残差確認や、物理的対称性の検証を自動で行う。

非標準ライブラリ

本プログラムの import 文から抽出される非標準ライブラリは以下の通りである。

  • numpy: 数値計算、対数スケールでの配列生成(np.logspace)、行列計算、および浮動小数点数の許容誤差を考慮した比較判定(np.testing.assert_allclose)に使用される。

  • (※モジュールのDocstringには scipy および matplotlib への依存が記載されているが、本テストコード内では直接 import されていない)

入出力仕様

本プログラムはテストスクリプトとして動作するため、一般的なデータファイルの入力および出力は行わない。

  • 入力 同一ディレクトリに配置された vdPauw_refactored.py をモジュールとして読み込み、calculate_factors や vdp_factor などの関数から得られる計算結果をテストの入力値として受け取る。

  • 出力 標準出力(コンソール)に対して、テストの実行ログ、方程式の残差計算結果(左辺値や最大絶対残差など)、最大対称性相対差などを出力する。すべてのテスト条件をクリアすると正常終了となり、条件を満たさない場合はアサーションエラーの詳細を出力する。

数式と理論の解説

van der Pauw 法において、薄膜試料のシート抵抗 \(R_S\) を決定するための基本方程式は、測定された2つの抵抗値 \(R_1\) (コード内の \(R_{AB,CD}\) )と \(R_2\) (コード内の \(R_{AD,BC}\) )を用いて以下のように表される。

\[\exp\left(-\frac{\pi R_1}{R_S}\right) + \exp\left(-\frac{\pi R_2}{R_S}\right) = 1\]

理想的な対称形状( \(R_1 = R_2\) )を持たない場合、シート抵抗 \(R_S\) を解析的に解くために補正因子 \(f\) を導入し、以下のように再定義する。

\[R_S = \frac{\pi (R_1 + R_2)}{2 \ln 2} f\]

コード中では、2つの抵抗値の比 \(R\) を以下のように定義している。

\[R = \frac{R_1}{R_2}\]

この抵抗比 \(R\) と補正因子 \(f\) を用いると、元の方程式は変数 \(x\) を用いて以下のように整理される。

\[\exp(-xR) + \exp(-x) = 1\]

ここで、変数 \(x\) は次のように定義される。

\[x = \frac{2 \ln 2}{(R + 1) f}\]

本プログラムの test_equation_residual メソッドでは、vdPauw_refactored.py が広範な抵抗比( \(10^{-8}\) から \(10^8\) まで)に対して計算した補正因子 \(f\) をもとに変数 \(x\) を逆算している。そして、得られた \(x\) と \(R\) を式に代入し、左辺の合計値と \(1\) との差(残差)が、設定された許容値( RESIDUAL_ATOL )の範囲内に収まっているかを検証している。 さらに test_reciprocal_symmetry メソッドでは、抵抗比 \(R\) の場合と、端子の取り方を反転させた逆数 \(1/R\) の場合とで、算出される補正因子 \(f\) が一致するという物理的な対称性が保たれていることをテストしている。

実行例

コマンドライン(ターミナル)を開き、vdPauw_refactored.py と test_vdPauw_refactored.py が同一ディレクトリに存在する状態で以下のコマンドを実行する。

python test_vdPauw_refactored.py

詳細なテスト実行結果(各テストメソッドの合否など)を確認する場合は、unittest モジュールの詳細出力オプション( -v )を付与して以下のように実行する。

python -m unittest -v test_vdPauw_refactored