本文討論了如何在 ZOS-API 中使用命令進(jìn)行分析，以及如何有效提取分析結(jié)果。

OpticStudio 包含 ZOS-API 的大量幫助文檔，您可以在編程選項(xiàng)卡 (Programming tab) 查找：

通過(guò)這些文檔可以導(dǎo)航到 ZOSAPI.分析命名空間參考 (ZOSAPI.Analysis Namespace Reference) 找到所有分析命令的列舉情況。

盡管對(duì)于某些特定分析有其特有的分析方法，但是常規(guī)方法 New_Analysis() 可用于打開任何分析類型。此方法需要將分析的列舉字符作為輸入。在找到適當(dāng)?shù)牧信e情況后，您可以使用以下內(nèi)容來(lái)進(jìn)行分析：

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

打開后，通常有兩種方式進(jìn)行分析設(shè)置的調(diào)整。首先，一些常用分析具有特定分析的設(shè)置界面。一個(gè)典型示例是 IAS_FftMtf 。所有分析設(shè)置接口都位于 ZOSAPI. 分析設(shè)置命名空間 (ZOSAPI.Analysis.Settings Namespace) 中。您還可以使用HasAnalysisSpecificSettings 屬性檢查是否您的分析具有設(shè)置界面：

my_analysis.HasAnalysisSpecificSettings

如果命令返回“ 0”，則說(shuō)明分析沒有完備可用的設(shè)置接口。這意味著無(wú)法通過(guò) API 進(jìn)行分析設(shè)置，而必須通過(guò)第二個(gè)選項(xiàng)（即 IAS_ModifySettings 命令）進(jìn)行更改，該命令直接修改用于分析的設(shè)置文件（ .cfg 文件）：

ModifySettings 命令與 ZPL 中的 MODIFYSETTINGS 關(guān)鍵字的工作方式非常相似。當(dāng)您打開分析并調(diào)整設(shè)置后，您需要重新運(yùn)行分析并查閱結(jié)果。您可以使用以下命令進(jìn)行操作：

my_analysis.ApplyAndWaitForCompletion()

my_analysis.GetResults()

如果您需要使用 ModifySettings()，則還需要調(diào)用 LoadFrom()（完整示例請(qǐng)查閱 API 語(yǔ)法示例文件11）。對(duì)于由 GetResults() 方法返回的對(duì)象，分析函數(shù)可能具有以下一種或多種可用的結(jié)果類型：

使用 GetResults() 語(yǔ)法將返回一個(gè)列出了所有可能的公共成員函數(shù) (Public Member Functions) 的對(duì)象，但是僅與您分析相關(guān)的數(shù)據(jù)項(xiàng)會(huì)被填充。

對(duì)于支持文本輸出的分析類型，還可以使用 GetTextFile() 命令，以便用戶可以保存并手動(dòng)分析其數(shù)據(jù)。

ZOS-API 語(yǔ)法幫助 (ZOS-API Syntax Help) 包含示例文件，這些文件演示了如何使用ZOS-API 對(duì)系統(tǒng)進(jìn)行分析。

例如，示例代碼11和15使用 IAS_ModifySettings 修改分析的設(shè)置。

· 示例11修改了通用繪圖 (Universal Plot) 的設(shè)置。
· 示例15修改了實(shí)體模型 (Shaded Model) 的設(shè)置。
· 示例代碼10和24全面修改了設(shè)置。
· 示例10和24修改了探測(cè)器查看器 (Detector Viewer) 的設(shè)置。