企业官网建设流程全解析

简介：这份面向 Ansys HFSS 与 MATLAB 联合仿真场景的资料包，适合射频微波方向的学生、科研人员及需要提升自动化建模效率的工程师。它围绕 HFSS API、MATLAB 调用与 VBS 脚本展开，可用于参数化建模、批量仿真和结果后处理等任务。压缩包共 210 个文件、约 60.07MB，主体为 97 个 p 文件与 50 个 m 脚本，另含 37 份 PDF 说明、6 个 aedt 与 2 个 hfss 工程、VBS 脚本及 mlapp 工具，便于按代码、文档和模型分层查阅。示例覆盖侧馈圆极化贴片、FSS 阵列、Vivaldi 天线和基础对象建模，可帮助读者理解 API 调用流程与工程组织方式。已有 44 人学习下载，适合作为联合仿真入门与脚本复用的参考材料。

1. 一条贴片天线扫 40 组参数：hfssapi.pro 把 MATLAB 变成 HFSS 的外壳

去年帮一个做天线的朋友改结构，2.4 GHz 贴片，只扫基板厚度和馈点位置两个变量，各 20 组。他在图形界面里手动改尺寸、重新求解、抄 S11 最低点，一组八分钟，四十组熬到凌晨三点，中间还抄错了两次。后来换成 hfssapi.pro 这套 MATLAB 仿真资源，思路一下就顺了：MATLAB 当调度层，负责参数组合、循环和画图，HFSS 退化成后端的求解器，靠 COM 接口被调用。这套资源提供的是一组函数封装，把hfssNewProject、hfssInsertDesign、hfssCreateBox、hfssAssignMaterial、hfssSolveSetup、hfssExportToFile这类动作包成一句调用，建模不再需要手写那一长串属性数组。适合已经在 MATLAB 里做后处理、需要批量重复建模的人；如果你一年只仿真一个模型，或者主力系统不是 Windows，那这套东西的收益抵不过配置成本。

2. 打通 COM 通道：三行 actxserver 背后的位数、版本与权限约束

通道不通，后面所有代码都是废纸。这一步看起来只有三行，翻车的人却最多，我见过有人在这卡了两天，最后发现是 MATLAB 装成了 32 位。

2.1 为什么走 COM 进程内调用，而不是生成脚本再批处理

HFSS 侧的自动化有两条常见路径：一是把建模和求解写成一个.vbs或.py脚本，命令行批处理跑完再读结果文件；二是通过 COM 在进程内把 HFSS 当对象调用。hfssapi.pro 选的是后者，理由很实际。

批处理路径的痛点在于状态是断的。脚本跑完，MATLAB 只能去某个目录捞结果文件，想知道"这次求解到底收敛没有""端口阻抗是多少"就得再解析一遍文本。而 COM 调用里，oDesign.Analyze返回之后你可以立刻把求解矩阵数、收敛曲线、端口 Z0 读回来，据此决定要不要加密网格重跑——这种"边算边判断"的闭环，是外层做优化算法时的刚需。代价也明确：COM 是 Windows 独占，一次只能有一个客户端抓着那个 HFSS 实例，MATLAB 崩了 HFSS 往往也半死不活地挂在后台。

我的建议是两者混用：外层工况循环用 COM，单个工况内部的几百次建模调用可以攒成一个脚本一次性执行，减少往返开销。

2.2 版本、位数与权限：三个必须先确认的前置

第一是位数。HFSS 现在基本都是 64 位，那 MATLAB 也必须是 64 位。这一条听起来废话，但 32 位 MATLAB 调用 64 位 COM 服务器时报的错是"服务器执行失败 (0x80080005)"，跟权限问题、许可证问题的报错长得一模一样，极易误判。

第二是 ProgID。不同安装形态注册的名字不一样：独立安装的 HFSS 常见AnsoftHfss.HfssScriptInterface，集成到电子桌面平台里的常见Ansoft.ElectronicsDesktop。你不需要猜，直接两个都试一遍，能连上哪个用哪个。

