quantcore_circuits.sim_tools.aedt_progress

Live progress of an AEDT render / solve, read from the job directory while it runs (any AEDT mode).

AEDT in batch mode prints nothing to its log, so a stuck run and a slow one look the same. This reads what AEDT and the qcc script write as they go:

  • qcc_<mode>_status.txt (aedt_scripts): the current step (import, solve, export, epr);

  • <project>.aedtresults/<Design>.results/*.EMConvData (HFSS eigenmode / driven): one block per adaptive pass with the solved tetrahedra and MaxDeltaFreq (%) or MaxMagDeltaS, the target and the pass limit;

  • *_SOL*_M<n>_V*.sd (eigenmode): the mode frequencies of pass n;

  • *_SOL*_MCAP<n>_V*.sd (Q3D): the capacitance matrix of pass n; ΔC is the largest relative change of a diagonal entry from the previous pass (an estimate of Q3D’s own % error);

  • */current.stats: the current mesh size (NumTotalTets / NumTotalTris).

read_progress() returns a dict, format_progress() one line for the notebook (printed every ~30 s by quantcore_circuits.sim_tools.hfss.solve_job()).

Functions

format_progress(p[, elapsed, label, now]) → str

One status line: [aedt 4:30 batch pid 1234] solve · pass 7/14 · 65 324 tets · ΔF 8.09 % (target 0.2 %).

parse_em_conv(text) → dict

An HFSS .EMConvData file → {"passes": [{"pass", "elements", "delta"}], "criterion", "target", "max_passes", "converged"} (delta in % for ΔF, absolute for ΔS; frequency-point repeats are merged).

read_progress(job_dir[, mode]) → dict

What a running (or finished) AEDT job has done so far; see the module docstring. Missing files → None.

Module Contents

quantcore_circuits.sim_tools.aedt_progress.format_progress(p: dict, elapsed: float | None = None, label: str = '', now: float | None = None) → str

One status line: [aedt 4:30 batch pid 1234] solve · pass 7/14 · 65 324 tets · ΔF 8.09 % (target 0.2 %).

quantcore_circuits.sim_tools.aedt_progress.parse_em_conv(text: str) → dict

An HFSS .EMConvData file → {"passes": [{"pass", "elements", "delta"}], "criterion", "target", "max_passes", "converged"} (delta in % for ΔF, absolute for ΔS; frequency-point repeats are merged).

quantcore_circuits.sim_tools.aedt_progress.read_progress(job_dir: str | pathlib.Path, mode: str = 'solve') → dict

What a running (or finished) AEDT job has done so far; see the module docstring. Missing files → None.