tkfermi 部分C化とベンチマーク
============================
対象: 元のtkfermiの級数、漸近展開、数値積分の被積分関数。
数値積分本体はSciPy quadのままです。C内で積分全体を行う版ではありません。
式、分岐閾値、係数、打ち切り、積分区間、既定許容誤差、入力の丸めを維持。
Cの被積分関数はLowLevelCallableで直接呼びます。
元Python版は添付ファイルを内容変更せずtkfermi_python.pyの名前で同梱。
ベンチマーク内で__wrapped__を使ってキャッシュを無効化します。
C版にもキャッシュはありません。いずれも元の非規格化積分を返します。
配列一括APIは今回の範囲には含めていません。

1. 必要なPythonライブラリ
  python -m pip install numpy scipy

2. ビルド（展開したフォルダー内で実行）
  python build.py

Windows:
  GCC/ClangまたはMicrosoft Visual C++のCコンパイラが必要です。
  64bit Pythonには64bitのコンパイラを使用してください。
  MSVCの場合は「x64 Native Tools Command Prompt for VS」を開いて実行:
    python build.py --compiler cl
  MinGW-w64のGCCがPATHにある場合:
    python build.py --compiler gcc
  tkfermi_core.dllが生成されます。
  Visual C++ Redistributableだけではビルドできません。

Linux / AlmaLinux:
  GCCが必要です。未導入なら sudo dnf install gcc
    python build.py --compiler gcc
  libtkfermi_core.soが生成されます。

macOS:
  Xcode Command Line Tools等のClangが必要です。
    python build.py --compiler clang
  libtkfermi_core.dylibが生成されます。

fast-mathは使用しません。
コンパイラは--compilerでパスを指定することもできます。

3. 元実装との一致を確認
  python verify.py
  r=0.5/1.5、eta=-30..100、分岐の直前直後と許容誤差変更を確認。
  数学的な真値の検証ではなく、元Python実装との一致確認です。

4. ベンチマーク
  python benchmark.py -n 10000 --repeat 3
  python benchmark.py -n 10000 --eta -10 0 10 20 100
  python benchmark.py -n 10000 --order 1.5

-nは「各eta・各実装・各試行」の呼び出し回数です。
以前の6実装比較プログラムの総呼び出し回数指定とは異なります。
指定された各etaを個別に測定し、中央値、1回あたりの時間、速度倍率を表示。
実行順を試行ごとに交替します。import、ウォームアップ、精度確認、CSV出力は計測外。
実際のPythonラッパー、ctypes、LowLevelCallable準備、quad呼び出しは時間に含みます。
繰り返すのは同じetaですが、キャッシュは無効なので毎回計算します。
全体倍率は「etaごとの中央値の合計」の比です。

出力:
 tkfermi_comparison_summary.csv: etaごとの時間、倍率、両実装の計算値と相対差
 tkfermi_comparison_trials.csv: 各試行の時間
--output results/run1 で出力先・接頭辞を変更できます。
relative_differenceはabs(C-Python)/abs(Python)。真値に対する誤差ではありません。
元の近似式と制約を継承しており、近似精度そのものは改善しません。

同梱のexample_*.csvはLinux x86_64 / GCC -O3 / Python 3.12での実測例。
-n 200 --repeat 3、r=0.5。速度はOS・CPU・コンパイラで変わります。
Windows/macOSでのコンパイルと実行は未検証です。
配布物には環境依存バイナリを含めず、利用する環境でビルドしてください。

ファイル:
 tkfermi_core.c      C化した3つの関数
 tkfermi_c.py        ctypes / LowLevelCallable ラッパー
 tkfermi_python.py   元のPython実装（未変更）
 build.py            OSに応じたビルド
 verify.py           元実装との一致確認
 benchmark.py        時間比較
