huckel1d.py ダウンロード/コピー

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()