title: "02_analyze_TFT.py 利用マニュアル" author: "Python Tutorial: Code Review" date: "2026-06-04" lang: ja
02_analyze_TFT.py は、薄膜トランジスタ(TFT)の I_D--V_G
測定データを読み込み、代表的なTFT動作パラメータを自動抽出するPythonプログラムです。
主に、次の2種類の測定データを解析します。
このプログラムは、Excelファイルから測定データを読み込み、解析済みCSVファイル、要約CSVファイル、確認用グラフ画像を出力します。
本プログラムでは、以下の代表値を計算します。
デフォルトでは、カレントディレクトリに次の2つのExcelファイルがあることを想定します。
| 用途 | デフォルトファイル名 | 必須列 |
|---|---|---|
| 線形領域 I_D--V_G データ | IdVg-Vd0.1.xlsx |
Vg, Vd, Id |
| 飽和領域 I_D--V_G データ | IdVg-Vd10.xlsx |
Vg, Id |
列名は大文字・小文字を含めて一致している必要があります。
入力ファイルはExcel形式(.xlsx)です。
最低限、以下の列が必要です。
| 列名 | 意味 | 典型的な単位 |
|---|---|---|
Vg |
ゲート電圧 | V |
Vd |
ドレイン電圧 | V |
Id |
ドレイン電流 | A |
飽和領域の解析では、Vg と Id
を使用します。線形領域の解析では、Vg, Vd,
Id を使用します。
Id
が0以下の点は、対数や平方根を計算できないため、解析用の電流列では
NaN として扱われます。
Python 3.10以降を推奨します。
必要なライブラリは以下です。
pip install numpy pandas matplotlib scikit-learn openpyxlpandas で .xlsx
ファイルを読むために、通常は openpyxl も必要です。
デフォルトファイル名を使う場合は、次のように実行します。
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| 引数 | デフォルト値 | 説明 |
|---|---|---|
--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 |
なし | エラー時に詳細なトレースバックを表示する |
しきい値電圧 V_{\mathrm{th}} は、最大傾き点における接線の x 切片として求めます。
最大傾き点を (V_G^*, y^*)、その点での傾きを m^* とすると、しきい値電圧は次式で計算されます。
V_{\mathrm{th}} = V_G^* - \frac{y^*}{m^*}
ここで、飽和領域では y = \sqrt{I_D}、線形領域では y = I_D を使います。
飽和領域では、\sqrt{I_D}--V_G の傾きから移動度を求めます。
\mu_{\mathrm{SAT}} = \frac{2L}{W C_{\mathrm{ox}}} \left(\frac{d\sqrt{I_D}}{dV_G}\right)^2
線形領域では、I_D--V_G の傾きから電界効果移動度を求めます。
\mu_{\mathrm{FE}} = \frac{L}{W C_{\mathrm{ox}} V_D} \frac{d I_D}{d V_G}
サブスレッショルドスイングは、\log_{10} I_D の傾きの逆数として計算します。
SS = \left(\frac{d\log_{10} I_D}{dV_G}\right)^{-1}
本プログラムでは、--target-current
で指定した電流値に最初に到達した点での傾きから SS を評価します。
実行後、出力先ディレクトリに以下のファイルが作成されます。
| ファイル名 | 内容 |
|---|---|
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 プロット |
output.csv には以下の列が出力されます。
| 列名 | 意味 |
|---|---|
Vth_SAT |
飽和領域のしきい値電圧 |
muSAT |
飽和領域移動度 |
SS_SAT |
飽和領域サブスレッショルドスイング |
Ion_SAT |
飽和領域オン電流 |
Vth_LIN |
線形領域のしきい値電圧 |
muFE |
線形領域電界効果移動度 |
SS_LIN |
線形領域サブスレッショルドスイング |
Ion_LIN |
線形領域オン電流 |
output_log.csv では、以下の列に対して \log_{10} 変換が行われます。
SS_SATIon_SATSS_LINIon_LINただし、列名は output.csv
と同じです。そのため、output_log.csv
を読む場合は、これらの列が元の値ではなく \log_{10}
変換後の値であることに注意してください。
python 02_analyze_TFT.pypython 02_analyze_TFT.py ^
--lin IdVg-Vd0.1.xlsx ^
--sat IdVg-Vd10.xlsx ^
--outdir resultWindows PowerShellでは、行継続にバッククォートを使います。
python 02_analyze_TFT.py `
--lin IdVg-Vd0.1.xlsx `
--sat IdVg-Vd10.xlsx `
--outdir resultLinux/macOSのシェルでは、行継続にバックスラッシュを使います。
python 02_analyze_TFT.py \
--lin IdVg-Vd0.1.xlsx \
--sat IdVg-Vd10.xlsx \
--outdir resultpython 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表示例:
Error: LIN Id-Vg file not found: IdVg-Vd0.1.xlsx
対処:
--lin または --sat
で正しいファイルパスを指定する表示例:
Error: LIN Id-Vg data is missing required columns: ['Vd'].
対処:
Vg, Vd, Id
の表記が正しいか確認する表示例:
Error: No valid slope values are available for Vth calculation.
対処:
Id がすべて0以下になっていないか確認するVg がほぼ一定値になっていないか確認する--rolling-window を小さくして再実行するId が --target-current
に到達しない場合、SS と V_{\mathrm{on}} は NaN
になります。
対処:
--target-current の値を下げる本プログラムは、最大傾き法を用いて V_{\mathrm{th}} と移動度を求めます。そのため、ノイズが大きいデータや、測定点数が少ないデータでは、最大傾き点が不安定になることがあります。
結果を使う前に、少なくとも以下を確認してください。
rootIdVg.png で接線が妥当な位置にあるかIdVg_LIN.png で線形フィット位置が妥当かoutput.csv の値が物理的に妥当な範囲かoutput_log.csv の値を元の値と混同していないか--cox, --length,
--width の単位系が整合しているか別途作成したテストプログラムがある場合は、次のように実行します。
pytest -q 05_test_analyze_TFT_refactored.pyまた、seedやノイズレベルを指定できるテストプログラムとして実行する場合は、次のようにします。
python 05_test_analyze_TFT_refactored.py --target-script 02_analyze_TFT.pypython 05_test_analyze_TFT_refactored.py --seed 12345 --noise-level 0.005 --target-script 02_analyze_TFT.pyテストでは、人工的に生成したTFTデータを使い、既知の V_{\mathrm{th}} や移動度が再現されるかを確認します。
実行ログと生成ファイルをレポートとして残す場合は、別途
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このようなレポートには、以下を残しておくと後で確認しやすくなります。
このMarkdownファイルはpandocでWordやHTMLに変換できます。
Wordファイルに変換する例:
pandoc 08_analyze_TFT_manual.md -o 08_analyze_TFT_manual.docxHTMLファイルに変換する例:
pandoc 08_analyze_TFT_manual.md -o 08_analyze_TFT_manual.html数式は、インライン数式を $ LaTeX $、ブロック数式を
$$ LaTeX $$ 形式で記述しています。
配布時には、次のようなファイルを同じフォルダにまとめておくと便利です。
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
講義や研究室内で配布する場合は、サンプル入力ファイル、テストプログラム、マニュアル、実行レポート例を合わせて配布すると、利用者が再現確認しやすくなります。
02_analyze_TFT.py は、TFTの I_D--V_G
測定データから代表的な特性値を抽出する解析プログラムです。
生成AIでリファクタリングしたコードを安全に使うためには、次の確認が重要です。
特に、V_{\mathrm{th}}、移動度、SS は解析条件やノイズの影響を受けるため、出力値だけでなく、グラフと入力データも合わせて確認してください。