test_analyze_TFT_refactored_verbose.py ドキュメント

概要

test_analyze_TFT_refactored_verbose.py は、TFT特性解析スクリプト analyze_TFT_refactored.py の動作を検証するためのテストプログラムです。 既知のパラメータに基づく人工的なTFTデータ(理想データおよびノイズ付加データ)を生成し、飽和領域と線形領域におけるしきい値電圧 \(V_{th}\) や移動度 \(\mu\) などの抽出が正しく行われるかをテストします。また、データ不足や異常値が含まれるエッジケースでの例外処理、コマンドラインインターフェース(CLI)経由でのファイル入出力が仕様通りに機能するかを確認します。

理論背景と人工データ生成アルゴリズム

本スクリプトは、物理的なTFT特性を模擬した人工電流値 \(I_d\) をゲート電圧 \(V_g\) に応じて生成します。ゲート電圧の領域ごとに以下のモデルが使用されます。

1. サブスレッショルド領域

\(V_g < V_{th}\) の範囲では、サブスレッショルドスイング \(SS\) に基づく指数関数的な電流モデルが適用されます。

\[I_d = I_{off} \times 10^{\frac{V_g - V_{th}}{SS}}\]

2. 飽和領域

\(V_g \ge V_{th}\) のオン領域において、飽和領域(高ドレイン電圧)の場合は二乗則モデルが適用されます。ここで \(W\) はチャネル幅、\(L\) はチャネル長、\(C_{ox}\) はゲート絶縁膜容量、\(\mu_{sat}\) は飽和移動度を表します。

\[I_d = I_{off} + \frac{W \cdot C_{ox} \cdot \mu_{sat}}{2 L} (V_g - V_{th})^2\]

3. 線形領域

\(V_g \ge V_{th}\) のオン領域において、線形領域(低ドレイン電圧 \(V_{ds,lin}\) )の場合は以下の線形モデルが適用されます。\(\mu_{FE}\) は電界効果移動度を表します。

\[I_d = I_{off} + \frac{W}{L} C_{ox} \cdot \mu_{FE} \cdot V_{ds,lin} (V_g - V_{th})\]

4. 乗法性ガウスノイズの付加

ロバスト性および再現性のテスト(Case B)では、生成された理想電流値に対して乗法的なガウスノイズが付加されます。乱数シードを固定することで、再現性のあるノイズデータを生成します。

\[I_{noisy} = I_{clean} \times (1 + \mathcal{N}(0, \sigma^2))\]

ここで \(\sigma\) はノイズレベルであり、コマンドライン引数または環境変数によって制御可能です。

入出力仕様

本スクリプトのテスト実行における入出力の仕様は以下の通りです。

  • 入力

    • テスト内で pandas.DataFrame から動的に生成されるExcelファイル( IdVg-Vd0.1.xlsx 、 IdVg-Vd10.xlsx )。これらは Vg 、 Vd 、 Id の列を持ちます。

    • スタンドアロン実行時のコマンドライン引数: --seed 、 --noise-level 、 --target-script 、 --show-details 、 --pytest-args 。

    • 環境変数: TFT_TEST_SEED 、 TFT_TEST_NOISE_LEVEL 、 TFT_TARGET_SCRIPT 、 TFT_TEST_SHOW_DETAILS 。

  • 出力

    • テスト結果および詳細情報が標準出力(コンソール)へ出力されます。

    • CLI出力テストにおいて、一時ディレクトリ内に以下のファイルが生成されることが検証されます。

      • 各入力に対する解析結果CSV( IdVg-Vd10_analyze.csv 、 IdVg-Vd0.1_analyze.csv )

      • サマリー出力CSV( output.csv )

      • ログ出力CSV( output_log.csv )

      • グラフ画像PNG( rootIdVg.png 、 IdVg_LIN.png )

非標準ライブラリ

コードからは以下の非標準ライブラリのインポートが確認できます。

  • numpy

  • pandas

  • pytest

実行例

本スクリプトは、 pytest を直接呼び出す方法と、Pythonスクリプトとしてスタンドアロン実行する方法に対応しています。

1. pytestによる標準実行

デフォルトのシード値とノイズレベルを使用して、テストスイートを実行します。

pytest -q -s test_analyze_TFT_refactored_verbose.py

2. スタンドアロン実行(シード値・ノイズレベルの指定)

人工データ生成時のシード値やノイズレベルを任意に変更してテストを実行できます。このモードでは内部的に環境変数を設定した後、自動的に pytest が呼び出されます。

python test_analyze_TFT_refactored_verbose.py --seed 12345 --noise-level 0.005

3. 解析対象スクリプトのパス指定

解析対象となるスクリプト(デフォルトは同階層の analyze_TFT_refactored.py )が別の場所に配置されている場合、 --target-script オプションでパスを明示的に指定して実行できます。

python test_analyze_TFT_refactored_verbose.py --target-script /path/to/custom_analyze_script.py