Skip to main content

Table of Contents

About

img

Tests Linting Docs PyPI Python License: MIT One Good Tutorial docs checklist v1: adopted Hatch project DOI

A pure-python1 parsing and plotting library for computational chemistry outputs. chemparseplot extracts structured data from quantum chemistry codes (ORCA, eOn, Sella, ChemGP) and produces publication-quality, unit-aware visualizations with scientific color maps.

Computational tasks (surface fitting, structure analysis, interpolation) are handled by rgpycrumbs, which is a required dependency. chemparseplot parses output files, delegates heavy computation to rgpycrumbs, and produces publication-quality plots.

Installation

pip install chemparseplot
# With plotting support
pip install "chemparseplot[plot]"
# Everything
pip install "chemparseplot[all]"

For development:

git clone https://github.com/HaoZeke/chemparseplot
cd chemparseplot
uv sync --all-extras

See the installation guide and quickstart for details.

Ecosystem Overview

chemparseplot is part of the rgpycrumbs suite of interlinked libraries.

img

Features

  • Parsing computational chemistry output files into structured data
  • Plotting with scientific color maps (camera-ready)
  • Unit preserving throughout via pint
  • Computation delegated to rgpycrumbs for surface fitting, interpolation, and structure analysis
  • NEB stitching (stitch_neb_segments) for continuous multi-segment bands (v1.8+)
  • Metadata-native eOn CON frames and typed parser results for NEB and single-ended tools
  • Unit-aware plot helpers (convert_neb_values, shared strip rendering) used by rgpycrumbs CLIs

Supported Engines

  • ORCA (5.x)
    • Geometry scan (OPT) energy profiles
    • Nudged elastic band (NEB) path visualization
  • eOn
    • Saddle search parsing (Dimer, GPRD, LBFGS methods)
    • NEB path energy profiles with landscape projections
  • Sella
    • Saddle point optimization result parsing
  • Trajectory formats
    • HDF5 trajectories (ChemGP output with pre-computed forces)
    • Generic ASE-readable formats (extxyz, .traj) for NEB analysis

Documentation

Full documentation is at https://chemparseplot.rgoswami.me. This includes:

Contributing

Contributions are welcome. See CONTRIBUTING.md for development setup and guidelines, and our Code of Conduct.

For bug reports or questions, open an issue on GitHub.

License

MIT. However, this is an academic resource, so please cite as much as possible via:

  • The Zenodo DOI for general use.
  • The wailord paper for ORCA usage

Acknowledgments

This project builds on work supported by the University of Iceland and the Icelandic Research Fund. chemparseplot relies on rgpycrumbs for computational modules.

Footnotes

1 To distinguish it from my other thin-python wrapper projects

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chemparseplot-1.9.2.tar.gz (129.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chemparseplot-1.9.2-py3-none-any.whl (163.6 kB view details)

Uploaded Python 3

File details

Details for the file chemparseplot-1.9.2.tar.gz.

File metadata

  • Download URL: chemparseplot-1.9.2.tar.gz
  • Upload date:
  • Size: 129.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chemparseplot-1.9.2.tar.gz
Algorithm Hash digest
SHA256 907b9de7b1f703e1004d42f367b36ec162ca620fcf4c9e1aa0f60f8808c778db
MD5 8e3ca48db7effe1cee9cb67612d39bd9
BLAKE2b-256 fe49021f7ad5bb795f558326f4305ac92f8b778e3aa555d35121878d79f56eda

See more details on using hashes here.

Provenance

The following attestation bundles were made for chemparseplot-1.9.2.tar.gz:

Publisher: release.yml on HaoZeke/chemparseplot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chemparseplot-1.9.2-py3-none-any.whl.

File metadata

  • Download URL: chemparseplot-1.9.2-py3-none-any.whl
  • Upload date:
  • Size: 163.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chemparseplot-1.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c11077a4b2f5e214ff448d1dc65bcb88ef4872e49d0522e1f9c4953ea447418c
MD5 bfed73a10a2eba8c09d198f3dd5db094
BLAKE2b-256 6c3fcac360ac7e2d34ebc228c561b92704b8cc7150a97c4ee2775432fb9e8db4

See more details on using hashes here.

Provenance

The following attestation bundles were made for chemparseplot-1.9.2-py3-none-any.whl:

Publisher: release.yml on HaoZeke/chemparseplot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page