quantcore_circuits.sim_tools.hfss

Render a design into an Ansys HFSS / Q3D project (geometry, materials, ports, Lj boundaries), and solve it.

render = build_simulation → KQC export_ansys job → one batch AEDT run of scripts/qcc_render.py (aedt_scripts: KQC’s import_simulation_geometry.py + qcc port fix-ups + π-model/reports, saved as <sim>_project.aedt, no solve). solve runs scripts/qcc_solve.py on a job directory (import, fix-ups, AnalyzeAll, KQC’s export_solution_data.py, qcc extras incl. the pyEPR field integrals) and then collect_results().

Where AEDT runs (aedt=, aedt_session): "batch" (default, or QCC_AEDT_MODE) a separate non-graphical process (-ng + pyaedt’s feature flag); "gui" a new AEDT window that stays open after the run; "attach" inside an AEDT window that is already open (else as "gui"), released afterwards with every project left open. While a job runs, one progress line (step, pass, mesh, ΔF / ΔS / ΔC, mode frequencies) is printed every progress s (30; aedt_progress). On a timeout only processes qcc started are killed (never an attached session).

group="chip" renders the whole chip (nothing cut; bond pads get 50 Ω lumped ports), any other name renders that sim_groups cut-out. Verified on AEDT 2024 R1 (v241, Windows).

Attributes

Classes

Functions

aedt_env() → dict

Environment for batch AEDT runs (enables non-graphical script execution).

aedt_summary(project) → dict

Design type and name, solution type, variables, boundaries by type, nets and setups of an .aedt file.

check_project(job_dir) → dict

Read the rendered project back and check it against the job: stack, ports/boundaries, nets, settings.

render(source[, group, analysis, job_dir, jobs_root, ...]) → RenderResult

Build group of source and render it into an AEDT project (see module docstring); solve=True also

render_command(job_dir[, executable, graphical, script]) → list[str]

ansysedt command line for a qcc AEDT script (non-graphical by default, as pyaedt launches AEDT).

render_status(job_dir[, mode]) → list[str]

Module Contents

class quantcore_circuits.sim_tools.hfss.RenderResult
job_dir: pathlib.Path
log: pathlib.Path
mode: str = 'batch'
note: str = ''
property ok: bool
owned: bool = True
pid: int | None = None
project: pathlib.Path | None
results: dict
returncode: int
seconds: float
status: list[str] = []
summary: dict
quantcore_circuits.sim_tools.hfss.aedt_env() → dict

Environment for batch AEDT runs (enables non-graphical script execution).

quantcore_circuits.sim_tools.hfss.aedt_summary(project: str | pathlib.Path) → dict

Design type and name, solution type, variables, boundaries by type, nets and setups of an .aedt file.

quantcore_circuits.sim_tools.hfss.check_project(job_dir: str | pathlib.Path) → dict

Read the rendered project back and check it against the job: stack, ports/boundaries, nets, settings.

Returns {"ok": bool, "checks": [{"check", "ok", "detail"}], "settings": [...]}.

quantcore_circuits.sim_tools.hfss.render(source, group: str = CHIP_GROUP, analysis: str = 'eigenmode_epr', job_dir: str | pathlib.Path | None = None, jobs_root: str | pathlib.Path = 'build/jobs', overwrite: bool = True, solve: bool = False, open_gui: bool = False, graphical: bool = False, timeout: float | None = None, executable: str | pathlib.Path | None = None, airbridges: bool | None = None, aedt: str | None = None, progress: float | None = None, aedt_pid: int | None = None, **settings) → RenderResult

Build group of source and render it into an AEDT project (see module docstring); solve=True also solves it and collects the results. timeout (s) defaults to 30 min for a render and 6 h for a solve; on a timeout only the AEDT process tree started here is killed. airbridges keeps (True) or drops (default, or the group’s settings["airbridges"]) airbridge geometry; settings override the solver defaults. aedt: "batch" | "gui" | "attach" (module docstring); progress: seconds between progress lines.

quantcore_circuits.sim_tools.hfss.render_command(job_dir: pathlib.Path, executable: pathlib.Path | None = None, graphical: bool = False, script: str = RENDER_SCRIPT) → list[str]

ansysedt command line for a qcc AEDT script (non-graphical by default, as pyaedt launches AEDT).

quantcore_circuits.sim_tools.hfss.render_status(job_dir: str | pathlib.Path, mode: str = 'render') → list[str]
quantcore_circuits.sim_tools.hfss.solve