tkfermi_python.py ドキュメント
概要
tkfermi_python.py は、半導体物理学や物性物理学などで頻出するフェルミ・ディラック積分を、高速かつ堅牢に計算するためのPythonモジュールです。
積分次数 \(r > -1\) の一般ケースに対応しており、特に頻出する \(r = 1/2\) および \(r = 3/2\) のための最適化されたインターフェースを提供します。
計算速度と精度を両立させるため、入力される無次元フェルミ準位 \(\eta\) の値に応じて、漸近展開、交替級数展開、および変数変換を用いた数値積分を自動的に切り替えるアルゴリズムが実装されています。
背景理論・アルゴリズム
本プログラムが計算対象とするフェルミ・ディラック積分 \(F_r(\eta)\) は、以下の数式で定義されます。
計算コストを削減し、幅広い \(\eta\) の値に対して安定した数値解を得るため、コード内では \(\eta\) の値域に基づいて3つのアルゴリズムを使い分けています。
1. 縮退極限(Degenerate limit)
無次元フェルミ準位が十分に大きい領域( \(\eta \ge 20.0\) )では、金属的な縮退状態に対応します。この領域では、ゾンマーフェルト展開に似た級数展開を用いて近似計算を行います。
2. 非縮退極限(Non-degenerate limit)
無次元フェルミ準位が負の領域( \(\eta < -0.1\) )では、ボルツマン分布に漸近する非縮退状態に対応します。この場合、以下の交替級数展開を用いて収束計算を行います。
3. 中間領域
上記以外の領域( \(-0.1 \le \eta < 20.0\) )では、数値積分を実行します。 直接積分する際の被積分関数の急激な減衰を安定的に処理するため、変数変換 \(t = x^2\) を適用し、以下の形式で積分を行います。
計算時には積分区間を \(0 \le x \le 1\) 、 \(1 \le x \le 4\) 、 \(4 \le x \le \mathrm{lim}\) の3つに分割し、それぞれの区間に対してガウス・クロンロッド求積法などによる適応型数値積分を適用しています。なお、積分の上限は \(\mathrm{lim} = 17.0 + 4.5 r + \eta\) として安全に打ち切られます。
また、同一パラメータでの反復計算を高速化するため、 functools.lru_cache によるメモ化(キャッシュ)機構が組み込まれています。
依存ライブラリ
本プログラムを実行するために必要なライブラリは以下の通りです。
標準ライブラリ
mathfunctools
非標準ライブラリ
scipy(数値積分機能scipy.integrate.quadのために使用)
入出力仕様
本プログラムにはファイル入出力の機能は実装されていません。 引数として、物理量に対応する各種パラメータを受け取り、計算結果を浮動小数点数として返します。
入力パラメータ
eta: 無次元フェルミ準位 \(\eta\) を表す浮動小数点数。r: 積分次数 \(r\) を表す浮動小数点数。epsabs,epsrel: 数値積分時の絶対許容誤差および相対許容誤差。limit: 数値積分時の区間分割数の上限。
出力
算出されたフェルミ・ディラック積分の値(浮動小数点数)。
実行例
本スクリプトは、コマンドラインから直接実行することで自己テスト(動作確認)を行うことができます。
自己テストでは、あらかじめ定義された複数の eta の値に対して \(r = 1/2\) および \(r = 3/2\) の積分値を計算し、標準出力に表示するとともに、キャッシュの使用状況を出力します。
python tkfermi_python.py