Skip to content

docs: update README and PyOQP manuals#138

Merged
karmachoi merged 2 commits into
Open-Quantum-Platform:mainfrom
karmachoi:docs/readme-wiki-updates
May 25, 2026
Merged

docs: update README and PyOQP manuals#138
karmachoi merged 2 commits into
Open-Quantum-Platform:mainfrom
karmachoi:docs/readme-wiki-updates

Conversation

@karmachoi
Copy link
Copy Markdown
Contributor

@karmachoi karmachoi commented May 25, 2026

Summary

  • Add geomeTRIC optimizer backend documentation to README and PyOQP README
  • Add OpenqpView link and recent OpenqpView development summary to README
  • Document PySCF-backed pyscf, sad, and sap initial guesses in PyOQP README

Scope

  • Non-SOC README/manual updates only. SOC documentation is kept with PR SOC (1e and 2e cases) #128.
  • Wiki documentation was updated separately in the OpenQP wiki repository.

Test Plan

  • git diff --check

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5b12a2a1e7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread pyoqp/README.md Outdated
hess frequency calculation (numerical only)
nac non-adiabatic coupling (not available yet)
soc spin-orbit coupling (not available yet)
soc spin-orbit coupling for MRSF-TDDFT
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Mark SOC runtype as unavailable in PyOQP docs

Documenting runtype=soc as supported here is inconsistent with the current PyOQP execution path: pyoqp/oqp/utils/input_checker.py classifies soc as not implemented (NOT_AVAILABLE_RUNTYPES), and pyoqp/oqp/library/runfunc.py still leaves compute_soc as pass. In practice, users following this README will get a validation failure (or no SOC computation), so this change misleads users into a non-working workflow.

Useful? React with 👍 / 👎.

Comment thread pyoqp/README.md Outdated
False do not compute DFTD4 corrections according to functional (default)
True compute DFTD4 corrections for energy and gradients. some functional might not be supported

- soc_2e // choose SOC terms for runtype=soc
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Remove unsupported soc_2e option from input docs

Adding soc_2e under [input] introduces a non-functional configuration example: pyoqp/oqp/molecule/oqpdata.py does not define input.soc_2e in the schema, and pyoqp/oqp/utils/input_parser.py raises ValueError for unknown options. A user copying this documented input will fail at parse/validation time before any calculation starts.

Useful? React with 👍 / 👎.

@karmachoi karmachoi merged commit cf4fb0f into Open-Quantum-Platform:main May 25, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant