# `get_poscar.py` プログラムのドキュメント

## 1. プログラムの動作
`get_poscar.py` は、指定された化学式に基づいて Materials Project データベースから結晶構造を取得し、指定されたフォーマットでファイルに保存するプログラムです。デフォルトでは、構造は "POSCAR" フォーマットで保存されますが、他のフォーマットも指定可能です。

## 2. 必要な非標準ライブラリとインストールコマンドとインストール方法
このプログラムは以下の非標準ライブラリを使用します：

- `mp-api`: Materials Project API クライアント
- `pymatgen`: 結晶構造の操作を行うためのライブラリ

これらのライブラリは、以下のコマンドでインストールできます：

```bash
pip install mp-api pymatgen
```

## 3. 必要な入力ファイル
このプログラムは特定の入力ファイルを必要としませんが、環境変数 `MP_APIKEY` に Materials Project API のキーを設定しておく必要があります。API キーは Materials Project のウェブサイトから取得できます。

## 4. 実行後に生成される出力ファイル
実行後、指定された化学式に対応する結晶構造が以下のようなファイル名で保存されます：

- デフォルトの "poscar" フォーマットの場合: `POSCAR`, `POSCAR_2`, `POSCAR_3`, ...
- 他のフォーマットを指定した場合: `<formula>.<format>`, `<formula>_2.<format>`, `<formula>_3.<format>`, ...

## 5. コマンドラインでの使用例 (Usage)
以下はコマンドラインでの使用例です：

```bash
python get_poscar.py Fe2O3
```

このコマンドは、化学式 `Fe2O3` に対応する構造を "POSCAR" フォーマットで保存します。

```bash
python get_poscar.py Fe2O3 cif
```

このコマンドは、化学式 `Fe2O3` に対応する構造を "cif" フォーマットで保存します。

プログラムを実行する前に、必ず `MP_APIKEY` 環境変数を設定してください。例えば、Linux や macOS の場合、以下のように設定できます：

```bash
export MP_APIKEY='your_api_key_here'
```