第三是权限级别。MATLAB 以管理员运行时，它启动的 COM 服务器默认也在高完整性级别；如果 HFSS 同时又被人从普通权限的快捷方式打开，两边就抢同一个设计文件，报错信息会非常玄学。我一般的做法是：跑脚本前把手动打开的 HFSS 全部关掉，MATLAB 用普通权限启动，谁也别去碰图形界面。

提示：许可证是跟着进程走的。调试阶段反复actxserver而不退出，很容易把浮动许可占满，后面的人排队等你，这事儿我干过一次，被念了很久。

2.3 一段探活代码：先确认连得上，再谈建模

不要一上来就写建模逻辑。先写十行探活，把连接、版本回读、退出三步走通，能省掉后面 80% 的排查时间。

% 依次尝试两种 ProgID，连上就打印版本并退出，只做探活 progIds = {'AnsoftHfss.HfssScriptInterface', 'Ansoft.ElectronicsDesktop'}; hfss = []; for k = 1:numel(progIds) try hfss = actxserver(progIds{k}); % 启动或附着到 COM 服务器 fprintf('已连接: %s\n', progIds{k}); break; catch ME fprintf('失败: %s -> %s\n', progIds{k}, ME.message); end end if isempty(hfss) error('两种 ProgID 均无法连接，先查位数、安装注册与权限'); end app = hfss.GetAppDesktop(); % 桌面级对象，工程从它派生 fprintf('版本: %s\n', app.GetVersion()); % 回读版本，确认连的是哪一套 app.Quit(); % 探活结束立刻释放，别占许可 clear hfss app;

逻辑说明：actxserver是唯一一次"握手"，它会启动一个新实例或者附着到已有实例，具体行为取决于注册表里的 LocalServer32 配置。所以同一段代码在不同机器上可能打开一个新窗口，也可能直接接管你手动开着的那个。后面的GetAppDesktop才是所有工程操作的入口，NewProject、OpenProject、GetActiveProject都挂在它下面。

参数说明：progIds的顺序可以按你的实际安装调整，把常用的放前面能少一次失败尝试；GetVersion返回的是字符串，我只用来打印，不做版本分支判断，因为不同小版本之间接口字段的差异比版本号本身更值得关注，靠版本号做兼容判断往往是自欺欺人。Quit这一步在探活阶段必须有，正式脚本里则应该包在onCleanup里，异常退出也能释放。

最后补一个几乎所有老手都在用、但新手常忽略的技巧：HFSS 界面里有"录制脚本"功能，你手动建一个盒子、赋一次材料、加一个端口，它把对应的 VBScript 完整记下来。那串NAME:xxx、key:=value的属性名不用背，录一遍照着翻译成 MATLAB 的 cell 数组即可。这套 hfssapi.pro 里的封装函数，本质上就是把这些录制出来的调用固定成了常用组合；遇到封装没覆盖的接口，录制脚本就是唯一的权威字典。

3. 建模函数拆解：CreateBox 属性数组里真正要管的四个字段

封装函数看着简单，第一次自己扩一个没被封装的动作时，几乎所有人都会在属性数组上卡住。这一章把三层句柄和属性数组的组装规则拆开。

3.1 三层句柄：Application → Project → Design → Editor

所有建模动作都建立在一条对象链上，链断了后面全是空句柄错误。

app = hfss.GetAppDesktop(); % 第一层：应用 app.NewProject(''); % 新建空工程 project = app.GetActiveProject(); % 第二层：工程 design = project.InsertDesign('HFSS', 'PatchDemo', ... 'DrivenModal', ''); % 第三层：设计，返回句柄 oEditor = design.SetActiveEditor('3D Modeler'); % 建模器 % 单位必须在建几何之前设，建完再改会按比例重算，尺寸全乱 oEditor.SetModelUnits({'NAME:Units Parameter', ... 'Units:="mm"', 'Rescale:=', false});

逻辑说明：InsertDesign会直接返回设计句柄，但很多示例先SetActiveDesign再GetActiveDesign，两种都行——前者更短，后者在切换多个设计时更清楚。真正容易忽略的是SetActiveEditor：HFSS 里有好几个编辑器，"3D Modeler" 管几何，"BoundarySetup" 管边界，"AnalysisSetup" 管求解，名字传错就会拿到一个能调用但什么都不做的对象，静默失败。

