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 the output of the quantum chemistry program (ORCA), eOn, Sella and ChemGP. It 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

Suite config (shared with rgpycrumbs — no ~/.config/chemparseplot):

# ~/.config/rgpkgs/config.toml  or  ./rgpkgs.toml
# [pins] lock = "uv.lock"
# [pins.packages] …

Feature extras such as plot and neb are a transitional install convenience. The target is the same on-demand uv / ensure_import design as the rgpycrumbs hub. Prefer the bare install and the suite pins for new work.

# transitional:
# 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 for the dimer and Gaussian process regression dimer (GPRD) methods, with their optimizers such as lbfgs.
    • NEB energy profiles and 2D surface projections of the path.
  • 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:

The map of the site, llms.txt, lists the pages with a line on what each covers, and llms-full.txt has the manual in one Markdown file and names what it leaves out. AGENTS.md has the build, test and documentation commands and the mistakes that are easy to make, and skills/ has task guides whose scripts CI runs: reading an ORCA scan, adding a parser, and finding the source of a docs page.

Contributing

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

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

License

chemparseplot is released under the Massachusetts Institute of Technology (MIT) License. This is an academic resource, so please cite it as much as possible via:

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

Metadata

Release files for chemparseplot 1.14.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chemparseplot 1.14.1
File Size Uploaded Provenance Actions
chemparseplot-1.14.1.tar.gz 611.3 kB With provenance Details for chemparseplot-1.14.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chemparseplot 1.14.1
File Interpreter ABI Platform Actions
chemparseplot-1.14.1-py3-none-any.whl Python 3 none any Details for chemparseplot-1.14.1-py3-none-any.whl

Total release size: 1.3 MB

Release files / chemparseplot-1.14.1.tar.gz

Download URL chemparseplot-1.14.1.tar.gz
Size 611.3 kB
Tags Source
SHA-256 checksum
How to use checksums
33868857d6edffdb92c2798315c6d864f4c2d9fb7bd03972ecfe42d3193365ce
BLAKE2b-256 checksum
How to use checksums
0036108d97154950340dbaf6859de7fff2f590c82c3ef4a7da8e214558664e75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / chemparseplot-1.14.1-py3-none-any.whl

Download URL chemparseplot-1.14.1-py3-none-any.whl
Size 687.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
127e4c3163d80e8b16be5ce1998bcc006b557a107d3e2ebc695cc3a8415a6a29
BLAKE2b-256 checksum
How to use checksums
8a08bb580f521e6afb35a294522bc7c6187627aece6bd6c77d3615ecd197fc85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for chemparseplot 1.14.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for chemparseplot-1.14.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.14.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page