shou0715-Arthur/hfss-pyaedt

HFSS PyAEDT

Descripción general

Usa esta habilidad para realizar trabajo de HFSS automatizado a través de PyAEDT local en lugar de manejar manualmente la GUI de HFSS. Es preferible para configuraciones repetibles, automatización de geometrías pequeñas, diagnósticos del entorno y flujos de trabajo simples de simulación a exportación.

Esta habilidad actualmente incluye un punto de entrada estable: scripts/hfss_workflow.py. Comienza con doctor, luego usa new-box-project o analyze-project.

Flujo de trabajo

1. Ejecuta la verificación del entorno antes de tocar HFSS: py -3.14 scripts/hfss_workflow.py doctor
2. Lee references/local-environment.md si la versión o la ruta de Python son importantes.
3. Para una prueba de humo de automatización nueva, crea un proyecto mínimo con new-box-project.
4. Para un proyecto .aedt existente, usa analyze-project para establecer variables, re-ejecutar una configuración y, opcionalmente, exportar Touchstone.
5. Guarda los resultados fuera del repositorio cuando sean grandes o con muchos datos binarios.

Guía de comandos

Doctor

Úsalo primero. No ejecuta HFSS. Informa sobre Python, PyAEDT y los directorios de instalación detectados de AEDT.

py -3.14 scripts/hfss_workflow.py doctor

Usa --json cuando otro script o herramienta deba consumir la salida.

Crear un proyecto mínimo

Úsalo para la primera prueba de humo en una máquina o cuando necesites un proyecto HFSS pequeño y determinista.

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

Notas:

• --set-variable NAME=VALUE es repetible.
• --non-graphical está disponible, pero prefiere el modo gráfico hasta que la licencia local esté verificada.
• La primera versión solo crea un cubo. Extiende el script en lugar de improvisar operaciones repetitivas y frágiles en la GUI.

Analizar un proyecto existente

Úsalo para reabrir un proyecto .aedt guardado, actualizar variables, re-ejecutar una configuración y, opcionalmente, exportar 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

Reglas de trabajo

• Prefiere rutas de archivo explícitas para resultados .aedt y archivos .sNp exportados.
• Trata el comportamiento de la API de PyAEDT como sensible a la versión. Si un método falla, inspecciona la firma actual del método antes de parchear.
• Mantén las automatizaciones de primera pasada limitadas y verificables. Agrega una nueva operación de HFSS a la vez.
• Cuando un usuario solicite flujos específicos de metasuperficies o antenas, extiende el script o agrega uno nuevo en lugar de sobrecargar los prompts con suposiciones no verificadas.
• Si el lanzamiento o la resolución de HFSS fallan, vuelve a ejecutar doctor, confirma las rutas instaladas de AEDT y captura el error exacto.

Referencias

• references/workflow-recipes.md: ejemplos de comandos y patrones de prompt para Codex
• references/local-environment.md: hallazgos locales de AEDT y Python registrados durante la creación de la habilidad