ZEMAX教程:在ZOS-API中执行系统分析的基础方法

本文讨论了如何在ZOS-API中使用命令进行分析,以及如何有效提取分析结果。作者 Alexandra CullerOpticStudio包含ZOS-API的大量帮助文档,您可以在编程选项卡 (Programming tab) 查找:ZEMAX软件使用教程:在ZOS-API中执行系统分析的基本方法的图1



通过这些文档可以导航到 ZOSAPI.分析命名空间参考 (ZOSAPI.Analysis Namespace Reference) 找到所有分析命令的列举情况。ZEMAX软件使用教程:在ZOS-API中执行系统分析的基本方法的图2

尽管对于某些特定分析有其特有的分析方法,但是常规方法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文件):ZEMAX软件使用教程:在ZOS-API中执行系统分析的基本方法的图3


ModifySettings命令与ZPL中的MODIFYSETTINGS关键字的工作方式非常相似。当您打开分析并调整设置后,您需要重新运行分析并查阅结果。您可以使用以下命令进行操作:my_analysis.ApplyAndWaitForCompletion()my_analysis.GetResults()如果您需要使用ModifySettings(),则还需要调用LoadFrom()(完整示例请查阅 API 语法示例文件11)。 对于由GetResults() 方法返回的对象,分析函数可能具有以下一种或多种可用的结果类型:ZEMAX软件使用教程:在ZOS-API中执行系统分析的基本方法的图4

使用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)的设置。


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

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

免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删

QR Code
微信扫一扫,欢迎咨询~

联系我们
武汉格发信息技术有限公司
湖北省武汉市经开区科技园西路6号103孵化器
电话:155-2731-8020 座机:027-59821821
邮件:tanzw@gofarlic.com
Copyright © 2023 Gofarsoft Co.,Ltd. 保留所有权利
遇到许可问题?该如何解决!?
评估许可证实际采购量? 
不清楚软件许可证使用数据? 
收到软件厂商律师函!?  
想要少购买点许可证,节省费用? 
收到软件厂商侵权通告!?  
有正版license,但许可证不够用,需要新购? 
联系方式 155-2731-8020
预留信息,一起解决您的问题
* 姓名:
* 手机:

* 公司名称:

姓名不为空

手机不正确

公司不为空