https://github.com/sinagilassi/gaussnbo
A Python package for parsing Natural Bond Orbital (NBO) data from Gaussian log files.
https://github.com/sinagilassi/gaussnbo
Last synced: 7 months ago
JSON representation
A Python package for parsing Natural Bond Orbital (NBO) data from Gaussian log files.
- Host: GitHub
- URL: https://github.com/sinagilassi/gaussnbo
- Owner: sinagilassi
- License: mit
- Created: 2025-03-21T16:22:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T21:23:19.000Z (about 1 year ago)
- Last Synced: 2025-06-26T00:04:05.913Z (11 months ago)
- Language: Python
- Size: 3.47 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GaussNBO ⚛️
[](https://pepy.tech/projects/gaussnbo)
A Python package for parsing Natural Bond Orbital (NBO) data from Gaussian log files.
## What is NBO? 🤔
`Natural Bond Orbital` (NBO) analysis is a widely used computational chemistry method that offers detailed insights into molecular bonding and interactions. It converts the delocalized molecular orbitals (MOs) from quantum chemical calculations into localized orbitals that are more closely aligned with the Lewis structure representation of molecules. NBO analysis aids chemists in understanding:
- Chemical bonding and hybridization: It identifies the nature of chemical bonds and the hybridization of atoms.
- Charge distribution and polarization: NBO analysis provides information on the distribution of electronic charge within the molecule and the polarization of bonds.
- Donor-acceptor interactions: It helps in analyzing interactions such as electron donation from lone pairs or bonds and electron acceptance into empty orbitals.
- Resonance and hyperconjugation effects: NBO can describe resonance structures and the effects of hyperconjugation, both of which influence molecular stability and reactivity.
- Reaction mechanisms and transition states: It contributes to the understanding of reaction pathways, including insights into the electronic structure of transition states.
## About GaussNBO 📊
GaussNBO is a Python package designed to parse NBO data from Gaussian log files. It provides an easy-to-use interface for extracting and analyzing NBO results, including:
- Natural Bond Orbitals (NBOs)
- Natural Atomic Orbitals (NAOs)
- Natural Localized Molecular Orbitals (NLMOs)
- Second-order perturbation theory analysis
- and more...
## Features 🎉
- Parse NBO data from Gaussian log files
- Extract NBO results, including NBOs, NAOs, NLMOs, and second-order perturbation theory analysis
- Easy-to-use interface for analyzing NBO data
- Compatible with `Gaussian NBO Version 3.1`
- Visualization of NBO analysis results in browser
## Web Application 🌐
For a quick analysis without installing the package, you can use our online web application:
[https://gaussnbo.up.railway.app/](https://gaussnbo.up.railway.app/)
This web interface allows you to:
- Upload your Gaussian NBO log files
- Analyze NBO data directly in your browser
- Visualize results without any local installation
## Installation 📦
To install GaussNBO, run the following command:
```bash
pip install GaussNBO
```
## Usage 📝
Here's an example of how to use GaussNBO:
```python
import GaussNBO as gnbo
# Process a Gaussian log file and view results in browser
nbo_data = gnbo.launch('path/to/file.log', view_browser=True)
# Or just get the parsed data without opening browser
nbo_data = gnbo.launch('path/to/file.log', view_browser=False)
```
## Contributing 🤝
Contributions to GaussNBO are welcome! Please fork the repository, make your changes, and submit a pull request.
## ❓ FAQ
For any question, contact me on [LinkedIn](https://www.linkedin.com/in/sina-gilassi/)
## 👥 Authors
- [@sinagilassi](https://www.github.com/sinagilassi)