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文件并点击转换系统。转换过程中有几个选项可供选择：
-
转换扩展现在提供了更详细和格式化的输出HTML文件。如果勾选了“Show Summary”,则转换完成后HTML摘要将自动打开。
-
如果您勾选“Real-Time Updates”选项将在转换执行过程中实时显示OpticStudio中的变化。如果未勾选此选项，则转换完成后才会显示导入的系统。
-
通常在转换过程中，OpticStudio中的当前系统会被删除，SEQ命令将创建一个新系统。但是，如果您有一个SEQ文件，其中的命令您想要修改当前系统（而不是先删除它），那么勾选“Import to Current Design”选项将对当前系统进行修改。
-
“自动关闭”选项将在转换成功完成后自动关闭转换器。
转换完成后，工具将生成一个详细的转换报告（如下所示），作为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命令行(或使用列出的参数)打开该工具，它会在转换完成后自动关闭。每次转换都会报告其进度，并会提示您转换是成功还是失败，如屏幕截图所示。
附录
当前支持的命令列表
下表显示了转换器当前支持的命令。请注意，即使该命令被列为支持，也可能有不支持的命令参数情况也可能有命令参数或情况不受支持。如果您希望与我们分享有关如何导入命令或您收到的错误的信息，请联系我们工作人员。
