CST宏帮助.docx

1、CST宏帮助变量定义Dim s As String （字符串）Dim d As Double （双精度）Dim i As Integer （整数）Dim j As Long （长数据）也可以用字符来代替数据类型，分别对应如下：Dim s As StringDim s $Dim d As DoubleDim d #Dim i As IntegerDim I %Dim j As LongDim j &语言StoreParameter（“width”，20）%更改参数MsgBox CStr（d1）%数据类型转换。这里函数CStr（）用于将给定的参数转换为字符串数据类型（Convert into St

2、ring）。另一个相当常见的转换函数是CDbl（）。Evaluate（），将数据转换为双精度类型Set word = CreateObject(Word.Application)，Set ppt = CreateObject(PowerPoint.Application)脚本访问相应外部对象（Word和PPT或者其他）。以下代码段显示了如何从使用VBA的外部程序启动和控制CST MICROWAVE STUDIO：Sub Main()Dim studio As ObjectSet studio = CreateObject(CSTStudio.Application)Dim mws As Obj

3、ectSet mws = studio.NewMWSDim brick As ObjectSet brick = mws.brickbrick.Name brickbrick.Xrange 0, 1brick.Yrange 0, 1brick.Zrange 0, 1brick.Createmws.SaveAs C:temptest.cst, Falsemws.QuitSet studio = NothingEnd Sub通过使用With-End With块可以简化对象方法的访问，如下面的示例所示：Sub Main()Dim studio As ObjectSet studio = Create

4、Object(CSTStudio.Application)With studio.NewMWSWith .Brick.Name brick.Xrange 0, 1.Yrange 0, 1.Zrange 0, 1.CreateEnd With.SaveAs C:temptest.cst, False.QuitEnd WithSet studio = NothingEnd Sub文件操作从VBA脚本访问文件相当简单。 打开用于读取或写入的文件后，可以为其分配编号的流，然后可以使用该流来访问该文件。 这在下面的例子中显示：Dim sline as StringOpen mydata.txt For

5、Input As #1While Not EOF(1)Line Input #1,slineDebug.Print slineWendClose #1Open mydata.txt For Output As #2Print #2, Test OutputClose #2Open mydata.txt For Append As #3Print #3, Test Output 2Close #3How to use the VBA Objects从外部程序中调用CST以下示例代码可以在外部应用程序（如电子表格或字处理器）的VBA解释器中输入。 它创建一个CST STUDIO SUITE应用程序

6、对象，打开一个项目并创建一个砖块：Sub Main()Dim studio As ObjectStartsCST STUDIO SUITESet studio = CreateObject(CSTStudio.Application)Dim proj As ObjectSet proj = studio.NewMWSDim brick As ObjectSet brick = proj.brickbrick.Resetbrick.Name BrickOnebrick.Xrange 0, 1brick.Yrange 0, 2brick.Zrange 0, 4brick.Createproj.Sa

7、veAs C:temptest.cst, Falseproj.QuitSet studio = NothingEnd Sub打开内置VBA解释器中的项目此示例从内置VBA解释器打开项目：OpenFile(c:Examplesthebrick.cst)With Brick.Reset.Name BrickOne.Layer default.Xrange 0, 1.Yrange 0, 2.Zrange 0, 4.CreateEnd WithFarfieldArray Object基于单个天线元素定义远场图的天线阵列模式。.MethodsReset将所有内部设置重置为其初始值。UseArray (b

8、oolbFlag)激活远场计算的数组模式。Arraytype (enumtype)设置阵列模式的类型。type可以具有以下值之一：”rectangular”可以使用方法XSet，YSet和ZSet通过设置相应的天线编号以及空间和相移信息来定义矩形阵列图案（线性：1D，平面：2D，立方体：3D）。 然后通过SetList计算结果列表。 如果晶胞或周期性边界有效，阵列设置自动使用晶胞几何和定相。”edit”此模式通过使用方法天线将单个天线元素添加到列表中来编辑当前天线。XSet (intnumber,doublespaceshift,doublephaseshift)YSet (intnumber

9、,doublespaceshift,doublephaseshift)ZSet (intnumber,doublespaceshift,doublephaseshift)在x，y或z方向分别定义线性阵列模式。 因此，可以创建线性，平面或立方体天线阵列结构。number单个天线单元在x，y或z方向上的数量spaceshift在x，y或z方向上的两个单个天线元件之间的恒定空间移位phaseshift在x，y或z方向上的两个单个天线元件之间的恒定相移SetList根据指定的阵列配置计算单个天线元件的完整列表，并将这些设置传输到farfield绘图仪。DeleteList删除定义阵列模式的单个天线元素

10、的当前列表。Antenna (doublex,doubley,doublez,doubleamplitude,doublephase)定义单个天线元件的属性。 此方法仅适用于由Arraytype设置的编辑模式。x空间中单个天线元件的x位y空间中单个天线元件的y位置z空间中单个天线元件的z位置amplitude单个天线元件的振幅值phase单个天线元件的相位值AddAntennaItem (sfile,doublex,doubley,doublez,doublealpha,doublebeta,doublegamma,doubleA,doublephase)从sfile加载天线farfield并