参数说明：InsertDesign的第三个参数是求解类型，常见取值DrivenModal（看 S 参数和模式）、DrivenTerminal（多导体端口）、Eigenmode（本征模）。这个参数选错不会报错，但后面加波端口时行为会完全不同，尤其做差分线、共面波导时要留意。SetModelUnits的Rescale建议始终给false，让它只改标注单位而不缩放已有几何；如果你是在已有工程上追加建模，给true会把之前建的模型整体缩放一遍，那种错查起来非常痛。

3.2 CreateBox 的属性数组：十个字段里只有四个要管

CreateBox接受两个数组，第一个描述几何参数，第二个描述对象属性。官方录制的脚本里字段有十几个，实际需要你每次都想清楚的只有四个。

oEditor.CreateBox( ... {'NAME:BoxParameters', ... 'XPosition:=-15mm', 'YPosition:=-15mm', 'ZPosition:=0mm', ... 'XSize:=30mm', 'YSize:=30mm', 'ZSize:=1.6mm'}, ... {'NAME:Attributes', ... 'Name:=Substrate', ... % 1. 对象名，后面全靠它引用 'MaterialValue:="FR4_epoxy"', ... % 2. 材料，用库里的精确名字 'SolveInside:=', true, ... % 3. 是否在内部求解 'Color:=(132 132 193)', 'Transparency:=0.6', ... 'Flags:=', '', 'PartCoordinateSystem:=Global', ... 'UDMId:=', '', 'CoordinateSystemID:='});

逻辑说明：属性数组是"名字 + 值"交替排列的扁平 cell，NAME:xxx是块标记，key:=value是键值对。需要注意三种值的写法差异——普通数值直接给，带单位的量写成字符串'1.6mm'，字符串值需要额外包一层双引号'"FR4_epoxy"'。最后这一条是新手最常栽的地方：写成'FR4_epoxy'有时也能过，但一旦材料名里带空格（比如带注册商标后缀的板材名），不加引号就会被当成两个参数解析，报一个完全不着边际的语法错。

参数说明：SolveInside对介质必须为true，对金属实心体设为false能省掉内部未知量，网格量差好几倍。Name一旦定了，后面赋边界、赋端口、导出都要用它，我习惯用有语义的英文名而不是Box1、Box2，脚本改起来才不至于对不上号。Transparency只影响显示，不影响计算，但设成 0.6 之后你能一眼看穿叠层结构，调模型时省事。

几何位置我已经习惯用绝对坐标加显式单位写死，而不是依赖模型单位。理由是这套脚本经常被复用到旧工程上，旧工程的单位可能是 inch，靠SetModelUnits兜底不如每个尺寸都带上mm来得确定。

3.3 把尺寸抽成设计变量，让 HFSS 自己扫

如果每个尺寸都是硬编码常量，那 MATLAB 循环就得每次重建模型，几十个工况还能忍，几百个就慢得离谱。更好的做法是先把关键尺寸定义成设计变量，之后只改变量值，几何自动重算。

% 在设计的局部变量表里新增一个变量 sub_h oEditor.ChangeProperty({'NAME:AllTabs', ... {'NAME:LocalVarTab', ... {'NAME:PropServers', 'LocalVariables'}, ... {'NAME:NewProps', ... {'NAME:sub_h', 'PropType:="Variable"', ... 'UserDef:="true"', 'Value:="1.6mm"'}}}}); % 后续改变量值：块名换成 ChangedProps，只给 NAME 和新 Value oEditor.ChangeProperty({'NAME:AllTabs', ... {'NAME:LocalVarTab', ... {'NAME:PropServers', 'LocalVariables'}, ... {'NAME:ChangedProps', ... {'NAME:sub_h', 'Value:="2.0mm"'}}}});

