tkfermi_c.py ドキュメント

概要

tkfermi_c.py は、半導体物理学などで頻繁に現れるフェルミ・ディラック積分(未正規化)を高速に計算するためのPythonモジュールです。計算の大部分をC言語で記述された共有ライブラリ(tkfermi_core.dll、libtkfermi_core.dylib、または libtkfermi_core.so)に委譲し、scipy.integrate.quad と scipy.LowLevelCallable を組み合わせることで、Pythonのオーバーヘッドを最小限に抑えつつ高精度な数値積分を実行します。

目的と背景

半導体デバイス(薄膜トランジスタやダイオードなど)の特性解析において、キャリア濃度の計算にはフェルミ・ディラック積分が不可欠です。本コードは、高速な近似・漸近展開(Cライブラリ側で実装)と、中間領域における厳密な数値積分を組み合わせることで、幅広いフェルミ準位に対して安定かつ高速に積分値を評価することを目的としています。

動作原理と計算式

本モジュールで計算する未正規化のフェルミ・ディラック積分は、一般に以下の数式で定義されます。

\[F_r(\eta) = \int_{0}^{\infty} \frac{x^r}{1 + \exp(x - \eta)} dx\]

ここで、\(\eta\) は無次元化されたフェルミ準位(またはフェルミエネルギー)、\(r\) はバンド構造や散乱機構に依存する指数、\(x\) は積分変数(無次元化されたエネルギー)を表します。

モジュール内部では、\(\eta\) の値に応じて以下の3つの領域に分岐して計算を行います。

  1. 強い縮退領域( \(\eta \ge 20.0\) ) フェルミ分布関数がステップ関数に近づく性質を利用し、ゾンマーフェルト展開等の漸近展開(Cライブラリの fd_degenerate)を用いて高速に計算します。

  2. 非縮退領域( \(\eta < -0.1\) ) ボルツマン分布に漸近する性質を利用し、級数展開(Cライブラリの fd_nondegenerate)を用いて評価します。

  3. 中間領域( \(-0.1 \le \eta < 20.0\) ) scipy.integrate.quad を用いて厳密な数値積分を実行します。積分の被積分関数はCライブラリの fd_integrand を scipy.LowLevelCallable として渡し、Cレベルで高速にコールバックされます。また、数値積分の精度と安定性を向上させるため、積分区間を区間 \([0, 1]\)、区間 \([1, 4]\)、および区間 \([4, \mathrm{lim}]\) に分割して計算します。積分の上限は計算効率化のため \(\mathrm{lim} = 17.0 + 4.5 r + \eta\) として打ち切られます。

依存ライブラリ

標準ライブラリ:

  • ctypes

  • pathlib

  • platform

外部ライブラリ:

  • scipy (scipy.LowLevelCallable, scipy.integrate)

前提となるファイル:

  • 実行時、同じディレクトリにコンパイル済みのネイティブライブラリが必要です。OS環境に応じて、tkfermi_core.dll (Windows)、libtkfermi_core.dylib (macOS)、または libtkfermi_core.so (Linux) のいずれかを読み込みます。存在しない場合は例外が発生します。

入出力仕様

本プログラムは外部からインポートして使用するモジュールであり、コマンドラインインターフェース(CLI)による直接実行は想定されていません。

  • 入力 計算関数の引数として、無次元のフェルミ準位 \(\eta\) (eta) と、指数 \(r\) (r) を数値として受け取ります。また、キーワード引数として絶対誤差許容値 epsabs、相対誤差許容値 epsrel、および数値積分の最大分割数 limit を指定可能です。

  • 出力 浮動小数点数(float)として、評価された積分計算結果を返します。

実行例

外部のPythonスクリプトから本モジュールをインポートし、フェルミ・ディラック積分を計算する例を以下に示します。

import tkfermi_c

# eta = 5.0, r = 0.5 の未正規化フェルミ積分を計算
eta_val = 5.0
r_val = 0.5

# 汎用的な高速計算関数の呼び出し
result = tkfermi_c.FermiIntegral_fast(eta_val, r_val, epsabs=1.0e-10, epsrel=1.0e-8)
print(result)

# r = 0.5 (1/2) および r = 1.5 (3/2) 用のラッパー関数を利用する例
result_half = tkfermi_c.FermiIntegral_half(eta_val)
result_3half = tkfermi_c.FermiIntegral_3half(eta_val)
print(result_half)
print(result_3half)