====== 概要 ======

  * CIFファイルから、QuantumESPRESSOを含む各種第一原理計算ソフトの入力ファイルのひな形を作ることができます。
  * インストールにはPython, pipが必要です。 
  * 公式サイト：https://pypi.org/project/cif2cell/

  * 検証環境：Ubuntu 26.04, cif2cell-2.1.0



====== インストール ======

===== 準備 =====

pipを用意します。

<code>
$ sudo apt update
$ sudo apt install python3-pip
</code>

===== 手順 =====

==== 方法1. 仮想環境の構築 ====

仮想環境を作って、そこにインストールする方法です。

<code>
$ sudo apt install python3-venv
$ python3 -m venv ~/venv_cif2cell
$ source ~/venv_cif2cell/bin/activate
(venv_cif2cell) $ pip install cif2cell
</code>

これで使えるようになります。
終了するには
<code>
(venv_cif2cell) $ deactivate
</code>
とします。


==== 方法2. システム全体にイントール ====

cif2cellは小さいプログラムなので、仮想環境を作らなくても特に問題は生じないと思います。
毎回、仮想環境をアクティベートするのが面倒だと感じる人は、以下のようにすればシステム全体にインストールできます。

<code>
$ sudo pip install cif2cell --break-system-packages
</code>


====== 使い方 ======

基本的な使い方は

  $ cif2cell -h

で確認することができます。
例えばmaterial.cifからPWscfの入力ファイルのひな形を作りたければ

  $ cif2cell -p pwscf -f material.cif -o material.scf.in

などとします。
また、以下のオプションで CELL_PARAMETERS（基本並進ベクトル）と ATOMIC_POSITIONS の種類を指定できます。

^オプション^CELL_PARAMETERS^ATOMIC_POSITIONS^
|なし|alat|crystal|
|<nowiki>--pwscf-atomic-units</nowiki>|alat|crystal|
|<nowiki>--pwscf-alat-units</nowiki>|alat|alat|
|<nowiki>--pwscf-cartesian</nowiki>|angstrom|angstrom|
|<nowiki>--pwscf-cartesian-latticevectors</nowiki>|angstrom|crystal|
|<nowiki>--pwscf-cartesian-positions</nowiki>|alat|angstrom|




====== 古い情報 ======

===== インストール（ver.1.2.10） =====

**（Python2が必要なので非推奨です）**

以下のサイトからダウンロード。

  * https://sourceforge.net/projects/cif2cell/

ホーム・ディレクトリにおいて展開し、展開先のディレクトリに入って次のコマンドを実行。

  $ sudo python setup.py install

インストールは一瞬で終わります。


===== 対応しているソフト =====

  * ABINIT
  * ASE
  * CASTEP
  * CP2K
  * CPMD
  * CRYSTAL09
  * Elk
  * EMTO
  * Exciting
  * Fleur
  * FHI-aims
  * Hutsepot
  * MOPAC
  * Quantum Espresso
  * RSPt
  * Siesta
  * SPR-KKR
  * VASP