逻辑说明：ChangeProperty是所有属性修改的总入口，靠AllTabs下的块名区分改的是哪张表。新建用NewProps，修改用ChangedProps，这两个块名搞混是最隐蔽的坑——它不报错，只是什么都不做，你会以为变量已经改了，跑完发现四十个工况结果一模一样。

参数说明：PropType:="Variable"表示这是设计变量，之后可以在Optimetrics里直接引用；UserDef:="true"表示用户自定义，否则某些版本会把它当成系统内部量隐藏起来。变量名不要用中文和空格，也不要和 HFSS 内置的保留字撞名（比如freq），撞了之后引用处会解析成内置量，值永远是你没设过的那个。

把变量建好之后，MATLAB 侧的参数扫描就变成了一个纯数值循环：改值、求解、导出、下一个。建模只发生一次，这才是这套资源真正的效率来源。

4. 边界、端口与求解设置：跑出一条能用的 S11 曲线要设对哪几个数

几何建完只是有了个壳子。真正决定结果对不对的，是空气腔、端口和收敛判据这三块。

4.1 空气腔与辐射边界：距离给多少不是随便定的

辐射类问题的通用做法是：把所有辐射体包进一个空气盒，盒壁赋辐射边界。距离给多少，直接影响结果可信度。

% 空气盒：在基板上方留出足够空间，四周外扩 oEditor.CreateBox( ... {'NAME:BoxParameters', ... 'XPosition:=-45mm', 'YPosition:=-45mm', 'ZPosition:=-10mm', ... 'XSize:=90mm', 'YSize:=90mm', 'ZSize:=60mm'}, ... {'NAME:Attributes', 'Name:=AirBox', ... 'MaterialValue:="vacuum"', 'SolveInside:=', true, ... 'Transparency:=0.9', 'Color:=(143 175 143)'}); % 给空气盒外表面赋辐射边界 oModule = design.GetModule('BoundarySetup'); oModule.AssignRadiation({'NAME:Rad_AirBox', ... 'Objects:=', {'AirBox'}, ... 'IsFssReference:=', false, 'IsForPML:=', false});

逻辑说明：AssignRadiation只需要对象名，它会把该对象所有外表面一次性赋上。注意空气盒必须是一个独立的、封闭的实体，如果它和基板有重叠，布尔运算会把它切成碎片，辐射边界就只盖住了一部分面，结果表现为增益明显偏低而 S11 反而还行——这种"一半对一半错"的结果最难查。

参数说明：外扩距离按最低工作频率对应的自由空间波长取，我一般给 λ/4 到 λ/3。2.4 GHz 的 λ 约 125 mm，λ/4 是 31 mm，上面例子给了 45 mm，偏保守但安全。给得太小（比如 λ/10）会让辐射边界离天线太近，近场被强行截断，输入阻抗虚部偏移，S11 谐振点会往低频跑。用 PML 代替辐射边界时把IsForPML置true，层数一般 4 到 8 层，间距按 λ/10 以内取。

4.2 波端口还是集总端口：选错了结果差得离谱

这是新手最容易做错的一步，而且做错之后结果看着"像那么回事"，很难自我察觉。

波端口的代码大致是：

oModule = design.GetModule('BoundarySetup'); oModule.AssignWavePort({'NAME:Port1', ... 'Faces:=', {7}, ... % 面编号，必须自己查 'NumModes:=', 1, ... 'UseLineMode:=', false, ... 'RenormalizeAllTerminals:=', true, ... 'DoDeembed:=', false, ... 'ShowReporterFilter:=', false, ... 'ReporterFilter:=', {'All'}, ... 'Impedance:="', '50ohm', '"'});

逻辑说明：Faces用的是几何面编号，不是对象名，这是尴尬之处——面编号会随布尔运算和建模顺序变化。稳妥做法是建完几何后先GetFaceIDs之类的方式枚举，或者在封装的辅助函数里按坐标筛面。我通常会在容易出错的模型上加一句断言，把面数打印出来核对。

