Metadata-Version: 2.1
Name: pwfn
Version: 0.1.0
Summary: pwfn is a single-page library to parse .wfn file
Home-page: https://github.com/clavigne/pwfn
Author: Cyrille Lavigne
Author-email: cyrille.lavigne@mail.utoronto.ca
License: MIT
Keywords: chemistry wfn aimpac qtaim electronic orbitals
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Typing :: Typed
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# pwfn

**pwfn** is a tiny library for parsing [AIMPAC
format](https://github.com/ecbrown/aimpac/) `.wfn` files from quantum
chemistry programs and [Molden2Aim](https://github.com/zorkzou/Molden2AIM/)
into a Python data structure. This can be used to do ML on electronic
wavefunctions. 

This library does not do anything besides parsing! It is basically a single
page [pyparsing](https://github.com/pyparsing/pyparsing/) grammar. You'll need
to do your own data processing from its outputs.


## Usage

**pwfn** consists of a single string parser `pwfn.loads(s)`,

```python
import pwfn

with open("benzene.wfn", "r") as f:
    wavefunction = pwfn.loads(f.read())
```

This returns a `Wavefunction` container with the extracted data in its
attributes. All quantities are in Hartree units (unchanged from the `.wfn`
format).


## Installation

**pwfn** is available from pip,

```shell
pip install pwfn
```

It depends on the excellent
[pyparsing](https://github.com/pyparsing/pyparsing/) library as well as
[numpy](https://numpy.org/).

## Notes

If you want a similarly minimalist library to parse formatted checkpoint
files, consider my other library [fchic](https://github.com/clavigne/fchic).
If you are looking for a full feature solution for wavefunction data analysis,
consider using the excellent [Multiwfn program](http://sobereva.com/multiwfn/)
or [orbkit](https://github.com/orbkit/orbkit).


## License

**pwfn** is free software provided under the MIT license.




