shou0715-Arthur/hfss-pyaedt

HFSS PyAEDT

Überblick

Nutzen Sie diese Fähigkeit, um HFSS-Aufgaben über lokale PyAEDT-Skripte zu automatisieren, anstatt die HFSS-GUI manuell zu bedienen. Bevorzugen Sie sie für wiederholbare Setups, kleine Geometrieautomatisierungen, Umgebungsdiagnosen und einfache Arbeitsabläufe von der Simulation bis zum Export.

Diese Fähigkeit liefert derzeit einen stabilen Einstiegspunkt: scripts/hfss_workflow.py. Beginnen Sie mit doctor, verwenden Sie dann new-box-project oder analyze-project.

Arbeitsablauf

1. Führen Sie die Umgebungsprüfung vor der HFSS-Nutzung durch: py -3.14 scripts/hfss_workflow.py doctor
2. Lesen Sie references/local-environment.md, wenn Versions- oder Python-Pfad-Ermittlungen relevant sind.
3. Für einen ersten Automatisierungs-Rauchtest erstellen Sie ein Minimalprojekt mit new-box-project.
4. Für ein bestehendes .aedt-Projekt verwenden Sie analyze-project, um Variablen zu setzen, ein Setup erneut auszuführen und optional Touchstone zu exportieren.
5. Speichern Sie große oder binäre Ausgaben außerhalb des Repositorys.

Befehlsübersicht

Doctor

Verwenden Sie dies zuerst. Es startet HFSS nicht. Es meldet Python-, PyAEDT- und erkannte AEDT-Installationsverzeichnisse.

py -3.14 scripts/hfss_workflow.py doctor

Verwenden Sie --json, wenn ein anderes Tool oder Skript die Ausgabe konsumieren soll.

Ein Minimalprojekt erstellen

Verwenden Sie dies für den ersten Rauchtest auf einem Rechner oder wenn Sie ein winziges deterministisches HFSS-Projekt benötigen.

py -3.14 scripts/hfss_workflow.py new-box-project `
  --project C:\temp\hfss\demo_box.aedt `
  --design HFSSDesign1 `
  --solution-type DrivenModal `
  --origin 0mm,0mm,0mm `
  --size 10mm,10mm,1mm `
  --create-open-region `
  --setup-name Setup1 `
  --setup-frequency 10GHz `
  --sweep-name Sweep1 `
  --sweep-start 8 `
  --sweep-stop 12 `
  --sweep-count 401

Hinweise:

• --set-variable NAME=VALUE ist wiederholbar.
• --non-graphical ist verfügbar, aber der grafische Modus wird bevorzugt, bis die lokale Lizenzierung als stabil bestätigt ist.
• Die erste Version erstellt nur einen Quader. Erweitern Sie das Skript, anstatt fragile GUI-Operationen improvisiert zu wiederholen.

Ein bestehendes Projekt analysieren

Verwenden Sie dies, um ein gespeichertes .aedt-Projekt wiederzuöffnen, Variablen zu aktualisieren, ein Setup erneut auszuführen und optional Touchstone zu exportieren.

py -3.14 scripts/hfss_workflow.py analyze-project `
  --project C:\temp\hfss\demo_box.aedt `
  --design HFSSDesign1 `
  --setup-name Setup1 `
  --sweep-name Sweep1 `
  --set-variable L=12mm `
  --export-touchstone C:\temp\hfss\demo_box.s2p

Arbeitsregeln

• Bevorzugen Sie explizite Dateipfade für .aedt-Ausgaben und exportierte .sNp-Dateien.
• Behandeln Sie das PyAEDT-API-Verhalten als versionsabhängig. Wenn eine Methode fehlschlägt, überprüfen Sie die aktuelle Methodensignatur, bevor Sie Patches anwenden.
• Halten Sie erste Automatisierungen eng und überprüfbar. Fügen Sie jeweils eine neue HFSS-Operation hinzu.
• Wenn ein Benutzer nach Metasurface- oder antennenspezifischen Abläufen fragt, erweitern Sie das Skript oder fügen Sie ein neues hinzu, anstatt die Aufforderungen mit ungeprüften Annahmen zu überladen.
• Wenn HFSS-Start oder -Lösung fehlschlägt, führen Sie doctor erneut aus, bestätigen Sie die installierten AEDT-Pfade und erfassen Sie den genauen Fehler.

Referenzen

• references/workflow-recipes.md: Befehlsbeispiele und Codex-Prompt-Muster
• references/local-environment.md: Lokale AEDT- und Python-Erkenntnisse, die bei der Erstellung der Fähigkeit aufgezeichnet wurden