ZEMAX软件使用教程：在ZOS-API中执行系统分析的基本方法

光之友

本文讨论了如何在ZOS-API中使用命令进行分析，以及如何有效提取分析结果。

作者 Alexandra Culler

OpticStudio包含ZOS-API的大量帮助文档，您可以在编程选项卡 (Programming tab) 查找：

通过这些文档可以导航到 ZOSAPI.分析命名空间参考 (ZOSAPI.Analysis Namespace Reference) 找到所有分析命令的列举情况。

尽管对于某些特定分析有其特有的分析方法，但是常规方法New_Analysis() 可用于打开任何分析类型。此方法需要将分析的列举字符作为输入。在找到适当的列举情况后，您可以使用以下内容来进行分析：

my_analysis = TheSystem.Analyses.New_Analysis(ZOSAPI.Analysis.AnalysisIDM.ANALYSIS_ENUMERATOR_HERE);

打开后，通常有两种方式进行分析设置的调整。首先，一些常用分析具有特定分析的设置界面。一个典型示例是IAS_FftMtf。所有分析设置接口都位于ZOSAPI.分析设置命名空间 (ZOSAPI.Analysis.Settings Namespace) 中。 您还可以使用HasAnalysisSpecificSettings属性检查是否您的分析具有设置界面：

my_analysis.HasAnalysisSpecificSettings

如果命令返回“ 0”，则说明分析没有完备可用的设置接口。这意味着无法通过API进行分析设置，而必须通过第二个选项（即IAS_ModifySettings命令）进行更改，该命令直接修改用于分析的设置文件（.cfg文件）：

ModifySettings命令与ZPL中的MODIFYSETTINGS关键字的工作方式非常相似。当您打开分析并调整设置后，您需要重新运行分析并查阅结果。您可以使用以下命令进行操作：

my_analysis.ApplyAndWaitForCompletion()

my_analysis.GetResults()

如果您需要使用ModifySettings()，则还需要调用LoadFrom()（完整示例请查阅 API 语法示例文件11）。 对于由GetResults() 方法返回的对象，分析函数可能具有以下一种或多种可用的结果类型：

使用GetResults() 语法将返回一个列出了所有可能的公共成员函数 (Public Member Functions) 的对象，但是仅与您分析相关的数据项会被填充。如果不确定您需要用于分析的数据类型，并想在开始之前进行了解，请查看知识库文章“生成ZOS-API中各个分析的输出数据类型列表”。

对于支持文本输出的分析类型，还可以使用GetTextFile()命令，以便用户可以保存并手动分析其数据。

关于API的更多信息，请参见知识库文章“ZOS-API.NET:概述”。

ZOS-API语法帮助(ZOS-API Syntax Help)包含示例文件，这些文件演示了如何使用ZOS-API对系统进行分析。

例如，示例代码11和15使用IAS_ModifySettings修改分析的设置。

• 示例11修改了通用绘图(Universal Plot)的设置。
• 示例15修改了实体模型(Shaded Model)的设置。
  & K3 J( ?, b" j

示例代码10和24全面修改了设置。

• 示例10和24修改了探测器查看器(Detector Viewer)的设置。
  

Ansys Zemax国内可靠代理商

( q4 ~" D) n0 a, t
　　光研科技南京有限公司是国内可靠的光学软件和仪器光电供应商，提供企业定制化上门培训服务，承接各类光学设计项目，并有一系列自主编写出版的光学设计书籍。公司拥有一支高素质、高水平、实战经验丰富的管理，销售以及研发团队，从成立到现在已经为广大企业，研究所以及高校提供了很多优秀的产品和服务，是光电圈内值得信赖的企业。追光逐梦，研以致用！以用户的需求为起点，为客户提供有价值的光学产品和服务一直都是光研科技南京有限公司的宗旨。

1 c8 T0 R8 _( T7 {

　　AnsysZemax光学软件咨询与订购联系方式

6 X% C, F; m/ p0 I1 {9 p       联系人：南京光研   徐保平
$ P) t7 z2 D3 j0 a0 x2 [
# g: H2 h6 p+ s# u& p　　手机号：15051861513

　　微信号：13627124798

       您也可以扫一扫下面的二维码直接咨询