参数说明：NumModes对单模微带线给 1，多模波导按实际传播模式数给；RenormalizeAllTerminals打开后 S 参数会按归一化阻抗重新计算，做 50 欧系统时建议开；DoDeembed用来把端口面从结构边缘移开一段距离再做去嵌，只有当端口面无法直接放在结构端面时才用，用了之后必须给出准确的距离，否则误差比不去嵌还大。Impedance这个字段各家版本写法有差异，最保险的办法还是录一次脚本照抄。

LumpedPort 的核心区别在于它作用在一条"端口片"上，需要显式给积分线：

oModule.AssignLumpedPort({'NAME:Lump1', ... 'Objects:=', {'PortSheet'}, ... 'RenormalizeAllTerminals:=', true, ... 'Modes:=', {'NAME:Modes', 'NumModes:=', 1, ... 'Mode:=' , {'NAME:Mode1', 'ModeNum:=', 0, 'UseIntLine:=', true, ... 'IntLine:=', {'NAME:IntLine', ... 'Start:=', {'0mm', '0mm', '0mm'}, ... 'End:=', {'0mm', '0mm', '-1.6mm'}}, ... 'AlignmentGroup:=', 0, ... 'CharImp:="', 'Zpi', '"'}}, ... 'Attributes:=', {'NAME:Attributes', 'Objects:=', {'PortSheet'}}});

积分线从信号端指向参考地端，方向反了会得到一个符号翻转的 S21，幅度看着没变，相位全错。这是我早期翻车最多的一处，后来养成习惯：每建一个端口，先把模型切到端口面正视方向看一遍箭头再跑。

4.3 求解设置与扫频：收敛判据给多少才够

oModule = design.GetModule('AnalysisSetup'); oModule.InsertSetup('HfssDriven', {'NAME:Setup1', ... 'Frequency:=', '2.4GHz', ... 'MaxDeltaS:=', 0.02, ... 'MaximumPasses:=', 12, ... 'MinimumPasses:=', 2, ... 'MinimumConvergedPasses:=', 2, ... 'PercentRefinement:=', 30, ... 'BasisOrder:=', 1, ... 'DoLambdaRefine:=', true, ... 'DoMaterialLambda:=', true, ... 'TargetLambda:=', 0.3333}); oModule.InsertFrequencySweep('Setup1', {'NAME:Sweep1', ... 'IsEnabled:=', true, ... 'RangeType:=', 'LinearStep', ... 'RangeStart:=', '2GHz', 'RangeEnd:=', '3GHz', 'RangeStep:=', 0.02, ... 'Type:=', 'Interpolating', ... 'SaveFields:=', false, ... 'InterpTolerance:=', 0.5, ... 'InterpMaxSolns:=', 250, ... 'InterpMinSolns:=', 0, ... 'InterpMinSubranges:=', 1, ... 'ExtrapToDC:=', false}); design.Analyze('Setup1 : Sweep1'); % 名称必须是 "Setup : Sweep" 格式

逻辑说明：InsertSetup的块名HfssDriven对应驱动求解（模态或终端），本征模要用HfssEigen。Analyze的参数是个拼接字符串，格式固定为"设置名 + 空格 + 冒号 + 空格 + 扫频名"，写成Setup1只跑自适应不跑扫频，写成Setup1:Sweep1（少空格）直接报找不到对象。

参数说明：MaxDeltaS是相邻两次自适应网格之间 S 参数的最大变化量，0.02 是常用值，追求精度可以到 0.01，代价是网格量涨得快；MaximumPasses给 12 意味着最多迭代 12 次，如果 12 次还没收敛，说明模型里有尖锐结构或材料设置有问题，加大次数只是浪费机时，该去查模型；PercentRefinement控制每轮加密的网格比例，30% 是默认，结构简单时可以降到 20% 加速；TargetLambda与DoLambdaRefine配合，按介质内波长细化，对多层板结构比纯按几何细化靠谱得多。

扫频类型上，Interpolating用少量频点拟合出整条曲线，速度快，适合先粗看谐振位置；Discrete每个频点都真算，慢但准，最终出图前我会在关键频段（谐振点 ±200 MHz）用离散扫频再跑一遍核对。InterpTolerance给 0.5 是中等严格，遇到窄带高 Q 结构要收紧到 0.1 以下，否则插值会把谐振峰削平，看着像天线带宽很宽，实际是把两个靠得很近的谐振点糊成了一个。

