mu_T_Fit_tkFit プログラム仕様
半導体の散乱モデルに基づいたホール移動度(μ-T)データの最小二乗法フィッティングツール。
概要: このスクリプトは、半導体のホール移動度（μ-T）データの非線形最小二乗法フィッティングを実行します。 複数の散乱機構（光学的フォノン散乱、中性不純物散乱、格子振動散乱）と粒界散乱モデル（KGBモデル） を考慮したモデルを用いて、移動度の温度依存性を解析します。
詳細説明: 与えられたホール移動度（μ）と温度（T）の関係データに対し、以下の散乱機構を組み合わせたモデルを適用します。 - 光学的フォノン散乱 (Optical Phonon Scattering): μ_op^(-1) = A_op / (exp(E_op / kBT) - 1) - 中性不純物散乱 (Neutral Impurity Scattering): μ_T0^(-1) = A_T0 - 格子振動散乱 (Acoustic Phonon Scattering): μ_T3/2^(-1) = A_T3/2 * T^(-1.5) - 粒界散乱 (Grain Boundary Scattering): μ = K_GB * μ_in-grain
ここで、K_GB = exp(-V_B / kBT + (s_phi / kBT)^2 / 2) μ_in-grain^(-1) = μ_op^(-1) + μ_T0^(-1) + μ_T3/2^(-1)
スクリプトは、フィッティングモード ('fit')、初期パラメータ設定モード ('init')、シミュレーションモード ('sim') の3つの主要なモードで動作します。 - 'fit'モードでは、非線形最小二乗法を用いて最適化を行い、モデルパラメータを決定します。 - 'init'モードでは、線形最小二乗法に近い形で初期パラメータを探索します。 - 'sim'モードでは、既存のパラメータセットに基づき移動度を計算し、観測データと比較します。
結果として、最適化されたパラメータ、各散乱機構による移動度成分、およびそれらの全体移動度に対する寄与度を計算し、 Excelファイルへの保存とグラフ表示を行います。
関連リンク: mu-T-Fit_tkFit_usage
- electrical.mu_T_Fit_tkFit.KGB(T, VB, s_phi)[ソース]
粒界散乱モデル (KGBモデル) の伝導率因子を計算する。
概要: 温度Tにおける粒界散乱モデル（KGBモデル）に基づく伝導率因子を計算する。
詳細説明: KGB (Kainthla-Gandhi-Bhalla) モデルは、粒界ポテンシャル障壁による電子の散乱を記述します。 ekBT = e / kB / T は熱エネルギーの逆数に比例する量で、Boltzmann定数`kB`と素電荷`e`が使用されます。 `VB`は粒界ポテンシャルの平均値、`s_phi`は粒界ポテンシャルのばらつきを表します。
引数: :param T: float 温度 (K)。 :param VB: float 粒界ポテンシャルエネルギー (eV)。 :param s_phi: float 粒界ポテンシャルのばらつき (eV)。
戻り値: :returns: float KGBモデルによる伝導率因子。
- electrical.mu_T_Fit_tkFit.cal_mu_components(T, _Eop, _Aop, _AT0, _AT32, _VB, _s_phi)[ソース]
移動度の各散乱機構からの成分と合計移動度を計算する。
概要: 光学的フォノン、中性不純物、格子振動散乱による移動度成分と、粒界散乱の影響を考慮した合計移動度を計算する。
詳細説明: 各散乱機構（光学的フォノン、中性不純物、格子振動）による移動度逆数を合計して粒内移動度を求め、 それにKGBモデルの伝導率因子を乗じることで合計移動度を算出します。 計算中にゼロ除算が発生する可能性がある場合、警告を出力し、安定した結果を得るために 対応する移動度成分を大きな値（1e10）に補正します。
引数: :param T: float 温度 (K)。 :param _Eop: float 光学的フォノンのエネルギー (eV)。 :param _Aop: float 光学的フォノン散乱係数。 :param _AT0: float 中性不純物散乱係数。 :param _AT32: float 格子振動散乱係数。 :param _VB: float 粒界ポテンシャルエネルギー (eV)。 :param _s_phi: float 粒界ポテンシャルのばらつき (eV)。
戻り値: :returns mu_tot: float 合計移動度 (cm^2/Vs)。 :returns mu_KGB: float KGBモデルによる伝導率因子。 :returns mu_ingrain: float 粒内移動度 (cm^2/Vs)。 :returns mu_op: float 光学的フォノン散乱による移動度 (cm^2/Vs)。 :returns mu_T0: float 中性不純物散乱による移動度 (cm^2/Vs)。 :returns mu_T32: float 格子振動散乱による移動度 (cm^2/Vs)。
- electrical.mu_T_Fit_tkFit.cal_mu_from_params(T, _Eop, _Aop, _AT0, _AT32, _VB, _s_phi)[ソース]
指定されたパラメータと温度に基づいて合計移動度を計算する。
概要: cal_mu_components`関数を呼び出し、その結果から合計移動度 (`mu_tot) のみを返す。
詳細説明: この関数は主に`scipy.optimize.minimize`などの最適化ルーチンに渡されるコールバック関数として設計されています。 フィッティングの目的関数内で、与えられたパラメータセットから計算される移動度を提供します。
引数: :param T: float 温度 (K)。 :param _Eop: float 光学的フォノンのエネルギー (eV)。 :param _Aop: float 光学的フォノン散乱係数。 :param _AT0: float 中性不純物散乱係数。 :param _AT32: float 格子振動散乱係数。 :param _VB: float 粒界ポテンシャルエネルギー (eV)。 :param _s_phi: float 粒界ポテンシャルのばらつき (eV)。
戻り値: :returns: float 合計移動度 (cm^2/Vs)。
- electrical.mu_T_Fit_tkFit.fit_mu_T(app)[ソース]
ホール移動度データに対する非線形最小二乗フィッティングを実行する。
概要: 指定されたデータファイルからホール移動度データを読み込み、モデルに基づいて非線形最小二乗法でフィッティングを行う。 フィッティングの初期化、最適化、結果の表示、パラメータとフィッティングデータの保存、およびグラフ表示を行う。
詳細説明: この関数は以下の主要なステップを実行します: 1. フィッティング設定のログ出力。 2. `tkFit`オブジェクトの初期化とデータファイルの読み込み。 3. フィッティング対象となるパラメータ（varname, unit, pk, optidなど）の設定。 4. パラメータファイルからの初期パラメータの読み込み。 5. フィッティング関数として`cal_mu_from_params`を設定。 6. 初期フィッティング結果の計算と表示。 7. 初期状態のグラフ描画。 8. `scipy.optimize.minimize`を使用した非線形最適化の実行。 9. 最適化された最終パラメータとフィッティングスコアの表示。 10. 各散乱機構からの移動度成分と、それらの重み（寄与度）の計算と表示。 11. パラメータファイル、フィッティングデータ、成分データをExcelファイルに保存。 12. 最終的なフィッティング結果と分解された移動度成分、重みをグラフとして表示。
引数: :param app: tkApplicationのインスタンス。アプリケーション全体の制御とパラメータを保持。
戻り値: None
- electrical.mu_T_Fit_tkFit.initialize()[ソース]
アプリケーションとパラメータを初期化する。
概要: `tkApplication`と`tkParams`オブジェクトを作成し、スクリプト全体の制御パラメータを設定する。
詳細説明: フィッティングモード、入力ファイルパス、データ列指定（xlabel, ylabel）、 フィッティングおよび計算対象の温度範囲、最適化アルゴリズム、イテレーション数、許容誤差、 グラフ設定（色、サイズ、フォントサイズなど）、そして移動度モデルの初期パラメータ （Eop, Aop, AT0, AT32, VB, s_phi）がここで定義されます。
戻り値: :returns app: tkApplicationのインスタンス。アプリケーションの全体的な制御とユーティリティを提供。 :returns cparams: tkParamsのインスタンス。アプリケーション全体の制御パラメータを保持。
- electrical.mu_T_Fit_tkFit.main()[ソース]
スクリプトのメインエントリポイント。
概要: アプリケーションとパラメータの初期化、コマンドライン引数によるパラメータの更新、 ログファイル設定、パラメータファイル読み込み、および指定されたモードに応じた処理を実行する。
詳細説明: この関数は、プログラムの開始点として以下の処理を行います。 1. `initialize`関数を呼び出して、`tkApplication`と`tkParams`オブジェクトを準備します。 2. コマンドライン引数を解析し、`cparams`の初期設定を上書きします。 3. ログファイルのパスを設定し、標準出力をログファイルにもリダイレクトします。 4. パラメータファイルのパスを決定し、既存のパラメータがあれば読み込みます。 5. 再度コマンドライン引数を解析し、読み込んだパラメータをさらに上書きします。 6. `cparams`の現在のパラメータ設定をコンソールに出力します。 7. `cparams.mode`の値に応じて、`fit_mu_T`関数（フィッティング）または`sim`関数（シミュレーション）を呼び出します。 8. サポートされていないモードが指定された場合はエラーメッセージを表示します。 9. 処理の終了時にアプリケーションを終了し、一時停止します。
戻り値: None
- electrical.mu_T_Fit_tkFit.muinv_T0(T, AT0)[ソース]
中性不純物散乱（またはT^0依存性散乱）による移動度の逆数を計算する。
概要: 温度Tにおける中性不純物散乱による移動度逆数 (1/μ_T0) を計算する。
詳細説明: この散乱機構は温度にほとんど依存しない成分として扱われ、主に低温領域で影響を与えることがあります。
引数: :param T: float 温度 (K)。 :param AT0: float 中性不純物散乱係数。
戻り値: :returns: float 中性不純物散乱による移動度の逆数。
- electrical.mu_T_Fit_tkFit.muinv_T32(T, AT32)[ソース]
格子振動散乱（またはT^-1.5依存性散乱）による移動度の逆数を計算する。
概要: 温度Tにおける格子振動散乱（音響フォノン散乱など）による移動度逆数 (1/μ_T3/2) を計算する。
詳細説明: 音響フォノン散乱などの格子振動による散乱は、通常、移動度がT^(-1.5)に比例する形で記述されます。 これは中〜高温領域で重要な散乱機構です。
引数: :param T: float 温度 (K)。 :param AT32: float 格子振動散乱係数。
戻り値: :returns: float 格子振動散乱による移動度の逆数。
- electrical.mu_T_Fit_tkFit.muinv_op(T, Eop, Aop)[ソース]
光学的フォノン散乱による移動度の逆数を計算する。
概要: 温度Tにおける光学的フォノン散乱による移動度逆数 (1/μ_op) を計算する。
詳細説明: 光学的フォノン散乱は、高温領域で主要な散乱機構の一つです。 ekBT = e / kB / T は熱エネルギーの逆数に比例する量で、Boltzmann定数`kB`と素電荷`e`が使用されます。
引数: :param T: float 温度 (K)。 :param Eop: float 光学的フォノンのエネルギー (eV)。 :param Aop: float 光学的フォノン散乱係数。
戻り値: :returns: float 光学的フォノン散乱による移動度の逆数。
- electrical.mu_T_Fit_tkFit.plot_muT_decomposed(app, cparams, fit, ax, xT, ymu, ymucal=None, ymu_ingrain=None, ymuop=None, ymuT0=None, ymuT32=None, xlabel='T (K)', ylabel='$\\mu$ (cm$^2$/Vs)', colors=None, markersize=1.0, plot_event=None)[ソース]
ホール移動度の観測値と計算値、および分解された移動度成分をプロットする。
概要: 指定されたMatplotlib Axesオブジェクトに、観測されたホール移動度、フィッティングされた移動度、 そして各散乱機構（光学的フォノン、中性不純物、格子振動）による移動度成分をプロットする。
詳細説明: 観測データはマーカーで、計算結果は実線でプロットされます。 粒内移動度、各散乱成分移動度は破線で表示され、各成分の寄与を視覚的に理解するのに役立ちます。 軸ラベル、凡例、マーカーサイズ、色などのプロット設定は`cparams`から取得されます。
引数: :param app: tkApplicationのインスタンス。 :param cparams: tkParamsのインスタンス。グラフの描画設定を保持。 :param fit: tkFitのインスタンス。データおよびフィッティングに関する情報を保持。 :param ax: matplotlib.axes.Axes プロット対象のMatplotlib Axesオブジェクト。 :param xT: numpy.ndarray 温度データの配列 (K)。 :param ymu: numpy.ndarray 観測された移動度データの配列 (cm$^2$/Vs)。 :param ymucal: numpy.ndarray, optional 計算された（フィッティングされた）移動度データの配列。デフォルトはNone。 :param ymu_ingrain: numpy.ndarray, optional 粒内移動度データの配列。デフォルトはNone。 :param ymuop: numpy.ndarray, optional 光学的フォノン散乱による移動度データの配列。デフォルトはNone。 :param ymuT0: numpy.ndarray, optional 中性不純物散乱による移動度データの配列。デフォルトはNone。 :param ymuT32: numpy.ndarray, optional 格子振動散乱による移動度データの配列。デフォルトはNone。 :param xlabel: str, optional X軸のラベル。デフォルトは"T (K)"。 :param ylabel: str, optional Y軸のラベル。デフォルトは"$mu$ (cm$^2$/Vs)"。 :param colors: list, optional プロットに使用する色のリスト。デフォルトはNone。 :param markersize: float, optional データポイントのマーカーサイズ。デフォルトは1.0。 :param plot_event: tkPlotEvent, optional プロットイベントハンドラ。プロットデータ登録に使用。デフォルトはNone。
戻り値: None
- electrical.mu_T_Fit_tkFit.plot_muT_weight(app, cparams, fit, ax, xT, ywmugb, ywmuop, ywmuT0, ywmuT32, xlabel='T (K)', ylabel='Linear weight', colors=None, markersize=1.0, plot_event=None)[ソース]
各散乱機構の線形重み（寄与度）をプロットする。
概要: 指定されたMatplotlib Axesオブジェクトに、粒界散乱、光学的フォノン散乱、 中性不純物散乱、格子振動散乱の各機構の線形重みをプロットする。
詳細説明: 各散乱機構が全体移動度にどれだけ寄与しているかを線形重みとしてプロットします。 これにより、特定の温度範囲でどの散乱機構が支配的であるかを視覚的に分析できます。 軸ラベル、凡例、マーカーサイズ、色などのプロット設定は`cparams`から取得されます。
引数: :param app: tkApplicationのインスタンス。 :param cparams: tkParamsのインスタンス。グラフの描画設定を保持。 :param fit: tkFitのインスタンス。データおよびフィッティングに関する情報を保持。 :param ax: matplotlib.axes.Axes プロット対象のMatplotlib Axesオブジェクト。 :param xT: numpy.ndarray 温度データの配列 (K)。 :param ywmugb: numpy.ndarray 粒界散乱の重みデータの配列。 :param ywmuop: numpy.ndarray 光学的フォノン散乱の重みデータの配列。 :param ywmuT0: numpy.ndarray 中性不純物散乱の重みデータの配列。 :param ywmuT32: numpy.ndarray 格子振動散乱の重みデータの配列。 :param xlabel: str, optional X軸のラベル。デフォルトは"T (K)"。 :param ylabel: str, optional Y軸のラベル。デフォルトは"Linear weight"。 :param colors: list, optional プロットに使用する色のリスト。デフォルトはNone。 :param markersize: float, optional データポイントのマーカーサイズ。デフォルトは1.0。 :param plot_event: tkPlotEvent, optional プロットイベントハンドラ。プロットデータ登録に使用。デフォルトはNone。
戻り値: None
- electrical.mu_T_Fit_tkFit.sim(app)[ソース]
ホール移動度の温度依存性をシミュレーションし、観測データと比較する。
概要: パラメータファイルから読み込んだモデルパラメータを使用して、ホール移動度の温度依存性をシミュレーションする。 観測データとの比較を行い、結果をファイルに保存し、温度および1000/Tに対してプロットする。
詳細説明: この関数は以下の主要なステップを実行します: 1. シミュレーション設定のログ出力。 2. `tkFit`オブジェクトの初期化とデータファイルの読み込み。 3. シミュレーションに使用するパラメータ（varname, unit, pk, optidなど）の設定。 4. パラメータファイルからのパラメータの読み込み。 5. シミュレーション関数として`cal_mu_from_params`を設定。 6. シミュレーション結果の計算と表示。 7. 結果データ（温度、1000/T、観測移動度、シミュレーション移動度）をExcelファイルに保存。 8. 観測データとシミュレーション結果を比較するグラフ（μ-Tとμ-1000/T）を表示。
引数: :param app: tkApplicationのインスタンス。アプリケーション全体の制御とパラメータを保持。
戻り値: None
- electrical.mu_T_Fit_tkFit.update_vars(app, cparams)[ソース]
コマンドライン引数に基づいて制御パラメータを更新する。
概要: スクリプト実行時に与えられたコマンドライン引数を解析し、`cparams`の対応する設定を上書きする。
詳細説明: tklib.tkutils`モジュールから提供される`getarg, getintarg, `getfloatarg`関数を使用して、 モード、最適化手法、入力ファイル、プロットの軸、温度範囲、最大反復回数、許容誤差、差分計算のステップサイズなど、 様々な制御パラメータをコマンドライン引数の値で更新します。
引数: :param app: tkApplicationのインスタンス。引数取得に使用。 :param cparams: tkParamsのインスタンス。更新対象の制御パラメータを保持。