Fj_test_extreme.py ドキュメント

概要

フェルミ・ディラック積分 (Fermi-Dirac integral) の非正規化関数について、数値積分と漸近展開・極限近似を用いたテストおよびベンチマークを実行するプログラムです。特に \(j = -1\) の解析的処理や、極端なパラメータ(極低温極限や強縮退極限など)における計算精度の検証を目的としています。

動作環境と依存ライブラリ

本プログラムはPythonで記述されており、標準ライブラリ(time, math)に加えて、以下の非標準ライブラリに依存しています。

  • numpy

  • scipy

  • tkfermi_integral (内部で FermiIntegral_fast を呼び出すために使用)

理論とアルゴリズム

コードは、物理学におけるフェルミ粒子の統計的性質を記述するためのフェルミ・ディラック積分を計算します。 基準となる積分の定義は以下の通りです。

\[F_j(\eta) = \int_0^\infty x^j f(\eta - x) dx\]

ここで、\(f(z)\) はフェルミ・ディラック分布関数であり、以下のように定義されます。

\[f(z) = \frac{1}{1+\exp(-z)}\]

プログラム内では以下のアルゴリズムおよび特殊条件に基づく計算が実装されています。

特殊ケース (\(j = -1\))

\(j = -1\) の場合、被積分関数は \(x \to 0\) において発散するため、漸化式 \(\frac{d}{d\eta} F_j(\eta) = F_{j-1}(\eta)\) を用いた解析的関係から以下のように定義されます。

\[F_0(\eta) = \int_0^\infty f(\eta-x) dx = \log(1+\exp(\eta))\]
\[F_{-1}(\eta) = \frac{d}{d\eta} F_0(\eta) = f(\eta)\]

非縮退極限 (\(\eta \ll 0\))

フェルミ・ディラック分布がマクスウェル・ボルツマン分布に近似できる領域では、ガンマ関数 \(\Gamma(z)\) を用いて以下のように近似されます。

\[F_j(\eta) \approx \exp(\eta) \int_0^\infty x^j e^{-x} dx = \exp(\eta) \Gamma(j+1)\]

絶対零度極限 (\(T \to 0\))

絶対零度における階段関数としての極限では、\(\eta > 0\) において以下のように計算されます。

\[F_j(\eta) \approx \int_0^{\max(\eta,0)} x^j dx = \frac{\max(\eta,0)^{j+1}}{j+1}\]

縮退極限 (\(\eta \gg 1\))

強縮退領域では、ゾンマーフェルト展開 (Sommerfeld expansion) を用いて近似されます。プログラムでは最大で \(\pi^4\) の項まで考慮されています。

\[F_j(\eta) \approx \frac{\eta^{j+1}}{j+1} + \frac{\pi^2}{6} j \eta^{j-1} + \frac{7\pi^4}{360} j(j-1)(j-2) \eta^{j-3}\]

積分の上限設定

数値積分(scipy.integrate.quad)に際しては、積分範囲の上限を無限大ではなく、計算精度を維持しつつ収束を早めるため \(\max(\eta + 60.0, 120.0)\) というヒューリスティックな有限値に設定しています。

実行例

コマンドラインから引数なしで実行します。スクリプト内に定義されたパラメータセットに従って、自動的にテストとベンチマークが実行され、標準出力へ結果が表示されます。

python Fj_test_extreme.py

実行されるテストスイートの内容は以下の通りです。

  • 一貫性チェック : scipy.integrate.quad と scipy.special.expit を組み合わせた計算、生の指数関数での計算、および外部の高速実装(tkfermi_integral)の結果を比較します。

  • 極限チェック : 漸近近似式や極限値(絶対零度極限、ゾンマーフェルト展開)との相対誤差を評価します。

  • ベンチマーク : 各計算メソッドにおける呼び出し1回あたりの実行時間を測定します。

  • 極端なパラメータのテスト : 計算コストが高いため、極端な \(\eta\) 値について各ポイント1回のみ実行して正常動作を確認します。

入出力仕様

  • 入力 : コード内部にハードコードされた配列(j_values, eta_values, eta_extreme 等)を入力パラメータとして使用します。外部ファイルやコマンドライン引数からの入力機能は実装されていません。

  • 出力 : すべての検証結果およびベンチマーク結果を、フォーマットされたテキストとして標準出力に表示します。結果のファイルへの出力機能はコードからは確認できません。