""" 概要: 高速でロバストなフェルミ・ディラック積分ライブラリです。 詳細説明: 一般的な r > -1 に対応しており、r = 1/2 と 3/2 には専用の最適化パスがあります。 eta >= 20 の場合は縮退展開を使用し、eta < -0.1 の場合は非縮退交替級数を使用します。 中間領域では z = x^2 変換と数値積分を使用します。Python 3.12 で安全に動作します。 """ from math import exp, gamma from functools import lru_cache from scipy import integrate # ============================================================ # internal: integrand (z = x^2) # ============================================================ def _func_Fr_x2(x, eta, r): """ 概要: z = x^2 変換を用いた数値積分用の被積分関数です。 引数: :param x: 積分変数 :type x: float :param eta: 規格化化学ポテンシャル :type eta: float :param r: 次数 :type r: float 戻り値: :returns: 被積分関数の値 :rtype: float """ if x > 26.0: return 0.0 return 2.0 * x ** (2.0 * r + 1.0) / (exp(x * x - eta) + 1.0) # ============================================================ # internal: degenerate limit (Sommerfeld-like) # ============================================================ _DegenerateFD_z = ( 0.822467, 0.947033, 0.985551, 0.996233, 0.999040, 0.999758, 0.999939, 0.999985, 0.999996, 0.999999 ) def _DegenerateFermiDirac(eta, r): """ 概要: 縮退限界におけるフェルミ・ディラック積分を計算します。 詳細説明: eta が大きい領域でゾンマーフェルト展開に似た手法を用いて計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param r: 次数 :type r: float 戻り値: :returns: 積分値 :rtype: float """ gi = eta ** (r + 1.0) / (r + 1.0) t = r gg = t / (eta * eta) gs = gg * _DegenerateFD_z[0] t -= 1.0 for k in range(1, 10): gg *= t * (t - 1.0) / (eta * eta) gs += gg * _DegenerateFD_z[k] t -= 2.0 return gi * (1.0 + 2.0 * (r + 1.0) * gs) # ============================================================ # internal: non-degenerate limit (alternating series) # ============================================================ def _NonDegenerateFermiDirac(eta, r): """ 概要: 非縮退限界におけるフェルミ・ディラック積分を計算します。 詳細説明: eta が負で絶対値が大きい領域で交替級数を用いて計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param r: 次数 :type r: float 戻り値: :returns: 積分値 :rtype: float """ s = 1.0 total = 0.0 while True: term = exp(s * eta) / s ** (r + 1.0) total += term s += 1.0 term = exp(s * eta) / s ** (r + 1.0) total -= term s += 1.0 if abs(term) < 1.0e-8: break return total * gamma(r + 1.0) # ============================================================ # cache-safe wrapper # ============================================================ def _round_key(x, ndigit=10): """ 概要: キャッシュキー用に浮動小数点数を指定した桁数で丸めます。 引数: :param x: 丸める対象の数値 :type x: float :param ndigit: 丸めの桁数 :type ndigit: int 戻り値: :returns: 丸められた数値 :rtype: float """ return round(float(x), ndigit) @lru_cache(maxsize=1024) def _FermiIntegral_cached(eta, r, epsabs, epsrel, limit): """ 概要: キャッシュを利用してフェルミ・ディラック積分を計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param r: 次数 :type r: float :param epsabs: 数値積分の絶対誤差許容値 :type epsabs: float :param epsrel: 数値積分の相対誤差許容値 :type epsrel: float :param limit: 数値積分の区間分割数の上限 :type limit: int 戻り値: :returns: 計算された積分値 :rtype: float """ # degenerate if eta >= 20.0: return _DegenerateFermiDirac(eta, r) # non-degenerate if eta < -0.1: return _NonDegenerateFermiDirac(eta, r) # intermediate: z = x^2 + quad lim = 17.0 + 4.5 * r + eta f = lambda x: _func_Fr_x2(x, eta, r) ret = 0.0 ret += integrate.quad(f, 0.0, 1.0, epsabs=epsabs, epsrel=epsrel, limit=limit)[0] ret += integrate.quad(f, 1.0, 4.0, epsabs=epsabs, epsrel=epsrel, limit=limit)[0] ret += integrate.quad(f, 4.0, lim, epsabs=epsabs, epsrel=epsrel, limit=limit)[0] return ret # ============================================================ # public API # ============================================================ def FermiIntegral_fast( eta, r, *, epsabs=1.0e-10, epsrel=1.0e-8, limit=50 ): """ 概要: 一般的なフェルミ・ディラック積分 F_r(eta) を計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param r: 次数 :type r: float :param epsabs: 数値積分の絶対誤差許容値 :type epsabs: float :param epsrel: 数値積分の相対誤差許容値 :type epsrel: float :param limit: 数値積分の区間分割数の上限 :type limit: int 戻り値: :returns: フェルミ・ディラック積分の値 :rtype: float """ key = ( _round_key(eta), _round_key(r), epsabs, epsrel, limit, ) return _FermiIntegral_cached(*key) def FermiIntegral_half( eta, *, epsabs=1.0e-10, epsrel=1.0e-8, limit=50 ): """ 概要: 次数 r が 1/2 の場合のフェルミ・ディラック積分を計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param epsabs: 数値積分の絶対誤差許容値 :type epsabs: float :param epsrel: 数値積分の相対誤差許容値 :type epsrel: float :param limit: 数値積分の区間分割数の上限 :type limit: int 戻り値: :returns: フェルミ・ディラック積分の値 :rtype: float """ return FermiIntegral_fast( eta, 0.5, epsabs=epsabs, epsrel=epsrel, limit=limit ) def FermiIntegral_3half( eta, *, epsabs=1.0e-10, epsrel=1.0e-8, limit=50 ): """ 概要: 次数 r が 3/2 の場合のフェルミ・ディラック積分を計算します。 引数: :param eta: 規格化化学ポテンシャル :type eta: float :param epsabs: 数値積分の絶対誤差許容値 :type epsabs: float :param epsrel: 数値積分の相対誤差許容値 :type epsrel: float :param limit: 数値積分の区間分割数の上限 :type limit: int 戻り値: :returns: フェルミ・ディラック積分の値 :rtype: float """ return FermiIntegral_fast( eta, 1.5, epsabs=epsabs, epsrel=epsrel, limit=limit ) # ============================================================ # self-test / example # ============================================================ if __name__ == "__main__": print("Fermi–Dirac integral test") print("") eta_list = [-10.0, -3.0, -1.0, 0.0, 2.0, 5.0, 10.0] print("r = 1/2") for eta in eta_list: print(f" eta={eta:6.2f} F1/2={FermiIntegral_half(eta):.8e}") print("\nr = 3/2") for eta in eta_list: print(f" eta={eta:6.2f} F3/2={FermiIntegral_3half(eta):.8e}") print("\ncache info:") print(_FermiIntegral_cached.cache_info())