title: "02_analyze_TFT.py 利用マニュアル" author: "Python Tutorial: Code Review" date: "2026-06-04" lang: ja


02_analyze_TFT.py 利用マニュアル

1. 概要

02_analyze_TFT.py は、薄膜トランジスタ(TFT)の I_D--V_G 測定データを読み込み、代表的なTFT動作パラメータを自動抽出するPythonプログラムです。

主に、次の2種類の測定データを解析します。

このプログラムは、Excelファイルから測定データを読み込み、解析済みCSVファイル、要約CSVファイル、確認用グラフ画像を出力します。

2. 解析する物理量

本プログラムでは、以下の代表値を計算します。

3. 必要なファイル

デフォルトでは、カレントディレクトリに次の2つのExcelファイルがあることを想定します。

用途 デフォルトファイル名 必須列
線形領域 I_D--V_G データ IdVg-Vd0.1.xlsx Vg, Vd, Id
飽和領域 I_D--V_G データ IdVg-Vd10.xlsx Vg, Id

列名は大文字・小文字を含めて一致している必要があります。

4. 入力データ形式

入力ファイルはExcel形式(.xlsx)です。

最低限、以下の列が必要です。

列名 意味 典型的な単位
Vg ゲート電圧 V
Vd ドレイン電圧 V
Id ドレイン電流 A

飽和領域の解析では、Vg と Id を使用します。線形領域の解析では、Vg, Vd, Id を使用します。

Id が0以下の点は、対数や平方根を計算できないため、解析用の電流列では NaN として扱われます。

5. インストール

Python 3.10以降を推奨します。

必要なライブラリは以下です。

pip install numpy pandas matplotlib scikit-learn openpyxl

pandas で .xlsx ファイルを読むために、通常は openpyxl も必要です。

6. 基本的な実行方法

デフォルトファイル名を使う場合は、次のように実行します。

python 02_analyze_TFT.py

別の入力ファイルを指定する場合は、次のようにします。

python 02_analyze_TFT.py --lin sample_lin.xlsx --sat sample_sat.xlsx

出力先ディレクトリを指定する場合は、次のようにします。

python 02_analyze_TFT.py --lin sample_lin.xlsx --sat sample_sat.xlsx --outdir result

詳細なエラー情報を表示したい場合は、--verbose を付けます。

python 02_analyze_TFT.py --verbose

7. コマンドライン引数

引数 デフォルト値 説明
--lin IdVg-Vd0.1.xlsx 線形領域の入力Excelファイル
--sat IdVg-Vd10.xlsx 飽和領域の入力Excelファイル
--outdir . 出力先ディレクトリ
--cox 2.24e-8 ゲート絶縁膜容量。L, W, I_D, V_D と整合する単位系で指定する
--length 50.0e-6 チャネル長 L
--width 300.0e-6 チャネル幅 W
--target-current 1.0e-10 SS と V_{\mathrm{on}} の評価に使う電流しきい値
--ioff-threshold 1.0e-14 I_{\mathrm{off}} 平均に使う上限電流値
--rolling-window 7 局所傾きの移動平均に使う窓幅
--verbose なし エラー時に詳細なトレースバックを表示する

8. 解析方法

8.1 しきい値電圧

しきい値電圧 V_{\mathrm{th}} は、最大傾き点における接線の x 切片として求めます。

最大傾き点を (V_G^*, y^*)、その点での傾きを m^* とすると、しきい値電圧は次式で計算されます。

V_{\mathrm{th}} = V_G^* - \frac{y^*}{m^*}

ここで、飽和領域では y = \sqrt{I_D}、線形領域では y = I_D を使います。

8.2 飽和領域移動度

飽和領域では、\sqrt{I_D}--V_G の傾きから移動度を求めます。

\mu_{\mathrm{SAT}} = \frac{2L}{W C_{\mathrm{ox}}} \left(\frac{d\sqrt{I_D}}{dV_G}\right)^2

8.3 線形領域電界効果移動度

線形領域では、I_D--V_G の傾きから電界効果移動度を求めます。

\mu_{\mathrm{FE}} = \frac{L}{W C_{\mathrm{ox}} V_D} \frac{d I_D}{d V_G}

8.4 サブスレッショルドスイング

サブスレッショルドスイングは、\log_{10} I_D の傾きの逆数として計算します。

SS = \left(\frac{d\log_{10} I_D}{dV_G}\right)^{-1}

本プログラムでは、--target-current で指定した電流値に最初に到達した点での傾きから SS を評価します。

9. 出力ファイル

実行後、出力先ディレクトリに以下のファイルが作成されます。

ファイル名 内容
IdVg-Vd10_analyze.csv 飽和領域データに解析列を追加したCSV
IdVg-Vd0.1_analyze.csv 線形領域データに解析列を追加したCSV
output.csv 代表パラメータをまとめたCSV
output_log.csv output.csv の一部の値を \log_{10} に変換したCSV
rootIdVg.png 飽和領域の \sqrt{I_D}--V_G プロット
IdVg_LIN.png 線形領域の I_D--V_G プロット

10. output.csv の列

output.csv には以下の列が出力されます。

