Ansys Zemax | 将CODE V设计导入OpticStudio

附件下载

联系工作人员获取附件

介绍

OpticStudio提供了一个用于导入CODE V设计的扩展工具。这个扩展旨在取代和改进传统的ZPL宏（CodeV to OpticStudio Converter.ZPL）。若要导入一个CODE V设计，必须将其保存为基于文本的SEQ文件。通过逐行读取CODE V命令，转换器可以在OpticStudio中动态重建设计。该扩展还提供了一个界面，可以一个接一个地直接输入命令来构建或修改设计。需要注意的是，并非所有CODE V命令和功能都完全支持这个扩展。

安装扩展

安装前，请先关闭OpticStudio。然后将附件中的文件解压到\Zemax\ZOS-API\Extensions中。确保CODEV Converter.exe 位于该文件夹的根目录。启动OpticStudio后，您将在用户扩展列表中看到CODE V转换器。

转换设计的过程

将CODE V设计导出为文本格式的SEQ文件后，您可以在OpticStudio的“编程”选项卡上访问该扩展工具:

打开扩展后，您将看到主界面。要完成转换，只需导航到SEQ文件并点击转换系统。转换过程中有几个选项可供选择：

1.转换扩展现在提供了更详细和格式化的输出HTML文件。如果勾选了“Show Summary”,则转换完成后HTML摘要将自动打开。

2.如果您勾选“Real-Time Updates”选项将在转换执行过程中实时显示OpticStudio中的变化。如果未勾选此选项，则转换完成后才会显示导入的系统。

3.通常在转换过程中，OpticStudio中的当前系统会被删除，SEQ命令将创建一个新系统。但是，如果您有一个SEQ文件，其中的命令您想要修改当前系统（而不是先删除它），那么勾选“Import to Current Design”选项将对当前系统进行修改。

4.“自动关闭”选项将在转换成功完成后自动关闭转换器。

转换完成后，工具将生成一个详细的转换报告（如下所示），作为HTML文件输出。报告中显示了转换信息以及执行过程中记录的错误和警告。报告开头还有一个摘要，包括失败命令的数量或未识别命令的数量等指标。

批处理SEQ文件处理

集成的用户扩展包括批处理功能，可以一次转换多个SEQ文件。这也可以显著快于作为用户扩展运行，因为它不需要与OpticStudio GUI交互。要使用此功能，您需要从OpticStudio外部调用它。有两种模式的选项：

1、运行CODE V Converter.exe，一旦您运行应用程序，您将看到一个弹出窗口，要求您导航到单个SEQ文件或目录。要切换转换单个SEQ文件或目录，只需取消勾选/勾选“Directory of Files”选项。

2、使用Windows命令行，您可以将转换器作为自动化脚本的一部分来调用。转换器最多接受三个参数。第一个参数必须始终是"-convert "，后面跟着SEQ文件(带完整路径)或包含多个要转换的SEQ文件的目录路径。最后，如果您的计算机上安装了多个版本，最后一个可选参数可以指定您要使用的OpticStudio版本的Program Files目录。

“CODE V Converter.exe” -converter [file/folder path] [optional: OpticStudio path]

以下是一些使用示例：

“CODE V Converter.exe” -converter "C:\CODE V Files\test.seq”
“CODE V Converter.exe” -converter "C:\CODE V Files”
“CODE V Converter.exe” -converter "C:\CODE V Files” “C:\Program Files\Ansys Zemax OpticStudio 2024 R2.02”

转换后的文件(连同摘要报告)将保存在与SEQ文件相同的目录中。如果从Windows命令行(或使用列出的参数)打开该工具，它会在转换完成后自动关闭。每次转换都会报告其进度，并会提示您转换是成功还是失败，如屏幕截图所示。