CST宏帮助文档格式.docx
《CST宏帮助文档格式.docx》由会员分享，可在线阅读，更多相关《CST宏帮助文档格式.docx（18页珍藏版）》请在冰豆网上搜索。
），Setppt=CreateObject（"
PowerPoint.Application"
）脚本访问相应外部对象（Word和PPT或者其他）。
以下代码段显示了如何从使用VBA的外部程序启动和控制CSTMICROWAVESTUDIO：
SubMain（）
DimstudioAsObject
Setstudio=CreateObject（"
CSTStudio.Application"
）
DimmwsAsObject
Setmws=studio.NewMWS
DimbrickAsObject
Setbrick=mws.brick
brick.Name"
brick"
brick.Xrange0,1
brick.Yrange0,1
brick.Zrange0,1
brick.Create
mws.SaveAs"
C:
\temp\test.cst"
False
mws.Quit
Setstudio=Nothing
EndSub
通过使用With-EndWith块可以简化对象方法的访问，如下面的示例所示：
Withstudio.NewMWS
With.Brick
.Name"
.Xrange0,1
.Yrange0,1
.Zrange0,1
.Create
EndWith
.SaveAs"
.Quit
文件操作
从VBA脚本访问文件相当简单。
打开用于读取或写入的文件后，可以为其分配编号的流，然后可以使用该流来访问该文件。
这在下面的例子中显示：
DimslineasString
Open"
mydata.txt"
ForInputAs#1
WhileNotEOF
（1）
LineInput#1,sline
Debug.Printsline
Wend
Close#1
ForOutputAs#2
Print#2,"
TestOutput"
Close#2
ForAppendAs#3
Print#3,"
TestOutput2"
Close#3
HowtousetheVBAObjects
从外部程序中调用CST
以下示例代码可以在外部应用程序（如电子表格或字处理器）的VBA解释器中输入。
它创建一个CSTSTUDIOSUITE应用程序对象，打开一个项目并创建一个砖块：
'
Starts
CSTSTUDIOSUITE
DimprojAsObject
Setproj=studio.NewMWS
Setbrick=proj.brick
brick.Reset
BrickOne"
brick.Xrange"
0"
"
1"
brick.Yrange"
2"
brick.Zrange"
4"
proj.SaveAs"
proj.Quit
打开内置VBA解释器中的项目
此示例从内置VBA解释器打开项目：
OpenFile（"
c:
\Examples\thebrick.cst"
WithBrick
.Reset
.Layer"
default"
.Xrange"
.Yrange"
.Zrange"
FarfieldArrayObject
基于单个天线元素定义远场图的天线阵列模式。
.
Methods
Reset
将所有内部设置重置为其初始值。
UseArray（
bool
bFlag
激活远场计算的数组模式。
Arraytype（
enum
type
设置阵列模式的类型。
type可以具有以下值之一：
”rectangular”
可以使用方法XSet，YSet和ZSet通过设置相应的天线编号以及空间和相移信息来定义矩形阵列图案（线性：
1D，平面：
2D，立方体：
3D）。
然后通过SetList计算结果列表。
如果晶胞或周期性边界有效，阵列设置自动使用晶胞几何和定相。
”edit”
此模式通过使用方法天线将单个天线元素添加到列表中来编辑当前天线。
XSet（
int
number,
double
spaceshift,
phaseshift
YSet（
ZSet（
在x，y或z方向分别定义线性阵列模式。
因此，可以创建线性，平面或立方体天线阵列结构。
number
单个天线单元在x，y或z方向上的数量
spaceshift
在x，y或z方向上的两个单个天线元件之间的恒定空间移位
phaseshift
在x，y或z方向上的两个单个天线元件之间的恒定相移
SetList
根据指定的阵列配置计算单个天线元件的完整列表，并将这些设置传输到farfield绘图仪。
DeleteList
删除定义阵列模式的单个天线元素的当前列表。
Antenna（
x,
y,
z,
amplitude,
phase
定义单个天线元件的属性。
此方法仅适用于由Arraytype设置的编辑模式。
x
空间中单个天线元件的x位
y
空间中单个天线元件的y位置
z
空间中单个天线元件的z位置
amplitude
单个天线元件的振幅值
phase
单个天线元件的相位值
AddAntennaItem（
sfile,
alpha,
beta,
gamma,
A,
phase）
从sfile加载天线farfield并将其添加到组合列表。
AddAntennaItemA（
z1,
z2,
z3,
x1,
x2,
x3,
该命令类似于AddAntennaItem，但方向由天线框架z轴和x轴在全局坐标中指定。
下表总结了天线参数：
x,y,z
天线在空间中的位置
alpha,beta,gamma
欧拉角中天线的方向
z1,z2,z3
天线框架在全局坐标系中的z轴
x1,x2,x3
天线框架在全局坐标系中的x轴
A
天线发射的幅度
Phase
天线发射的相位
ClearAntennaItems
清除天线组合列表。
SetNormalizeAntennas（
bflag
在执行组合命令之前，激活所有天线的归一化到1W（峰值）激励功率。
用户指定的幅度应用于缩放的远场。
SetCombineFrequency（
frequency
设置组合天线的频率。
组合列表中的所有天线必须具有相同的频率，否则天线的一致组合是不可能的。
SetCombineReferenceAxes（
x3
设置组合天线的theta参考轴（z1，z2，z3）和phi参考轴（x1，x2，x3）。
SetCombineReferenceOrigin（
p1,
p2,
p3
设置组合天线的相位参考原点（p1，p2，p3）。
ExecuteCombine（
stepInDegree
将组合列表中的所有天线合并到单个天线。
新的天线数据通过stepInDegree采样并写入sfile。
不对组合字段应用进一步的缩放。
Queries（查询）
GetCombinePowerRatio
double
返回实际发射功率与来自组合列表的所有天线的集成输入功率的比率。
与单位的强偏差表示天线的不可忽略的相互作用。
DefaultSettings
UseArray（False）
Arraytype（"
rectangular"
XSet（1,0.0,0.0）
YSet（1,0.0,0.0）
ZSet（1,0.0,0.0）
SetCombineFrequency（-1.0）
SetCombineReferenceAxes（0,0,1,1,0,0）
SetCombineReferenceOrigin（0,0,0）
SetNormalizeAntennas（True）
Example
Thefirstexampledefinesalinearanten
升级会员 