列名 意味
Vth_SAT 飽和領域のしきい値電圧
muSAT 飽和領域移動度
SS_SAT 飽和領域サブスレッショルドスイング
Ion_SAT 飽和領域オン電流
Vth_LIN 線形領域のしきい値電圧
muFE 線形領域電界効果移動度
SS_LIN 線形領域サブスレッショルドスイング
Ion_LIN 線形領域オン電流

11. output_log.csv の注意

output_log.csv では、以下の列に対して \log_{10} 変換が行われます。

ただし、列名は output.csv と同じです。そのため、output_log.csv を読む場合は、これらの列が元の値ではなく \log_{10} 変換後の値であることに注意してください。

12. 実行例

12.1 デフォルト条件で実行

python 02_analyze_TFT.py

12.2 入力ファイルと出力先を指定

python 02_analyze_TFT.py ^
  --lin IdVg-Vd0.1.xlsx ^
  --sat IdVg-Vd10.xlsx ^
  --outdir result

Windows PowerShellでは、行継続にバッククォートを使います。

python 02_analyze_TFT.py `
  --lin IdVg-Vd0.1.xlsx `
  --sat IdVg-Vd10.xlsx `
  --outdir result

Linux/macOSのシェルでは、行継続にバックスラッシュを使います。

python 02_analyze_TFT.py \
  --lin IdVg-Vd0.1.xlsx \
  --sat IdVg-Vd10.xlsx \
  --outdir result

12.3 解析条件を変更

python 02_analyze_TFT.py \
  --lin IdVg-Vd0.1.xlsx \
  --sat IdVg-Vd10.xlsx \
  --outdir result \
  --cox 2.24e-8 \
  --length 50.0e-6 \
  --width 300.0e-6 \
  --target-current 1.0e-10 \
  --ioff-threshold 1.0e-14 \
  --rolling-window 7

13. エラーと対処

13.1 入力ファイルが見つからない

表示例:

Error: LIN Id-Vg file not found: IdVg-Vd0.1.xlsx

対処:

13.2 必須列がない

表示例:

Error: LIN Id-Vg data is missing required columns: ['Vd'].

対処:

13.3 有効な傾きが計算できない

表示例:

Error: No valid slope values are available for Vth calculation.

対処:

13.4 target current に到達しない

Id が --target-current に到達しない場合、SS と V_{\mathrm{on}} は NaN になります。

対処:

14. 結果を確認するときの注意

本プログラムは、最大傾き法を用いて V_{\mathrm{th}} と移動度を求めます。そのため、ノイズが大きいデータや、測定点数が少ないデータでは、最大傾き点が不安定になることがあります。

結果を使う前に、少なくとも以下を確認してください。

15. テストプログラムによる確認

別途作成したテストプログラムがある場合は、次のように実行します。

pytest -q 05_test_analyze_TFT_refactored.py

また、seedやノイズレベルを指定できるテストプログラムとして実行する場合は、次のようにします。

python 05_test_analyze_TFT_refactored.py --target-script 02_analyze_TFT.py
python 05_test_analyze_TFT_refactored.py --seed 12345 --noise-level 0.005 --target-script 02_analyze_TFT.py

テストでは、人工的に生成したTFTデータを使い、既知の V_{\mathrm{th}} や移動度が再現されるかを確認します。

16. 実行レポートの作成例

実行ログと生成ファイルをレポートとして残す場合は、別途 make_run_report.py のような実行レポート作成ツールを使います。

例:

python make_run_report.py \
  --workdir . \
  --cmd "pytest -q 05_test_analyze_TFT_refactored.py" \
  --report 06_report_pytest.md \
  --html 1 \
  --html-name 06_report_pytest.html

このようなレポートには、以下を残しておくと後で確認しやすくなります。

17. pandocによる変換

このMarkdownファイルはpandocでWordやHTMLに変換できます。

Wordファイルに変換する例:

pandoc 08_analyze_TFT_manual.md -o 08_analyze_TFT_manual.docx

HTMLファイルに変換する例:

pandoc 08_analyze_TFT_manual.md -o 08_analyze_TFT_manual.html

数式は、インライン数式を $ LaTeX $、ブロック数式を $$ LaTeX $$ 形式で記述しています。

18. 配布時の推奨ファイル構成

配布時には、次のようなファイルを同じフォルダにまとめておくと便利です。

TFT_analysis/
  02_analyze_TFT.py
  05_test_analyze_TFT_refactored.py
  08_analyze_TFT_manual.md
  IdVg-Vd0.1.xlsx
  IdVg-Vd10.xlsx
  README.md

講義や研究室内で配布する場合は、サンプル入力ファイル、テストプログラム、マニュアル、実行レポート例を合わせて配布すると、利用者が再現確認しやすくなります。

19. まとめ

02_analyze_TFT.py は、TFTの I_D--V_G 測定データから代表的な特性値を抽出する解析プログラムです。

生成AIでリファクタリングしたコードを安全に使うためには、次の確認が重要です。

  1. 入力ファイルと列名を確認する
  2. 解析条件と単位系を確認する
  3. 出力CSVとグラフを確認する
  4. 人工データでテストする
  5. 実行レポートとマニュアルを残す

特に、V_{\mathrm{th}}、移動度、SS は解析条件やノイズの影響を受けるため、出力値だけでなく、グラフと入力データも合わせて確認してください。