shou0715-Arthur/hfss-pyaedt

HFSS PyAEDT

Visão Geral

Use este skill para realizar trabalhos scriptados no HFSS através do PyAEDT local, em vez de operar manualmente a GUI do HFSS. Prefira-o para configurações repetíveis, automação de geometria pequena, diagnósticos de ambiente e fluxos simples de simulação para exportação.

Este skill atualmente fornece um ponto de entrada estável: scripts/hfss_workflow.py. Comece com doctor, depois use new-box-project ou analyze-project.

Fluxo de Trabalho

1. Execute a verificação do ambiente antes de tocar no HFSS: py -3.14 scripts/hfss_workflow.py doctor
2. Leia references/local-environment.md se a versão ou a descoberta do caminho do Python for relevante.
3. Para um novo teste de automação (smoke test), crie um projeto mínimo com new-box-project.
4. Para um projeto .aedt existente, use analyze-project para definir variáveis, reexecutar uma configuração e, opcionalmente, exportar Touchstone.
5. Salve as saídas fora do repositório quando forem grandes ou com muitos dados binários.

Guia de Comandos

Doctor

Use este primeiro. Ele não inicia o HFSS. Ele relata o Python, PyAEDT e os diretórios de instalação do AEDT detectados.

py -3.14 scripts/hfss_workflow.py doctor

Use --json quando outra ferramenta ou script precisar consumir a saída.

Criar um Projeto Mínimo

Use este comando para o primeiro teste de fumaça em uma máquina ou quando precisar de um pequeno projeto HFSS determinístico.

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 NOME=VALOR é repetível.
• --non-graphical está disponível, mas prefira o modo gráfico até que o licenciamento local seja comprovadamente estável.
• A primeira versão cria apenas uma caixa. Estenda o script em vez de improvisar operações repetitivas e frágeis na GUI.

Analisar um Projeto Existente

Use este comando para reabrir um projeto .aedt salvo, atualizar variáveis, reexecutar uma configuração e, 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

Regras de Trabalho

• Prefira caminhos de arquivo explícitos para saídas .aedt e arquivos .sNp exportados.
• Trate o comportamento da API PyAEDT como sensível à versão. Se um método falhar, inspecione a assinatura atual do método antes de corrigir.
• Mantenha as automações de primeira passagem estreitas e verificáveis. Adicione uma nova operação HFSS de cada vez.
• Quando um usuário solicitar fluxos específicos de metasuperfícies ou antenas, estenda o script ou adicione um novo, em vez de sobrecarregar prompts com suposições não verificadas.
• Se a inicialização ou solução do HFSS falhar, execute doctor novamente, confirme os caminhos do AEDT instalados e capture o erro exato.

Referências

• references/workflow-recipes.md: exemplos de comandos e padrões de prompt do Codex
• references/local-environment.md: descobertas locais do AEDT e Python registradas durante a criação do skill