Execution information¶
Every ProgramOutput has execution: ExecutionInfo, defaulting to an empty ExecutionInfo(). Individual fields may be unknown; explicit execution=None is invalid. Passing ExecutionInfo() or execution={} means output.execution.wall_time returns None without requiring a check for the execution object itself.
host_cpu counts logical CPUs; host_mem_gib accepts fractional values. The former hostcpus and hostmem names are no longer accepted.
wall_time is measured in seconds and host_mem_gib in GiB. host_cpu and host_mem_gib describe host capacity, not the resources allocated to the job. Each frame or scan point records its own execution information, including its working directory.
identities says which code made the results (each program's numerics identity, set by the runner), and store_run names the stored run an output is ("<key>/<run>"): set on every output a store returns and on one a runner has just stored, None on an output no store holds.
qcdata.ExecutionInfo
¶
Runtime information about a program execution.
All fields may be unknown. Pass ExecutionInfo() when no details are available.
Attributes:
| Name | Type | Description |
|---|---|---|
scratch_dir |
Path | None
|
The working directory used by the program. |
wall_time |
float | None
|
Elapsed execution time in seconds. |
hostname |
str | None
|
The hostname of the machine where the program ran. |
host_cpu |
int | None
|
The number of logical CPUs on the host, not the allocated CPU count. |
host_mem_gib |
float | None
|
The host's total memory in GiB, not the allocated memory. |
cpu_model |
str | None
|
The CPU's model name, as the operating system reports it. |
devices |
list[str]
|
The names of the GPUs the calculation ran on, in device order. |
libc |
str | None
|
The C library and its version ( |
timings |
dict[str, float]
|
Wall-clock seconds per phase of the calculation. The keys are the
program's; |
threads |
int | None
|
CPU threads the calculation ran with. Some programs' results depend on it at round-off, so it is recorded with every result. |
peak_memory_gib |
float | None
|
Peak host memory the calculation used (GiB), as measured. |
peak_device_memory_gib |
float | None
|
Peak GPU memory the calculation used (GiB), as measured; schedulers compare it with the plan's estimate. |
identities |
dict[str, str]
|
Which code produced the results: |
store_run |
str | None
|
Where the output is filed in a store, as |
extras |
FreeDict
|
Additional execution information. |