Outcome: resolved settings, warnings, errors¶
Every output says what the calculation decided and, if it failed, why, in the same fields
whichever program produced it. warnings, error and record are on ProgramOutput and
on each Frame; resolved only on ProgramOutput. The vocabularies are in
Conventions.
qcdata.Resolved
¶
The settings a calculation actually used.
Attributes:
| Name | Type | Description |
|---|---|---|
settings |
FreeDict
|
The program's complete settings tree with every |
reasons |
dict[str, str]
|
Why each automatic choice was made, keyed by dotted settings path
( |
deferred |
list[str]
|
In a plan only: dotted paths of settings left |
qcdata.ProgramWarning
¶
Something the program wants the caller to know about a calculation that ran.
Attributes:
| Name | Type | Description |
|---|---|---|
code |
str
|
A stable snake_case code: one the conventions share
( |
message |
str
|
A human-readable explanation. |
path |
str | None
|
The settings key the warning concerns, as a dotted path ( |
qcdata.ErrorInfo
¶
A structured description of a failure.
The Python traceback stays in ProgramOutput.traceback; this is what a caller
branches on.
Attributes:
| Name | Type | Description |
|---|---|---|
kind |
ErrorKind
|
The kind of failure. |
message |
str
|
A human-readable explanation. |
code |
str | None
|
A stable snake_case code that refines |
program |
str | None
|
The subprogram that failed (kind |
cause |
ErrorInfo | None
|
The subprogram's own error, for kind |
details |
FreeDict
|
Structured facts about the failure, as plain JSON, so callers need
not parse |
qcdata.ErrorKind
¶
Why a calculation failed, in one vocabulary across programs.
Attributes:
| Name | Type | Description |
|---|---|---|
input |
Settings or a structure the program cannot run as given (an unknown key, a bad value, an unknown basis set or method). |
|
unsupported |
A valid request the program does not implement, or a setting it cannot honour that would change the result. |
|
convergence |
An iterative procedure (SCF, response equations, an optimization) did not converge; the results reached are attached. |
|
numerical |
A numerical failure: non-finite values, singular matrices. |
|
resource |
Not enough memory, disk, or another resource as set up. |
|
backend |
The hardware backend failed (no usable GPU, a device error). |
|
program |
A subprogram failed; |
|
timeout |
The calculation ran out of time (set by the runner). |
|
stopped |
The program stopped on request at one of its steps (a runner's stop,
which the program sees as |
|
environment |
The program could not be run at all: not installed, no licence, the process died (set by the runner). |
|
internal |
A failure nobody anticipated: a bug (an exception other than
|