このコードは誰向けか
数値解析・物性研究者向け
研究室内の個人用解析コード向け
高速数値計算(スカラー用)の試作コード向け
公開ライブラリ利用者向けではない(配列入力の非対応などによる)
コードの長所
関数分離とモジュール化 物理的な極限条件に応じて
_DegenerateFermiDiracや_NonDegenerateFermiDiracに内部関数を分割しており、それぞれが単一の計算手法に特化する構造になっています。公開API(FermiIntegral_fastなど)と内部処理の責務分離が確認できます。数値安定性への配慮
_func_Fr_x2内においてif x > 26.0: return 0.0という分岐が存在し、被積分関数内のexp(x * x - eta)によるオーバーフローを回避する処理が組み込まれています。極限条件に応じた条件分岐
_FermiIntegral_cachedにおいて、eta >= 20.0、eta < -0.1、中間領域という3つの領域に対し、漸近展開・交替級数・数値積分を切り替える物理モデルに基づいた分岐が行われています。キャッシュの活用
@lru_cacheを用いて計算結果を再利用する仕組みに加え、_round_keyによって浮動小数点数を指定桁数で丸めることで、微小な丸め誤差によるキャッシュミスを防ぐ工夫がみられます。docstringの整備 各関数に対して引数・戻り値の型(type/rtype)と意味が記述されており、可読性を高める配慮がなされています。
問題点・制限事項
ベクトル化への非対応
math.expの利用や、if eta >= 20.0:といったスカラー用の条件分岐に依存しています。NumPyの配列(ndarray)などを引数として渡すとTypeErrorやValueErrorとなる構造であり、一括計算には適していません。無限ループのリスク
_NonDegenerateFermiDirac内のwhile True:ループは、abs(term) < 1.0e-8を満たした時のみ終了します。特定の条件下で項が収束しない場合、あるいは丸め誤差によって閾値を下回らない場合、ループから抜け出せなくなる可能性があります。精度要件の不一致(hard-coded値の存在) 公開APIである
FermiIntegral_fast等でepsabsやepsrelを受け取っていますが、これらの値はscipy.integrate.quadによる数値積分にのみ渡されています。交替級数の打ち切り判定には1.0e-8がハードコードされており、ユーザー指定の精度が適用されません。
数値計算コードとしての評価
極限条件と漸近処理 縮退限界(ゾンマーフェルト展開的アプローチ)および非縮退限界向けの専用処理が用意されており、数値積分の破綻を避けるための合理的な構造を持っています。
overflow / underflow 積分時のオーバーフローはカットオフで対策されています。一方で、非縮退領域における
exp(s * eta)については、etaが極端に大きな負の値をとる場合にアンダーフローが発生する可能性があります。キャッシュ精度
_round_keyでの丸め桁数がndigit=10に固定されているため、要求される積分精度(epsabs=1.0e-10など)と照らし合わせた場合、キャッシュキーの丸めによって意図しない近似結果が返却される可能性があります。
アーキテクチャと設計の評価
API設計 一般的な積分関数
FermiIntegral_fastと、特定次数に固定されたラッパー関数FermiIntegral_half、FermiIntegral_3halfを提供しており、利用者が使い分けやすいAPI構造となっています。テスト容易性 ファイル末尾の
if __name__ == "__main__":ブロックにて、標準出力を伴う簡易なテストが実装されており、単体での動作確認が容易です。ただし、自動化されたユニットテスト(unittestやpytestなど)のフレームワークは用いられておらず、回帰テストを行うには追加の仕組みが必要になると考えられます。
優先順位が高い改善点
無限ループの防止策の導入
_NonDegenerateFermiDiracのwhile True:ループに対し、最大反復回数の上限(例:max_iter=1000を設けてforループにする等)を追加すること。精度パラメータの統一 ユーザーが指定した
epsabsなどの許容誤差を、_NonDegenerateFermiDiracの1.0e-8と記された収束判定にも連携させて適用すること。ベクトル化のサポート 配列入力に対する計算を可能にするため、公開APIの内部で配列の要素ごとにスカラー計算を適用するラッパー(例:
numpy.vectorizeを用いたインターフェース層など)を検討すること。キャッシュ丸め桁数の動的化
_round_keyの丸め桁数を10の固定値から、引数のepsabsやepsrelの値に基づいて連動させる形へ変更すること。
用途適性のまとめ
本コードは、特定の物理パラメータ領域の分割や極限処理が適切に実装されており、研究用の解析コードやスカラー計算用の試作コードとして高い適性を示しています。小規模なパラメータスイープや単一の計算タスクにおいては、十分なパフォーマンスと安定性を発揮すると考えられます。 一方で、配列計算(ベクトル化)に非対応である点や、ループの収束安全性・誤差指定の適用範囲に一部制限が見られることから、現段階では不特定多数が利用する公開ライブラリや大規模なバッチ処理システムへの組み込みには検証と修正が必要な状態です。