shou0715-Arthur/hfss-pyaedt

Automatiser les tâches ANSYS HFSS sous Windows via PyAEDT. À utiliser lorsque Codex doit inspecter l'environnement HFSS local, créer ou modifier des projets HFSS, définir des variables de conception, construire une géométrie simple, créer des configurations et des balayages, exécuter des analyses ou exporter des résultats Touchstone à partir de projets `.aedt`.

Qu'est-ce que hfss-pyaedt ?

Cette compétence permet d'automatiser les tâches ANSYS HFSS sous Windows en utilisant PyAEDT, offrant ainsi une alternative au pilotage manuel de l'interface graphique HFSS. Elle est particulièrement utile pour les workflows reproductibles, l'automatisation de petites géométries, les diagnostics d'environnement et les chaînes de simulation simples jusqu'à l'exportation. Le point d'entrée principal est le script `scripts/hfss_workflow.py`, qui propose deux commandes principales : `doctor` pour vérifier l'environnement Python, PyAEDT et les chemins d'installation AEDT sans lancer HFSS, et `new-box-project` pour créer un projet HFSS minimal avec une boîte, une configuration et un balayage. La commande `analyze-project` permet de rouvrir un projet `.aedt` existant, de mettre à jour les variables, de relancer une configuration et d'exporter les résultats au format Touchstone. Les règles de travail encouragent l'utilisation de chemins de fichiers explicites, la sensibilité aux versions de l'API PyAEDT, ainsi qu'une approche progressive et vérifiable de l'automatisation.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shou0715-Arthur/pyaedt-examples-and-skills/tree/main/skills/hfss-api-skill

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

HFSS PyAEDT

Vue d'ensemble

Utilisez cette compétence pour effectuer un travail HFSS scripté via PyAEDT local plutôt que de piloter manuellement l'interface graphique HFSS. Préférez-la pour les configurations reproductibles, l'automatisation de petites géométries, les diagnostics d'environnement et les workflows simples de simulation à exportation.

Cette compétence fournit actuellement un point d'entrée stable : scripts/hfss_workflow.py. Commencez par doctor, puis utilisez new-box-project ou analyze-project.

Workflow

  1. Exécutez la vérification d'environnement avant de toucher à HFSS : py -3.14 scripts/hfss_workflow.py doctor
  2. Consultez references/local-environment.md si la version ou la découverte du chemin Python importe.
  3. Pour un nouveau test de validation rapide de l'automatisation, créez un projet minimal avec new-box-project.
  4. Pour un projet .aedt existant, utilisez analyze-project pour définir des variables, relancer une configuration et éventuellement exporter Touchstone.
  5. Enregistrez les sorties en dehors du dépôt lorsqu'elles sont volumineuses ou lourdes en binaires.

Guide des commandes

Doctor

Utilisez-la en premier. Elle ne lance pas HFSS. Elle rapporte Python, PyAEDT et les répertoires d'installation AEDT détectés.

py -3.14 scripts/hfss_workflow.py doctor

Utilisez --json lorsqu'un autre outil ou script doit consommer la sortie.

Créer un projet minimal

Utilisez-la pour le premier test sur une machine ou lorsque vous avez besoin d'un petit projet HFSS déterministe.

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

Remarques :

  • --set-variable NOM=VALEUR est répétable.
  • --non-graphical est disponible, mais préférez le mode graphique jusqu'à ce que la licence locale soit prouvée stable.
  • La première version ne crée qu'une seule boîte. Étendez le script plutôt que d'improviser des opérations GUI répétées et fragiles.

Analyser un projet existant

Utilisez-la pour rouvrir un projet .aedt sauvegardé, mettre à jour les variables, relancer une configuration et éventuellement exporter Touchstone.

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

Règles de travail

  • Préférez des chemins de fichiers explicites pour les sorties .aedt et les fichiers .sNp exportés.
  • Considérez le comportement de l'API PyAEDT comme sensible à la version. Si une méthode échoue, inspectez la signature actuelle de la méthode avant de la corriger.
  • Gardez les automatisations de première passe étroites et vérifiables. Ajoutez une nouvelle opération HFSS à la fois.
  • Lorsqu'un utilisateur demande des workflows de métasurface ou d'antenne, étendez le script ou ajoutez-en un nouveau plutôt que de surcharger les invites avec des hypothèses non vérifiées.
  • Si le lancement ou la résolution de HFSS échoue, relancez doctor, confirmez les chemins AEDT installés et capturez l'erreur exacte.

Références

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés