VASPをパワーアップして快適なVASPライフを送りたい ~Anaconda,vise~

# 0. まえがき

VASPで計算させるまでの準備や、計算結果を分析したりグラフを作成したりなどの作業が、一つのパッケージの中で行えたらどれだけ楽なことか、、、と物思いにふけっていた頃、**vise**というpythonで提供されているパッケージがあることを知りました。これは使うしかないということで、それの導入方法や活用法を、記録として載せておこうと思います。

# 目次
[1. Anacondaの導入](#1-anacondaの導入)
[2. viseのインストール](#2-viseのインストール)
[3. viseを使ってみる](#3-viseを使ってみる)
[4. ハンズオン（Bi2Se3）](#4-ハンズオンbi2se3)
[5. あとがき](#5-あとがき)

# 1. Anacondaの導入

まず、**vise**を入れる前に、pythonの環境のセットアップをします。仕方は人によって違うと思いますが、ここでは**コマンドラインからAnacondaを導入する手順**について書いておきます。（筆者側の環境の都合で）

こちらの記事に全て書いてありますが、この記事内でも同様の説明を書いておきます。

https://qiita.com/Macho000/items/c7821fabebe95df6a211 

## 1-1. インストーラのダウンロード

以下のリンク先に飛んで、使用しているOSに合ったインストーラのリンクのコピーをしてください。

https://www.anaconda.com/download/success

![スクリーンショット 2024-04-27 13.57.57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3687984/8076a479-73d6-0bc0-3f8e-a0e9d2fbd2e5.png)

Anacondaの環境を構築したいディレクトリに移動し、先ほどコピーしたリンクを使ってインストーラのダウンロードをします。

```bash:command line
curl -O <link>
# <link>の部分をコピーしたリンクで置き換えて実行してください。
# 例 curl -O https://repo.anaconda.com/archive/Anaconda3-2024.02-1-Linux-x86_64.sh
```

すると、実行したディレクトリ内に、　`.sh`という拡張子のついたファイルがダウンロードされているはずです。それがAnacondaを導入するためのインストーラになり、実行することでAnaconda環境がセットアップされます。

## 1-2. Anacondaのセットアップ

次にインストーラを実行しましょう。

```bash:command line
bash <installer>
# <installer>の部分をインストーラの名前に変えてください
# 例 bash Anaconda3-2021.05-Linux-x86_64.sh
```

入力待ちの状態になったら、特別カスタマイズしたいことがない限りは、`Enterキー`か`yesと入力`指定していけば問題ないと思います。インストールが完了したら、正常に環境構築ができたかどうかをチェックしましょう。

```bash:command line
python --version
# python 3.11.7 的なバージョンに関する出力があればOKです。
```

これでAnacondaの環境を作成することができました。

# 2. viseのインストール

ようやくここから**vise**をインストールしていきます。まず、必要なパッケージをインストールしていきます。（もしかしたら、viseをインストールしてしまえばセットでついてくるかも？）

```bash:command line
pip install pymatgen spglib seekpath mp-api phonopy
```

実行し、正常にインストールができたら**vise**をインストールします

```bash:command line
pip install vise
```

viseが正常にインストールできているかをチェックします。最終行にバージョンに関する情報が書いてあるはずです。

```bash:command line
vise -h
# 最終行に Author: Yu Kumagai Version: 0.9.0
```

# 3. viseを使ってみる

ここからは実際にviseを使ってできることについて紹介します。詳しくは**viseのドキュメントを参照してください**

https://kumagai-group.github.io/vise/

## 3-1. Materials Projectと連携

まずは、Materials Projectのアカウントと同期させます。

1. 右上の「API」タブをクリックし、以下の画像のような画面を開く
2. 画面左の「API Key」タブをクリックし、アカウント固有のAPIキーを表示させる。（30桁ぐらいの文字列が表示されるはずです）
3. APIキーをコピーしておく。

![スクリーンショット 2024-04-27 14.26.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3687984/7a112b7b-0376-c94a-dec7-8d6dfb8a0a53.png)

```bash:command line
pmg config --add PMG_MAPI_KEY <MPのAPIキー>
# <MPのAPIキー> の部分にコピーしたAPIキーを貼り付けてください
```

これをすることで、Materials Projectとの同期が完了し、以下のようなコマンドで直接POSCARをダウンロードすることができるようになったりします。

```bash:command line
vise gp -m <物質のキー>
# 例　vise gp -m mp-2857
```

## 3-2. 計算用ファイルのセット

```bash
vise vs
```

## 3-3. バンド図のプロット

計算結果を元にバンド図を作成したい場合、コマンド１つ叩くだけでバンド図のpdfを作成することができます。計算したファイルのディレクトリ内で以下のように実行してください。すると、名前はオプションで変えることができるのですが、何も指定しない場合は**band.pdf**という名前のファイルが出力されると思います。

```bash:command line
vise pb
vise pb -y -20 20    # y軸方向の幅を指定できる 
vise pb -f hoge      # 出力ファイルの名前を hoge.pdf にできる
```

# 4. ハンズオン（Bi2Se3）

![スクリーンショット 2024-05-02 16.19.51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3687984/3634db52-9a8f-7601-7e60-cdcd8754f927.png)

```bash
vise gp -m mp-541837
```

POSCARファイルができるはず

```bash
vise vs -t band
```

これでバンド図を作成する用のファイル群を生成することができたので、VASPを回して計算しましょう。
それが終わったら、バンド図を生成します。

```bash
vise pb
```

これで、`band.pdf`というファイルが生成されるはずです。ここにバンド図がプロットされています。


# 5. あとがき

便利すぎ！！以上！！