Skip to content

Input File Format

OpenQP inputs are INI-like text files. Options are grouped by section:

[input]
runtype=energy
method=hf
basis=6-31g*

[scf]
type=rhf

Lines beginning with # are comments. Keyword names are case-insensitive in normal use, but this manual uses lower-case names to match the Python schema.

Geometry

Inline coordinates are written under [input] system with indented atom lines:

[input]
system=
   O   0.000000000   0.000000000  -0.041061554
   H  -0.533194329   0.533194329  -0.614469223
   H   0.533194329  -0.533194329  -0.614469223

An external XYZ file can be used instead:

[input]
system=h2o.xyz

Some workflows, such as NACME, also use [input] system2 for the displaced or previous geometry.

Core Sections

Section Purpose
[input] Charge, basis, method, run type, geometry, AO convention, threading.
[guess] Initial orbitals and restart data.
[scf] RHF/ROHF/UHF reference and SCF convergence controls.
[dftgrid] DFT functional/grid controls.
[tdhf] TDHF, TDDFT, SF-TDDFT, MRSF-TDDFT, and UMRSF settings.
[properties] Gradients, NAC, NMR, export, and property requests.
[optimize] Geometry-optimization target and convergence controls.
[oqp] Native optimizer controls.
[geometric] geomeTRIC backend controls.
[pcm] Reference-SCF PCM/ddX energy settings.
[symmetry] Point-group metadata and optional symmetry reductions.
[hess] Hessian and frequency controls.
[nac] NAC/NACME controls.
[ekt] MRSF-EKT IP/EA channel selection.
[neb] NEB product and image controls.

Run Types

Common [input] runtype values:

Run type Meaning
energy Single-point energy and requested properties.
grad Energy plus gradient for the requested state.
hess Hessian/frequency workflow.
nacme Time/geometric derivative coupling between MRSF states.
soc MRSF-TDDFT spin-orbit coupling workflow.
ekt MRSF-EKT ionization-potential/electron-affinity workflow.
optimize Geometry optimization.
meci, mecp, tci Crossing-point searches.
ts, irc, neb, mep Reaction-path workflows.
prop, data Multi-state property/gradient workflows for downstream drivers.

md is recognized by validation code but is not the current production workflow in this repository.