Name | qcparse JSON |
Version |
0.6.4
JSON |
| download |
home_page | https://github.com/coltonbh/qcparse |
Summary | A package for parsing Quantum Chemistry program file outputs into structured qcio data objects. |
upload_time | 2024-10-02 00:45:26 |
maintainer | None |
docs_url | None |
author | Colton Hicks |
requires_python | <4.0,>=3.8 |
license | MIT |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# qcparse
A library for parsing Quantum Chemistry output files into structured data objects and converting structured input objects into program-native input files. Uses data structures from [qcio](https://github.com/coltonbh/qcio).
[![image](https://img.shields.io/pypi/v/qcparse.svg)](https://pypi.python.org/pypi/qcparse)
[![image](https://img.shields.io/pypi/l/qcparse.svg)](https://pypi.python.org/pypi/qcparse)
[![image](https://img.shields.io/pypi/pyversions/qcparse.svg)](https://pypi.python.org/pypi/qcparse)
[![Actions status](https://github.com/coltonbh/qcparse/workflows/Tests/badge.svg)](https://github.com/coltonbh/qcparse/actions)
[![Actions status](https://github.com/coltonbh/qcparse/workflows/Basic%20Code%20Quality/badge.svg)](https://github.com/coltonbh/qcparse/actions)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)
`qcparse` works in harmony with a suite of other quantum chemistry tools for fast, structured, and interoperable quantum chemistry.
## The QC Suite of Programs
- [qcio](https://github.com/coltonbh/qcio) - Beautiful and user friendly data structures for quantum chemistry.
- [qcparse](https://github.com/coltonbh/qcparse) - A library for efficient parsing of quantum chemistry data into structured `qcio` objects and conversion of `qcio` input objects to program-native input files.
- [qcop](https://github.com/coltonbh/qcop) - A package for operating quantum chemistry programs using `qcio` standardized data structures. Compatible with `TeraChem`, `psi4`, `QChem`, `NWChem`, `ORCA`, `Molpro`, `geomeTRIC` and many more.
- [BigChem](https://github.com/mtzgroup/bigchem) - A distributed application for running quantum chemistry calculations at scale across clusters of computers or the cloud. Bring multi-node scaling to your favorite quantum chemistry program.
- `ChemCloud` - A [web application](https://github.com/mtzgroup/chemcloud-server) and associated [Python client](https://github.com/mtzgroup/chemcloud-client) for exposing a BigChem cluster securely over the internet.
## ✨ Basic Usage
- Installation:
```sh
python -m pip install qcparse
```
- Parse a file into a `SinglePointResults` object with a single line of code.
```python
from qcparse import parse
# May pass a path or the contents of a file as string/bytes
results = parse("terachem", "/path/to/stdout.log")
```
- The `results` object will be a `qcio.SinglePointResults` object. Run `dir(results)` inside a Python interpreter to see the various values you can access. A few prominent values are shown here as an example:
```python
from qcparse import parse
results = parse("/path/to/tc.out", "terachem")
results.energy
results.gradient # If a gradient calc
results.hessian # If a hessian calc
results.calcinfo_nmo # Number of molecular orbitals
```
- Parsed values can be written to disk like this:
```py
with open("results.json", "w") as f:
f.write(result.model_dumps_json())
```
- And read from disk like this:
```py
from qcio import SinglePointResults
results = SinglePointResults.open("results.json")
```
- You can also run `qcparse` from the command line like this:
```sh
qcparse -h # Get help message for cli
qcparse terachem ./path/to/tc.out > results.json # Parse TeraChem stdout to json
```
## 💻 Contributing
Please see the [contributing guide](./CONTRIBUTING.md) for details on how to contribute new parsers to this project :)
If there's data you'd like parsed from output files or want to support input files for a new program, please open an issue in this repo explaining the data items you'd like parsed and include an example output file containing the data, like [this](https://github.com/coltonbh/qcparse/issues/2).
Raw data
{
"_id": null,
"home_page": "https://github.com/coltonbh/qcparse",
"name": "qcparse",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Colton Hicks",
"author_email": "github@coltonhicks.com",
"download_url": "https://files.pythonhosted.org/packages/0b/9f/0f4f2767121c0351ead014aae4699a13fd430514caa5360ed2a3a55d3b12/qcparse-0.6.4.tar.gz",
"platform": null,
"description": "# qcparse\n\nA library for parsing Quantum Chemistry output files into structured data objects and converting structured input objects into program-native input files. Uses data structures from [qcio](https://github.com/coltonbh/qcio).\n\n[![image](https://img.shields.io/pypi/v/qcparse.svg)](https://pypi.python.org/pypi/qcparse)\n[![image](https://img.shields.io/pypi/l/qcparse.svg)](https://pypi.python.org/pypi/qcparse)\n[![image](https://img.shields.io/pypi/pyversions/qcparse.svg)](https://pypi.python.org/pypi/qcparse)\n[![Actions status](https://github.com/coltonbh/qcparse/workflows/Tests/badge.svg)](https://github.com/coltonbh/qcparse/actions)\n[![Actions status](https://github.com/coltonbh/qcparse/workflows/Basic%20Code%20Quality/badge.svg)](https://github.com/coltonbh/qcparse/actions)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)\n\n`qcparse` works in harmony with a suite of other quantum chemistry tools for fast, structured, and interoperable quantum chemistry.\n\n## The QC Suite of Programs\n\n- [qcio](https://github.com/coltonbh/qcio) - Beautiful and user friendly data structures for quantum chemistry.\n- [qcparse](https://github.com/coltonbh/qcparse) - A library for efficient parsing of quantum chemistry data into structured `qcio` objects and conversion of `qcio` input objects to program-native input files.\n- [qcop](https://github.com/coltonbh/qcop) - A package for operating quantum chemistry programs using `qcio` standardized data structures. Compatible with `TeraChem`, `psi4`, `QChem`, `NWChem`, `ORCA`, `Molpro`, `geomeTRIC` and many more.\n- [BigChem](https://github.com/mtzgroup/bigchem) - A distributed application for running quantum chemistry calculations at scale across clusters of computers or the cloud. Bring multi-node scaling to your favorite quantum chemistry program.\n- `ChemCloud` - A [web application](https://github.com/mtzgroup/chemcloud-server) and associated [Python client](https://github.com/mtzgroup/chemcloud-client) for exposing a BigChem cluster securely over the internet.\n\n## \u2728 Basic Usage\n\n- Installation:\n\n ```sh\n python -m pip install qcparse\n ```\n\n- Parse a file into a `SinglePointResults` object with a single line of code.\n\n ```python\n from qcparse import parse\n # May pass a path or the contents of a file as string/bytes\n results = parse(\"terachem\", \"/path/to/stdout.log\")\n ```\n\n- The `results` object will be a `qcio.SinglePointResults` object. Run `dir(results)` inside a Python interpreter to see the various values you can access. A few prominent values are shown here as an example:\n\n ```python\n from qcparse import parse\n\n results = parse(\"/path/to/tc.out\", \"terachem\")\n\n results.energy\n results.gradient # If a gradient calc\n results.hessian # If a hessian calc\n\n results.calcinfo_nmo # Number of molecular orbitals\n ```\n\n- Parsed values can be written to disk like this:\n\n ```py\n with open(\"results.json\", \"w\") as f:\n f.write(result.model_dumps_json())\n ```\n\n- And read from disk like this:\n\n ```py\n from qcio import SinglePointResults\n\n results = SinglePointResults.open(\"results.json\")\n ```\n\n- You can also run `qcparse` from the command line like this:\n\n ```sh\n qcparse -h # Get help message for cli\n\n qcparse terachem ./path/to/tc.out > results.json # Parse TeraChem stdout to json\n ```\n\n## \ud83d\udcbb Contributing\n\nPlease see the [contributing guide](./CONTRIBUTING.md) for details on how to contribute new parsers to this project :)\n\nIf there's data you'd like parsed from output files or want to support input files for a new program, please open an issue in this repo explaining the data items you'd like parsed and include an example output file containing the data, like [this](https://github.com/coltonbh/qcparse/issues/2).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A package for parsing Quantum Chemistry program file outputs into structured qcio data objects.",
"version": "0.6.4",
"project_urls": {
"Homepage": "https://github.com/coltonbh/qcparse",
"Repository": "https://github.com/coltonbh/qcparse"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ea6d946a980abb94f4667c8c3b714541c56540f839bf2cf8a8bfc8bf317228d",
"md5": "644243259e511db146efa3d77815fe8a",
"sha256": "0904a8970e1ef2714f4d976f0af1b4a3402fca756d1003a181c67ae188daa164"
},
"downloads": -1,
"filename": "qcparse-0.6.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "644243259e511db146efa3d77815fe8a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 17863,
"upload_time": "2024-10-02T00:45:25",
"upload_time_iso_8601": "2024-10-02T00:45:25.588600Z",
"url": "https://files.pythonhosted.org/packages/3e/a6/d946a980abb94f4667c8c3b714541c56540f839bf2cf8a8bfc8bf317228d/qcparse-0.6.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0b9f0f4f2767121c0351ead014aae4699a13fd430514caa5360ed2a3a55d3b12",
"md5": "23cb4ff1d9c8d3f7252d9413ffec6ffe",
"sha256": "3db21e5b8dc3b46786ef1765e546958f43c9378cfd5127ee9bfcd473fceb2907"
},
"downloads": -1,
"filename": "qcparse-0.6.4.tar.gz",
"has_sig": false,
"md5_digest": "23cb4ff1d9c8d3f7252d9413ffec6ffe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 14672,
"upload_time": "2024-10-02T00:45:26",
"upload_time_iso_8601": "2024-10-02T00:45:26.978833Z",
"url": "https://files.pythonhosted.org/packages/0b/9f/0f4f2767121c0351ead014aae4699a13fd430514caa5360ed2a3a55d3b12/qcparse-0.6.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 00:45:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coltonbh",
"github_project": "qcparse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "qcparse"
}