# VASP_ThermalProperties.pl Documentation

## 1. プログラムの動作

`VASP_ThermalProperties.pl`は、VASP（Vienna Ab initio Simulation Package）によって生成された出力ファイルを解析し、電子の熱的性質を計算するPerlスクリプトです。このプログラムは、以下の手順で動作します：

- 指定されたディレクトリからVASPの出力ファイル（`INCAR`, `POSCAR`, `POTCAR`, `OUTCAR`, `EIGENVAL`）を読み込みます。
- 結晶構造の情報を取得し、格子定数や体積を計算します。
- `OUTCAR`ファイルから電子数（`NELECT`）とフェルミエネルギー（`EF`）を取得します。
- `EIGENVAL`ファイルを解析して、エネルギーに対する状態密度（DOS）を計算します。
- 温度範囲にわたって、フェルミエネルギー、内部エネルギー、エントロピー、自由エネルギーの変化を計算し、結果をCSVファイルに出力します。

## 2. 必要な非標準ライブラリとインストールコマンドとインストール方法

このスクリプトは、以下の非標準Perlモジュールを使用しています：

- `Deps`
- `Utils`
- `JFile`
- `CSV`
- `Sci`
- `Sci::Algorism`
- `Crystal::VASP`

これらのモジュールはCPAN（Comprehensive Perl Archive Network）には存在しない可能性があるため、独自に開発されたモジュールである可能性があります。これらのモジュールは、スクリプトと同じディレクトリに配置するか、`lib`ディレクトリに配置して使用する必要があります。

## 3. 必要な入力ファイル

このスクリプトは、以下のVASP出力ファイルを必要とします：

- `INCAR`: VASPの入力設定ファイル
- `POSCAR`: 結晶構造情報を含むファイル
- `POTCAR`: ポテンシャル情報を含むファイル
- `OUTCAR`: 計算結果の詳細を含むファイル
- `EIGENVAL`: エネルギー固有値を含むファイル

これらのファイルは、指定されたディレクトリ（デフォルトはカレントディレクトリ）に存在する必要があります。

## 4. 実行後に生成される出力ファイル

スクリプトの実行後、以下のCSVファイルが生成されます：

- `ExactDOS.csv`: エネルギーに対する状態密度（DOS）と電子数（Ne）の情報を含むファイル
- `ThermalProperties.csv`: 温度に対するフェルミエネルギー、内部エネルギー、エントロピー、自由エネルギーの変化を含むファイル

## 5. コマンドラインでの使用例 (Usage)

以下は、このスクリプトのコマンドラインでの使用例です：

```bash
perl VASP_ThermalProperties.pl [directory]
```

- `[directory]`: VASPの出力ファイルが格納されているディレクトリを指定します。指定しない場合、デフォルトでカレントディレクトリが使用されます。