Metadata-Version: 2.1
Name: crystalpol
Version: 0.1.0
Summary: Crystal Optimization Automation using Gaussian16
License: GPL-2.0-only
Author: Vitor Hideyoshi
Author-email: vitor.h.n.batista@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: setproctitle (>=1.3.2,<2.0.0)
Description-Content-Type: text/markdown

# CrystalPol

## Arquivo de Configuração - **config.yml**

No arquivo de Configuração temos as sequintes keywords:

```yaml
crystal_pol:
    mem: *obrigatorio*
    level: *obrigatorio*
    n_atoms: *obrigatorio*
    n_procs: 1
    pop: "chelpg"
    mult: [ 0, 1 ]
    charge_tolerance: 0.02
    simulation_dir: "simfiles"
    comment: "Crystal"
```

Estas keywords são utilizadas para controlar o comportamento do programa CrystalPol e de sua dependência Gaussian.

## Arquivo de input - **crystal.xyz**

O arquivo de input deve ter o formato

```
H   1.0000  1.0000  1.0000
```
Sendo que as primeiras **N** (valor derivado da keyword _**n_atoms**_) átomos devem ser da molécula da celula unitária a ser otimizada. 

Este arquivo pode ser obtido também retirando o header de um arquivo .gjf e o renomeando para .xyz

## Instalando dependência

```bash
python3 -m pip install setproctitle pyyaml nptyping numpy
```

## Como executar

```bash
python3 -m crystalpol -c {arquivo_de_config}.yml -i {arquivo_de_input}.xyz -o {arquivo_de_saida}.log
```
Caso as opções `-c`, `-i` e `-o` não seja dadas os seguintes valores padrões serão usados:

- arquivo_de_config: `config.yml`
- arquivo_de_input: `crystal.xyz`
- arquivo_de_saida: `run.log`


## Orientação para Citações

Por favor citar este software utilizando o seguinte biblatex:

```
@software{crystalpol,
  author = {{Georg, Herbert} and {Batista, Vitor}},
  title = {CrystalPol - Crystal Polarization Software},
  url = {https://github.com/HideyoshiNakazone/CrystalPol},
  version = {0.1},
}
```