4.4 把数据导出来：Touchstone 与报告文件

outDir = fullfile(pwd, 'results'); if ~exist(outDir, 'dir'), mkdir(outDir); end % 导出 Touchstone，2 表示端口数，50 是参考阻抗 design.ExportNetworkData('', {'Setup1 : Sweep1'}, 2, ... fullfile(outDir, 'patch_case01.s2p'), {'All'}, false, 50); % 报告方式导出：先建报告，再写文件 oReport = design.GetModule('ReportSetup'); oReport.CreateReport('S11_dB', 'Modal Solution Data', ... 'Rectangular Plot', 'Setup1 : Sweep1', ... {'Domain:=', 'Sweep'}, ... {'Freq:=', {'All'}, 'S(1,1):=', {'dB'}}, ... {'X Component:=', 'Freq'});

逻辑说明：ExportNetworkData的参数顺序在各版本之间有细微差别，位数、是否复数、参考阻抗的位置都可能不同，最省事的办法是手动导一次并录制脚本。导出的.s2p回到 MATLAB 侧可以直接被射频工具箱读成sparameters对象，绘图、算带宽、找谐振点都在 MATLAB 里做完，不用再回 HFSS 界面点。

参数说明：第二个参数必须是完整的'Setup1 : Sweep1'字符串数组，只给设置名会导出自适应最后一个频点的单点结果；倒数第二个参数是参考阻抗，微带 50 欧系统给 50，差分系统要注意 Touchstone 的端口顺序和极性约定，顺序搞反了差模和共模会对调，曲线看着"也有谐振"，但物理意义全错。

5. 避坑排查：五条让脚本半夜中断的血泪记录

下面这五条都是我在实际批量运行里踩出来的，按"现象 → 原因 → 解决"记录，能省你几个通宵。

5.1 第 37 个工况炸了：COM 报"服务器执行失败"

现象：前 36 个工况正常，第 37 个Analyze抛错0x80080005，之后每次调用都失败，任务管理器里hfss.exe还在，但界面无响应。

原因：前一个工况求解时端口设置有误，HFSS 内部抛异常，MATLAB 侧的 catch 没清理 COM 对象，工程和设计句柄一直悬着，许可证没释放。累积到一定数量后新实例起不来。

解决：所有 COM 对象用onCleanup兜底，顺序是design→project→app.Quit()，反了会报"对象仍在使用"。批量脚本外面再包一层，捕获异常后强制杀残留进程再继续。我现在固定写成：

function runCase(idx, param) app = []; cleanupObj = onCleanup(@() safeQuit(app)); % 无论怎么退出都执行 app = connectHfss(); % ... 建模、求解 ... end function safeQuit(app) try if ~isempty(app), app.Quit(); end catch % 已经退出或句柄失效，忽略 end end

5.2 建出来的盒子大了一千倍

现象：脚本跑通，打开模型一看，基板有 30 米长。

原因：SetModelUnits没生效或者调用顺序在建模之后；另一种情况是尺寸字符串写成'30'而不带单位，此时按设计默认单位解释，而设计是从一个英寸制的老工程继承来的。

解决：每个尺寸都显式带单位符，不依赖上下文；在建第一个几何之前调用SetModelUnits并把Rescale置false；建完立刻读回一次包围盒尺寸做断言，差超过 5% 就停下来报错，别让它跑到求解阶段。

5.3 脚本结果和手动建模差 6 dB

现象：同样的结构，脚本跑出来 S11 最低点 -18 dB，手动建的是 -12 dB，谐振频率也偏了 80 MHz。

原因：波端口的积分线方向反了。幅度上 S11 有可能看起来差不多，但相位错 180 度，和结构内部的反射叠加后整体偏移。

解决：不要靠数值反推，直接把模型切到端口面正面，看积分线箭头是否从信号导体指向参考地。批量脚本里我加了一步：导出端口信息并打印积分线起止坐标，和结构坐标做一次符号检查，方向不对直接中断。这一步花不到一秒，能省掉后面几十个工况白跑。