11、将其添加到组合列表。AddAntennaItemA (sfile,doublex,doubley,doublez,doublez1,doublez2,doublez3,doublex1,doublex2,doublex3,doubleA,doublephase)该命令类似于AddAntennaItem，但方向由天线框架z轴和x轴在全局坐标中指定。下表总结了天线参数：x, y, z天线在空间中的位置alpha, beta, gamma欧拉角中天线的方向z1, z2, z3天线框架在全局坐标系中的z轴x1, x2, x3天线框架在全局坐标系中的x轴A天线发射的幅度Phase天线发射的相位Clear

12、AntennaItems清除天线组合列表。SetNormalizeAntennas (boolbflag)在执行组合命令之前，激活所有天线的归一化到1 W（峰值）激励功率。用户指定的幅度应用于缩放的远场。SetCombineFrequency (doublefrequency)设置组合天线的频率。组合列表中的所有天线必须具有相同的频率，否则天线的一致组合是不可能的。SetCombineReferenceAxes (doublez1,doublez2,doublez3,doublex1,doublex2,doublex3)设置组合天线的theta参考轴（z1，z2，z3）和phi参考轴（x1，x

13、2，x3）。SetCombineReferenceOrigin (doublep1,doublep2,doublep3)设置组合天线的相位参考原点（p1，p2，p3）。ExecuteCombine (sfile,doublestepInDegree)将组合列表中的所有天线合并到单个天线。新的天线数据通过stepInDegree采样并写入sfile。不对组合字段应用进一步的缩放。Queries（查询）GetCombinePowerRatiodouble返回实际发射功率与来自组合列表的所有天线的集成输入功率的比率。与单位的强偏差表示天线的不可忽略的相互作用。Default SettingsUseA

14、rray (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)ExampleThe first example defines a linear antenna array:With FarfieldArray.Reset.

15、UseArray (True).Arraytype (rectangular).ZSet (2, 2.5, 90).SetList.Arraytype (edit).Antenna (0, 0, 0, 1.0, 0.0)End WithThe second example combines two antennas with different orientation and position:With FarfieldArrayResultPath = GetProjectPath(Result) Assume that the farfield files are in the resul

16、t folder.ClearAntennaItems().SetCombineFrequency(100.0).AddAntennaItem(ResultPath + farfield_1.ffp, 0.0, -1.0, 0.0, 0, 0, 30.0, 1.0, 90.0).AddAntennaItem(ResultPath + farfield_2.ffp, 0.0, 1.0, 0.0, 0, -30, 0.0, 1.0, 0.0).ExecuteCombine(ResultPath + combined_ff.ffp, 5.0) Store the combined antenna in

17、 the result folderMsgBox Actual Power / Power Sum = & .GetCombinePowerRatio()End WithThe third example combines antennas to a finite-size array of unit cells with seven times seven elements:With FarfieldArray.SetCombineFrequency(100.0).SetNormalizeAntennas(False).SetUnitCellArray(farfield_1.ffp, 7,

18、7).ExecuteCombine(combined_ff.ffp, 5.0)End WithThe forth example sets the farfield origin:NewOriginX = -100NewOriginY = 300NewOriginZ = 400Frequency = 30.0MonitorName = farfield (f=30)With FarfieldArrayResultPath = GetProjectPath(Result).ClearAntennaItems().SetCombineFrequency(Frequency).AddAntennaI

19、temA(ResultPath + MonitorName + 2D_1.ffp, 0,0,0, 0,0,1,1,0,0, 1, 0).SetCombineReferenceOrigin ( NewOriginX, NewOriginY ,NewOriginZ ).ExecuteCombine(ResultPath + MovedOrigin.ffp, 1.0)End With Add to result treeWith ResultTree.Name FarfieldsMovedOrigin. + MovedOrigin.ffp.Type Farfield.AddEnd WithCATIA

20、 ObjectImport CATIA V4 and CATIA V5 files.MethodsReset将导入选项重置为默认。 ()设置导入文件名。CatiaVersion (intversion)设置文件catia版本。版本4和5是有效 的选项。Version (doubleversion)设置导入过滤器的版本，因为导入过程可能会随版本而略有变化。此设置可用于向后兼容性原因，并应确保导入的更高版本可以准确再现早期版本的行为。导入的最新版本为10.0。Id (intid)CAD文件可以多次导入具有不同导入选项设置的同一项目。为了提高结构重建的性能，在导入过程中存储中间sat文件，这允许在重

