Updated: May 23, 2024
Current Release: V1.0.1.1

Authored By: Ethan Keeler

Downloads

Converter Download
Note: This extension is only available for the Ansys version of OpticStudio.

Beta Notice

This extension is currently in beta release. There may be unexpected bugs or errors, and we encourage you to double check any converted designs. If you have any feedback or information to share with us about your conversions, please contact us at zemax.support@ansys.com. We would also be more than happy to review the Conversion Report with you to help you understand issues with the conversion. Please feel free to share this report (and if possible, the SEQ file) so that we can better understand any failures or limitations.

Introduction

OpticStudio provides an extension for importing CODE V designs. This extension is meant to replace and improve upon the legacy ZPL macro (CodeV to OpticStudio Converter.ZPL). To import a CODE V design, it must be saved as a text-based SEQ file. By reading the CODE V commands, line-by-line, the converter can recreate the design dynamically within OpticStudio. The extension also offers an interface to directly enter the commands, one-by-one, to build or modify a design. It is important to note that not all CODE V commands and capabilities are fully supported by the converter; we are continually improving the tool, but there are some limitations, and converted designs should be validated.

Downloading and installing the extension

You can download the Converter as a ZIP folder attached to this article. To install it, first close OpticStudio. Then simply extract the files in the attached ZIP into your Documents\Zemax\ZOS-API\Extensions folder. Make sure that the executable (‘CODE V Converter.exe’) is at the top level of this folder. Once you open OpticStudio, you will see the CODE V Converter as an option on the User Extension list.

Process to convert a design

After exporting the CODE V design to a text-based SEQ file, you can access the extension on the Programming tab in OpticStudio:

After opening the extension, you will see the main GUI interface. To complete a conversion, simply navigate to the SEQ file and click Convert System. There are a few options available for the conversion:

• The extension of the conversion now has a more detailed and formatted output HTML file. If Show Summary is checked, the HTML summary will open automatically when the conversion completes.
• The Real-time Updates option will show changes in OpticStudio as the conversion executes. If this option is left unchecked, the imported system will be revealed after the conversion completes.
• Normally during a conversion, the current system in OpticStudio will be deleted, and the SEQ commands will create a new system. However, if you have created an SEQ file with commands that you want to modify the current system (without first deleting it), then Append Commands will make changes to the current system.

Once the conversion has completed, the tool will create a rich-text Conversion Report (shown below) as an HTML file output. In this report, it shows information about the conversion, as well as the errors and warnings logged during execution. At the start of the report, there is also a summary indicating metrics, including how many commands failed or the number of commands that were unrecognized.

Command line tool

If you would like to enter commands one-by-one to dynamically change the system, you can instead click the Command Line button. You will then see a command line GUI open. Here you can enter the commands and see how they affect the system. You will also see messages or errors listed in the Command History.

Appendix

Current list of supported commands

The following table shows the commands currently supported by the converter. Please note that even though the command is listed as supported, there may be command parameters or cases which are not supported. If you wish to share information with us about how a command should import or errors that you receive, please contact Zemax support at zemax.support@ansys.com.