pw3d.py 概要

pw3d.py は、3次元周期境界条件下の箱型ポテンシャル(box well)におけるシュレディンガー方程式を、平面波基底を用いて高密度対角化により解くプログラムです。 CPU(numpy)およびGPU(cupy)をバックエンドとして選択可能であり、計算時間のプロファイリングやバンド構造(エネルギー固有値)の可視化を行います。

物理モデルと計算手法

本プログラムでは、周期的ポテンシャル中の電子の振る舞いを記述する3次元シュレディンガー方程式の固有値問題を解きます。 状態ベクトルを平面波基底 \( | \mathbf{G} \rangle \) で展開することにより、ハミルトニアン行列の対角化問題に帰着させます。

ハミルトニアンと基底

ハミルトニアンの行列要素は、運動エネルギー項とポテンシャルエネルギー項の和として与えられます。

\[H_{\mathbf{G}, \mathbf{G}'}(\mathbf{k}) = \frac{\hbar^2}{2m_e} |\mathbf{k} + \mathbf{G}|^2 \delta_{\mathbf{G}, \mathbf{G}'} + V(\mathbf{G} - \mathbf{G}')\]

ここで、\( \mathbf{k} \) は波数ベクトル、\( \mathbf{G}, \mathbf{G}' \) は逆格子ベクトル、\( m_e \) は電子の質量です。 プログラム内では長さの単位に \( \mathrm{\AA} \)、エネルギーの単位に \( \mathrm{eV} \) を用いており、運動エネルギーの係数は適切な単位系に変換されています。

平面波基底は、各空間軸に対して奇数個(指定値 ng)の格子点を取り、3次元全体で \( \mathrm{ng}^3 \) 個の基底を構成します。

ポテンシャルエネルギー

ポテンシャル \( V(\mathbf{r}) \) は、単位胞の中心に配置された幅 \( w \)、深さ \( V_0 \) の立方体形状の井戸(box well)として定義されます(井戸の内部は \( -V_0 \)、外部は \( 0 \))。 このポテンシャルを波数空間にフーリエ変換した解析的な行列要素 \( V(\mathbf{q}) \) は、以下の数式で計算されます。

\[V(\mathbf{q}) = -V_0 \left(\frac{w}{a}\right)^3 \prod_{\alpha \in \{x,y,z\}} \mathrm{sinc}\left(q_\alpha \frac{w}{a}\right)\]

ここで、\( \mathbf{q} = \mathbf{G} - \mathbf{G}' \) であり、\( a \) は格子定数です。 また、計算に用いられる関数 \( \mathrm{sinc}(z) \) は以下のように定義されます。

\[\mathrm{sinc}(z) = \frac{\sin(\pi z)}{\pi z}\]

k点経路

バンド構造を計算するための波数 \( \mathbf{k} \) の経路は、逆格子空間のフラクショナル座標(\( 2\pi/a \) 単位)で以下の対称点を結ぶ線分として定義されています。

  • \( \Gamma \): \( (0, 0, 0) \)

  • \( X \): \( (0.5, 0, 0) \)

  • \( M \): \( (0.5, 0.5, 0) \)

  • \( \Gamma \): \( (0, 0, 0) \)

  • \( R \): \( (0.5, 0.5, 0.5) \)

必要なライブラリ

本プログラムの実行には、標準ライブラリのほかに以下のサードパーティ製ライブラリが必要です。

  • numpy: CPUでの配列計算と行列対角化

  • scipy: 物理定数(\( \hbar \), 電子質量, 電子ボルト)の取得

  • cupy: GPUバックエンド指定時の高速化(オプション)

  • matplotlib: バンド構造の可視化・グラフ作成(オプション)

入出力仕様

入力(コマンドライン引数)

コマンドライン引数によって、計算条件や物理パラメータを制御します。

  • --backend: 計算バックエンド(numpy, gpu, both)。デフォルトは numpy です。

  • --a: 立方格子の格子定数。単位は \( \mathrm{\AA} \) です。デフォルトは \( 5.4064 \) です。

  • --width: 箱型ポテンシャルの幅。単位は \( \mathrm{\AA} \) です。デフォルトは \( 2.0 \) です。

  • --depth: 井戸ポテンシャルの深さ。単位は \( \mathrm{eV} \) です。デフォルトは \( 10.0 \) です。

  • --ng: 各軸あたりの平面波の数(正の奇数)。全体の基底数はこの値の3乗になります。デフォルトは \( 5 \) です。

  • --nk: \( k \) パスの各線分ごとの分割点数(端点を含む)。デフォルトは \( 9 \) です。

  • --bands: 保存およびプロットするエネルギーバンドの数。デフォルトは \( 8 \) です。

  • --vectors: 固有値だけでなく固有ベクトルも計算する場合に指定します(ファイルには保存されません)。

  • --repeat: 計算の繰り返し回数。複数回実行して中央値を取得します。デフォルトは \( 1 \) です。

  • --no-plot: 結果のプロット画像を出力しない場合に指定します。

  • --output: 出力ファイルのベース名。デフォルトは pw3d です。

出力ファイル

指定したベース名(--output)に特定のサフィックスが付与されたファイルが生成されます。

  • <output>_timing.csv

    • 計算時間のプロファイリング結果を記録したCSVファイルです。

    • 主な列: backend, trial, k_index, build_seconds, eig_seconds, result_copy_seconds, total_seconds など。

  • <output>_bands.csv

    • 各 \( k \) 点でのエネルギー固有値を記録したCSVファイルです。

    • 主な列: backend, k_index, kx, ky, kz, distance, E0_eV, E1_eV など。

  • <output>_bands.png

    • バンド構造をプロットした画像ファイルです。横軸が \( k \) 空間上の距離、縦軸がエネルギー(\( \mathrm{eV} \))となります。

    • (--no-plot オプション指定時は生成されません)

実行例

CPUおよびGPUの両方を用いて、ポテンシャルの深さを \( 12.0 \, \mathrm{eV} \)、平面波の数を各軸 \( 7 \) (総基底数 \( 343 \))に変更して実行する例です。

python pw3d.py --backend both --depth 12.0 --ng 7 --nk 11 --bands 10 --output pw3d_result

グラフの描画を行わず、計算速度の測定(5回試行)のみをGPU環境で実行する例です。

python pw3d.py --backend gpu --repeat 5 --no-plot --output benchmark_gpu