huckel1d.py ダウンロード/コピー
huckel1d.py
huckel1d.py
1"""
2概要:
3 1D分子のHuckelモデルを計算し、分子軌道エネルギーと係数を求めるスクリプトです。
4
5詳細説明:
6 サイトエネルギーと移動積分からHamiltonianを作成し、固有値問題を解いて
7 各分子軌道のエネルギーと係数を算出します。計算結果はCSVとして保存され、
8 グラフとして可視化されます。
9
10関連リンク:
11 huckel1d_usage
12"""
13import numpy as np
14import matplotlib.pyplot as plt
15import pandas as pd
16
17# ============================
18# パラメータ設定
19# ============================
20
21def initialize():
22 """
23 概要:
24 1D分子のHuckelモデルのパラメータを初期化します。
25
26 詳細説明:
27 オンサイトエネルギーのリスト onsite と、最隣接サイト間の移動積分のリスト hopping を設定します。
28 s軌道同士の場合、移動積分は負になることに注意してください。
29
30 戻り値:
31 :returns: onsiteとhoppingを含むパラメータ辞書
32 :rtype: dict
33 """
34 params = {}
35
36 # 例:4 原子直鎖分子。s軌道同士の場合、移送積分は負であることに注意
37 params["onsite"] = [ 0.0, 0.1, 0.2, 0.1]
38 params["hopping"] = [-1.0, -1.1, -0.9] # 原子 i–(i+1)
39
40 return params
41
42
43# ============================
44# Hamiltonian(有限鎖)
45# ============================
46
47def hamiltonian_molecule(onsite, hopping):
48 """
49 概要:
50 1D分子のHuckel Hamiltonianを作成します。
51
52 詳細説明:
53 周期境界条件なしの有限鎖モデルとして、オンサイトエネルギーと
54 最隣接サイト間の移動積分を用いて行列を構築します。
55
56 引数:
57 :param onsite: オンサイトエネルギーのリスト
58 :type onsite: list
59 :param hopping: 最隣接サイト間の移動積分のリスト
60 :type hopping: list
61
62 戻り値:
63 :returns: Huckel Hamiltonian行列
64 :rtype: numpy.ndarray
65 """
66 norb = len(onsite)
67 H = np.zeros((norb, norb))
68
69 # onsite
70 for i in range(norb):
71 H[i, i] = onsite[i]
72
73 # nearest-neighbor hopping
74 for i in range(norb - 1):
75 H[i, i + 1] = hopping[i]
76 H[i + 1, i] = hopping[i]
77
78 return H
79
80
81# ============================
82# 計算
83# ============================
84
85def solve_molecule(onsite, hopping):
86 """
87 概要:
88 Hamiltonianの固有値と固有ベクトルを計算します。
89
90 引数:
91 :param onsite: オンサイトエネルギーのリスト
92 :type onsite: list
93 :param hopping: 最隣接サイト間の移動積分のリスト
94 :type hopping: list
95
96 戻り値:
97 :returns: 固有値の配列と固有ベクトルの配列のタプル
98 :rtype: tuple
99 """
100 H = hamiltonian_molecule(onsite, hopping)
101 eigvals, eigvecs = np.linalg.eigh(H)
102 return eigvals, eigvecs
103
104
105# ============================
106# 出力
107# ============================
108
109def save_results(filename, eigvals, eigvecs):
110 """
111 概要:
112 固有値と固有ベクトルの計算結果をCSVファイルに出力します。
113
114 引数:
115 :param filename: 出力するCSVファイル名
116 :type filename: str
117 :param eigvals: 固有値の配列
118 :type eigvals: numpy.ndarray
119 :param eigvecs: 固有ベクトルの配列
120 :type eigvecs: numpy.ndarray
121 """
122 df = pd.DataFrame(eigvecs, columns=[f"MO_{i}" for i in range(len(eigvals))])
123 df.insert(0, "Energy", eigvals)
124 df.to_csv(filename, index=False)
125
126def plot_molecular_orbitals_vstack(eigvecs, eigvals=None):
127 """
128 概要:
129 計算された分子軌道を縦に積んでグラフとして表示します。
130
131 詳細説明:
132 x軸を共有し、枠を密着させた状態で各分子軌道の係数をプロットします。
133
134 引数:
135 :param eigvecs: 固有ベクトルの配列
136 :type eigvecs: numpy.ndarray
137 :param eigvals: 固有値の配列、またはNone
138 :type eigvals: numpy.ndarray, optional
139 """
140 norb = eigvecs.shape[0]
141 x = np.arange(norb)
142
143 n_mo = eigvecs.shape[1]
144
145 fig, axes = plt.subplots(
146 n_mo, 1,
147 figsize=(6, 1.2 * n_mo),
148 sharex=True,
149 gridspec_kw={"hspace": 0}
150 )
151
152 # MO が 1 本のときの保険
153 if n_mo == 1:
154 axes = [axes]
155
156 # グラフの表示スケールを合わせるため、係数の最大値を取得
157 ymax = np.max(np.abs(eigvecs))
158
159 for i, ax in enumerate(axes):
160 i_mo = n_mo - 1 - i
161
162 if eigvals is not None:
163 label = f"MO #{i_mo} E={eigvals[i_mo]:.2f}"
164 else:
165 label = f"MO #{i_mo}"
166 ax.plot(x, eigvecs[:, i_mo], marker="o", label = label)
167 ax.axhline(0, color="gray", lw=0.5)
168
169 # y ラベル(エネルギーがあれば併記)
170 ax.set_ylabel(f"$c_i$")
171
172 # 下以外は x 軸ラベル・目盛り文字を消す
173 if i != n_mo - 1:
174 ax.tick_params(labelbottom=False)
175
176 ax.set_ylim(-ymax, ymax)
177 ax.legend()
178
179 axes[-1].set_xlabel("Atom index")
180
181 plt.tight_layout()
182 plt.show()
183
184# ============================
185# main
186# ============================
187
188def main():
189 """
190 概要:
191 1D分子のHuckelモデル計算を実行するメイン関数です。
192
193 詳細説明:
194 パラメータの初期化、固有値計算、結果のコンソール出力、CSV保存、グラフ描画を順に行います。
195 """
196 params = initialize()
197 onsite = params["onsite"]
198 hopping = params["hopping"]
199
200 eigvals, eigvecs = solve_molecule(onsite, hopping)
201
202 print("固有値(分子軌道エネルギー):")
203 for i, e in enumerate(eigvals):
204 print(f"MO {i}: {e:.4f}")
205
206 save_results("huckel_1d_molecule.csv", eigvals, eigvecs)
207 print("huckel_1d_molecule.csv を出力しました")
208
209 plot_molecular_orbitals_vstack(eigvecs, eigvals)
210
211
212# ============================
213# entry point
214# ============================
215
216if __name__ == "__main__":
217 main()