pw3d.py 概要
pw3d.py は、3次元周期境界条件下の箱型ポテンシャル(box well)におけるシュレディンガー方程式を、平面波基底を用いて高密度対角化により解くプログラムです。
CPU(numpy)およびGPU(cupy)をバックエンドとして選択可能であり、計算時間のプロファイリングやバンド構造(エネルギー固有値)の可視化を行います。
物理モデルと計算手法
本プログラムでは、周期的ポテンシャル中の電子の振る舞いを記述する3次元シュレディンガー方程式の固有値問題を解きます。 状態ベクトルを平面波基底 \( | \mathbf{G} \rangle \) で展開することにより、ハミルトニアン行列の対角化問題に帰着させます。
ハミルトニアンと基底
ハミルトニアンの行列要素は、運動エネルギー項とポテンシャルエネルギー項の和として与えられます。
ここで、\( \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}) \) は、以下の数式で計算されます。
ここで、\( \mathbf{q} = \mathbf{G} - \mathbf{G}' \) であり、\( a \) は格子定数です。 また、計算に用いられる関数 \( \mathrm{sinc}(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