このコードは誰向けか

  • 半導体物理学を学ぶ学生や教育者(教育用サンプル・参考実装として読む人向け)

  • 研究室内の個人用解析コードを利用・拡張する研究者(パラメータを変えて計算・可視化する人向け)

  • 物理モデルの数値解析ツールを試作する開発者(再利用・修正する人向け)

  • ※公開ライブラリのモジュールとして、そのまま別のシステムに組み込んで利用する開発者向けではない

用途の分類

このコードは以下の用途の特性を備えています。

  • 研究用解析コード

  • CLIツール

  • 教育用サンプル

  • バッチ処理

コードの長所と設計の評価

数値安定性と極限条件への配慮

  • 桁落ちの回避: fh 関数において、価電子帯がほぼ満たされている場合の桁落ち(1 - fe)を防ぐため、直接 expit((E - Ef) / (KB * T)) を計算するアプローチが取られています。

  • オーバーフロー/アンダーフロー対策: Fj 関数において、eta < 0 の場合に scale = exp(eta) とし、ロジスティック恒等式を用いて指数関数をくくり出すことで、浮動小数点数の相対精度を維持する処理が実装されています。

  • 特異点と積分精度の管理: Fj 内でフェルミ端や熱的な裾を考慮し、積分区間 cuts を sqrt(max(eta - 40, 0)) のように細かく分割した上で、scipy.integrate.quad による適応型数値積分を行っています。

  • ロバストな探索手法: solve 関数において、解の探索区間を初期幅から倍々に拡大(width *= 2)して解を囲い込み、scipy.optimize.brentq を適用することで、安全にフェルミ準位を探索する構造になっています。また、探索内の電荷中性条件 deltaQ を scale で正規化することで、スケール差による数値的不安定性を緩和しています。

構造と保守性

  • データ管理のモジュール化: Model データクラスによって物理パラメータがまとめられており、状態管理が明確です。

  • 堅牢な引数処理: initialize 関数にて、argparse を用いた入力値の有限性チェック(np.isfinite)や正負の制約チェックが行われています。

  • 可読性: 各関数に統一されたフォーマットのdocstringが記述されており、意図と入出力が明確に示されています。

制限事項と問題点

アーキテクチャと再利用性

  • CLIと計算の密結合: main 関数の中で、温度のスイープ計算、標準出力、CSVファイル保存(np.savetxt)、Matplotlibによるグラフ描画がすべて記述されています。このため、別のPythonスクリプトから「計算部分だけ」を再利用することが難しい構造です。

  • 計算コストとキャッシュの欠如: Fj 関数は数値積分 (quad) を実行しますが、キャッシュの仕組みは確認できません。nT の値が大きい場合や solve の反復回数が増加した場合、計算時間が顕著に増大する可能性があります。

  • スカラー処理への依存: fe, fh では numpy.ndarray に対応した記述が見られますが、solve や Ne, Nh などはスカラー値の入力を前提とした構造になっており、複数のパラメータに対する高度なベクトル化計算には適していません。

  • 物理モデルの柔軟性: バンドギャップ Eg や有効質量が温度に依存しない固定値モデルであることが Model の構造から確認できます。より高度な物理モデルへの拡張にはデータ構造の修正を伴います。

優先順位が高い改善点

コードを長期保守向け、またはライブラリとして再利用しやすくするためには、以下の修正が推奨されます。

  1. main 関数内の責務分離 計算実行、CSV出力、グラフ描画の処理をそれぞれ独立した関数に分割する。 (例: compute_temperature_sweep, save_results_to_csv, plot_carrier_statistics といった関数への切り出し)

  2. APIの独立性確保 計算結果を print で直接標準出力するのではなく、計算用APIがデータ構造(例: リストや辞書、あるいは pandas.DataFrame など)を返す設計に変更する。

  3. 計算の高速化検討 Fj 関数の呼び出しに対して functools.lru_cache などのキャッシュ機構を導入するか、計算速度が必要な場面向けに近似計算へのフォールバックを選択可能にする(数値的検証が必要)。

  4. ハードコードされた出力ファイル名の柔軟化 argparse のデフォルト値としては問題ありませんが、内部処理で carrier_statistics.csv 以外の任意のファイルオブジェクトやストリームに書き出せるように出力関数を設計する。

総合評価

このコードは、半導体のキャリア統計をボルツマン近似を用いずに厳密に計算するという目的において、研究用解析コードおよび教育用サンプルとして非常に適した実装です。特筆すべき点として、数値積分の区間分割や桁落ち防止策など、物理モデルを数値計算に落とし込む際の極限条件・数値安定性に対する深い配慮がコード構造から明確に読み取れます。

一方で、算出ロジックと可視化・ファイルI/Oの責務分離が不十分であるため、公開ライブラリとしてそのまま再利用するには制限があります。現状はCLIツールやバッチ処理用の単一スクリプトとしての完成度が高い状態であり、前述の責務分離を行うことで、さらに広い用途に応用可能なモジュールへと発展する可能性があります。