5.4 扫频曲线是折线，只有五个点

现象：导出的 Touchstone 里只有五个频点，画出来是折线，看不出谐振峰。

原因：RangeType给了LinearCount且RangeCount设得很小，或者用了Interpolating但SaveFields与导出设置冲突，导出时只导了自适应频点。

解决：确认扫频块里RangeType与步长参数匹配——LinearStep配RangeStep（单位 GHz），LinearCount配RangeCount（点数），Single配单个RangeStart。导出前先读一次扫频的点数，少于预期就报错。曲线上出现明显折角，基本可以断定是点数不够或者插值误差判据太松。

5.5 变量改了，结果一点没变

现象：循环里连续改了五次基板厚度，五次结果完全一致，小数点后六位都相同。

原因：ChangeProperty用了NewProps而不是ChangedProps。变量已经存在，NewProps试图新建同名变量，静默失败；也可能是变量名写错了一个字母，新建了一个没人引用的新变量。

解决：改动之后立刻读回值做断言——把变量当前值打印出来和期望值比对，不一致就中断。这个习惯我保持了两年，救回来的时间远超写这几行代码的成本。另外变量名统一用小写下划线，避免和内置量撞名。

6. 批量扫参与结果回收：把 40 个工况收成一张图的收尾技巧

单个工况跑通之后，剩下的就是循环。我的固定写法是先建一张参数表，一次建模，之后只改变量值，每个工况导出一个.s2p，最后统一读回来画图。

cases = struct('sub_h', {1.2, 1.4, 1.6, 1.8, 2.0}, ... 'feed_x', {-3, -2, -1, 0, 1, 2, 3}); results = struct('sub_h', {}, 'feed_x', {}, 'f_res', {}, 's11_min', {}); design = setupDesign(); % 建一次模型，变量已就位 for i = 1:numel(cases) setVar(design, 'sub_h', sprintf('%.2fmm', cases(i).sub_h)); setVar(design, 'feed_x', sprintf('%gmm', cases(i).feed_x)); design.Analyze('Setup1 : Sweep1'); f = fullfile('results', sprintf('c_%02d.s2p', i)); design.ExportNetworkData('', {'Setup1 : Sweep1'}, 1, f, {'All'}, false, 50); S = sparameters(f); % 回 MATLAB 解析 s11 = 20*log10(abs(squeeze(S.Parameters(1,1,:)))); [pk, idx] = min(s11); results(i).sub_h = cases(i).sub_h; results(i).feed_x = cases(i).feed_x; results(i).f_res = S.Frequencies(idx)/1e9; results(i).s11_min = pk; end

这段里最值得说的不是循环，而是验证。批量跑最怕的不是慢，是错得整齐——四十个工况全错，你还以为挖到规律了。所以我在每一批正式任务之前，固定先跑一个基准工况，把 S11 曲线和上一批的基准曲线叠在一起看，偏差超过 0.2 dB 就停下来查端口和单位，绝不往下跑。

再补一个判断结果可不可信的具体方法：同一个工况用两组不同的收敛判据各跑一次，MaxDeltaS分别取 0.02 和 0.005，如果两次的 S11 最低点差异小于 0.1 dB，说明网格已经收敛，这个数可以用；差异超过 0.5 dB，说明模型里有尖锐边角或者材料边界没对齐，加再多 pass 也只是在噪声里打转，该回去改几何了。这套"同工况双判据对照"我现在当成规矩，比看收敛曲线直观得多，也比盲目把MaximumPasses调到 20 省钱。

从那以后我每跑一批，都强制先走一遍基准对照加双判据验证，两个都过了才允许自己看结果，急也没用，省下的那十分钟最后都会变成两小时的返工。这套 hfssapi.pro 的 MATLAB 封装函数和示例脚本我放在资源包里，拿到之后别急着改自己的模型，先用它自带的例子跑通一遍连接、建模、求解、导出四个环节，确认通道没问题，再往里塞你的结构。希望帮到你。

本文还有配套的精品资源，点击获取