21、建期间快速重新读取数据，以防原始CAD文件未被修改。中间sat文件的命名约定对于每个单独的导入步骤必须是唯一的。因此，如果同一文件被多次导入或者同名文件导入到项目中，则需要增加Id设置。然后将该ID合并到文件名中，以确保每次导入的唯一文件名Healing (boolswitch)如果设置为True，则在导入期间，未对齐的顶点或边缘将被修复。ScaleToUnit (boolswitch)如果设置为True，导入的模型将缩放到当前设置单位。如果未设置，则导入功能使用源单位。在这种情况下，不发生缩放。ImportToActiveCoordinateSystem (boolswitch)相对于活动坐

22、标系导入CAD数据。Curves (boolswitch)标识是否应将曲线作为曲线或实体导入。ImportAttributes (boolswitch)标识是否应从导入文件中读取实体名称，材料名称和材料颜色等属性。 仅与CATIA 5导入文件组合使用。ImportCurveAttributes (boolswitch)标识是否应从导入文件中读取诸如曲线名称的属性。 仅与CATIA 5导入文件组合使用。Read开始导入文件。Default Settings ()Version (4)Healing (True)ImportToActiveCoordinateSystem (False)Impor

23、tCurves (True)ImportAttributes (True)ExampleWith CATIA.Reset. (.example.model).Healing (True).ImportToActiveCoordinateSystem (False).ImportCurves (True).ImportAttributes (True).Read End WithAsymptoticSolver Object此对象控制渐近高频解算器。使用“start”命令运行解算器。.Asymptotic Solver GeneralSetSolverType (enumSBR, SBR_RAY

24、TUBEStype)此选择指定求解程序是使用独立光线（SBR）还是使用射线管（SBR_RAYTUBES）。独立射线通常对于复杂几何形状更加强劲，但是对于大的和相对平滑的物体，射线管解算器的性能在较高频率下更好。SetSolverMode (enumMONOSTATIC_SCATTERING, BISTATIC_SCATTERING,FIELD_SOURCES,RANGE_PROFILEStype)此选择指定求解程序是以单站或双站，场源或范围轮廓模式运行。对于单站计算，观察角度与激发角度相同。因此，对于这种模式，只需要规定观测角扫描。对于双站计算，激发角和观察角不需要相同。因此，当解算器用于双基

25、模式时，需要定义附加的激励角扫描。对于场源计算，不需要入射平面波，因此观察角扫描的定义是足够的。范围轮廓模式使用与单静态模式类似的观察角定义，但仅支持单点或单角扫描。在单个观察点定义的情况下，计算一维范围轮廓，而对于二维扫面定义，将产生正弦图（范围对角度）。SetAccuracyLevel (enumLOW, MEDIUM, HIGH, CUSTOMtype)此设置允许您从预定义的精度配置中选择，如低，中或高。低精度意味着模拟设置将针对快速模拟进行优化，而高精度意味着为获得非常精确的结果。通常，中精度默认值提供了精度和模拟速度之间的良好折衷。除了这些默认配置，您还可以选择自定义，它允许通过使用

26、详细的求解器控制选项指定更详细的求解器选项。ResetPolarizations重置当前激励极化列表。AddHorizontalPolarization (doublevalue)此方法允许您向激励列表中添加新的水平极化平面波。以V / m为平面波电场矢量的振幅大小。AddVerticalPolarization (doublevalue)此方法允许您向激励列表中添加新的垂直极化平面波。以V / m为平面波电场矢量的振幅大小。AddLHCPolarization (doublevalue)此方法允许您向激励列表中添加新的左旋圆极化平面波。以V / m为平面波电场矢量的振幅大小。AddRHCPo

27、larization (doublevalue)此方法允许您向激励列表中添加新的右旋圆极化平面波。以V / m为平面波电场矢量的振幅大小。AddCustomPolarization(doubleethetare,doubleethetaim,doubleephire,doubleephiim)此方法允许您将新的自定义极化添加到激励列表。以V / m为平面波电场矢量的振幅大小。SetSolverMaximumNumberOfReflections (intvalue)此参数指定将被用于光线跟踪计算的光线反射的最大数量。StorePOResults (boolflag )此选项控制除了包括所有多重

28、反射和衍射效应的总远场之外是否计算一阶PO远场。比较两组结果可用于检查高阶效应对解的影响。此选项仅适用于单站和双站模式SetSolverRangePro (doublevalue)此方法允许您指定频率是范围和正弦图计算的中心频率。请注意，此设置仅对范围配置的计算模式有效。SetSolverRangePro (boolflag)此方法允许您指定是否自动确定范围扩展或带宽设置，或者采用相应方法设置的值是否被taken。请注意，此设置仅范围配置的计算模式有效。SetSolverRangePro (intvalue)此方法允许您指定范围或正弦图计算的光谱采样数。该值需要大于2的幂或者等于16。请注意，此设置仅对范围配置的计算模式有效。SetSolverRangePro (enumRECTANGULAR, HANNING, HAMMING, BLACKMANtype)此方法允许您指定用于计算范围配置或正弦图的谱窗函数。请注意，此设置仅对范围配置计算模式有效。.SetSolverRangePro (enumRANGE_EXTEND, BANDWIDTHtype)此方法允许您指定是通过指定最大