eOn Helpers¶

Tools for eOn job output, library plotting, and CON I/O. See eOn docs and pyeonclient for the client/runtime.

CLI Tools

Library plot API (preferred for notebooks)¶

Use the Python library instead of shelling out to the CLI when you already have paths, job directories, or live pyeonclient objects:

from rgpycrumbs.eon import plot, plot_neb, plot_min, plot_saddle

# File / job-dir based (same pipelines as the CLI)
plot_neb(plot_type="profile", con_file="neb.con", output_file="1d.pdf")
plot_min(job_dir="minimization_run", plot_type="landscape", output="min.pdf")

# Live pyeonclient objects (after compute / retain_frames)
plot(neb, plot_type="profile", output_file="1d.pdf")          # path_frames()
plot(matter, plot_type="profile", output="min.pdf")           # movie_frames()
plot(ss, plot_type="profile", output="sad.pdf")               # climb_frames()

# Or an explicit ConFrame sequence (kind required; no job-dir sniffing)
plot(frames, kind="neb", plot_type="profile", output_file="1d.pdf")

Library plot entry points enable RGPYCRUMBS_AUTO_DEPS by default (same as the CLI dispatcher). Heavy deps (chemparseplot, jax, adjustText, xyzrender) stage via ensure_import + uv when missing—no host env pins required for those. Prefer --config plot.toml / config= for surface-fit and strip knobs (plot TOML config).

API Reference¶

For developer details, see the eOn Helper Reference [1] .