MoleditPy PySCF Calculator Plugin Tutorial

目的

MoleditPyおよびPySCF Calculatorプラグインを使用するための環境構築を行います。PySCFはWindowsネイティブ環境では動作が不安定な場合があるため、Windows・Mac・Linuxそれぞれの環境に合わせたセットアップ方法を解説します。

1. Mac / Linux の場合

MacおよびLinuxユーザーは、標準のPython環境（ターミナル）から直接インストールできます。

Step 1: MoleditPy本体のインストール

1. ターミナルを開き、以下のコマンドを実行してインストーラーを導入します。

   pip install moleditpy-installer

   ※ 最近のLinuxディトリビューション（Ubuntu 24.04など）でエラーが出る場合は --break-system-packages フラグを追加してください。

   (代替案) 仮想環境を使用する場合

   システムパッケージを変更したくない場合は、仮想環境を作成してください：

   python3 -m venv myenvsource myenv/bin/activatepip install moleditpy-installer

   ※ インストールログを確認してください。「WARNING: The script moleditpy-installer is installed in ... which is not on PATH」のような警告が表示された場合、そのフルパスを使用してください。

2. コマンドが実行できるようにPATHを通します（推奨）：

   echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrcsource ~/.bashrc

   ※ これにより `moleditpy` や `moleditpy-installer` コマンドを直接実行できるようになります。デフォルトでは ~/.local/bin にインストールされることが多いためです。

3. ショートカット作成コマンドを実行します。

   moleditpy-installer

   ※ コマンドが見つからない場合（かつPATHも通していない場合）は、pip install のログを確認し、警告に出ているパス（例: ~/.local/bin/moleditpy-installer）を使用してください。

4. 以下のコマンドでアプリが起動することを確認します（初回起動は時間がかかります）。

   moleditpy

Step 2: PySCF Calculatorプラグインの導入

1. 必要なライブラリをインストールします。

   pip install pyscf geometric matplotlib

   ※ 最近のLinux等でエラーが出る場合は --break-system-packages を追加してください。

2. Plugin Explorer からプラグインをダウンロードします。
3. ダウンロードしたファイルを解凍し、中にある pyscf_calculator フォルダをプラグインディレクトリに配置します。
   • Mac/Linux: ~/.moleditpy/plugins/
4. MoleditPyを再起動し、メニューの Extensions > PySCF Calculator が表示されれば完了です。

2. Windows (WSL) の場合

Windowsでは、PySCFが正常に動作しないことが多いため、Windows Subsystem for Linux (WSL) を使用してLinux版として実行することを強く推奨します。（※ GUI機能 (WSLg) を使用するには Windows 11 または 最新の Windows 10 が必要です）

Step 1: WSLのセットアップ

1. PowerShellを「管理者として実行」し、以下のコマンドでWSL（Ubuntu）をインストールします。

   wsl --install

   ※インストール完了後、PCの再起動が必要になる場合があります。再起動後、ユーザー名とパスワードを設定してください。

2. Ubuntuのターミナルを開き、パッケージリストを更新します。

   sudo apt update

3. GUIアプリ（PyQt6）の実行に必要なライブラリをインストールします。

   sudo apt install python3-pip \libgl1 libegl1 libxkbcommon-x11-0 libdbus-1-3 \libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 \libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xinerama0

4. Qtプラットフォーム環境変数を設定します（推奨設定）:

   echo 'export QT_QPA_PLATFORM=xcb' >> ~/.bashrcsource ~/.bashrc

Step 2: MoleditPy とプラグインのインストール

WSLのターミナル内で、Linuxと同様の手順を実行します。

1. MoleditPyのインストール:

   pip install moleditpy-installer --break-system-packages

   ※ Ubuntu 24.04などでは --break-system-packages が必要です。

   (代替案) 仮想環境を使用する場合

   システムパッケージを変更したくない場合は、仮想環境を作成してください：

   python3 -m venv myenvsource myenv/bin/activatepip install moleditpy-installer

2. PySCFと依存ライブラリのインストール:

   pip install pyscf geometric matplotlib --break-system-packages

   ※ 仮想環境を使用している場合は --break-system-packages は不要です。

3. プラグインの配置:
   • Plugin Explorer からプラグインをダウンロードし、解凍しておきます。
   • WindowsのエクスプローラーからWSL内のプラグインフォルダにアクセスし、pyscf_calculator フォルダをコピーします。

     アドレスバーに \\wsl$\Ubuntu\home\YourName\.moleditpy\plugins\ 等を入力するか、ナビゲーションウィンドウの「Linux」からアクセスできます。

     （事前にフォルダを作成しておく必要があります）

     mkdir -p ~/.moleditpy/plugins

4. 起動確認:

   moleditpy

   WSLからLinuxのGUIアプリとしてMoleditPyが起動します。