CODE Vの設計をOpticStudioへインポート

Also available in English

Updated: October 18, 2024
Current Release: V1.0.2.3

Authored By: Ethan Keeler

ダウンロード

コンバーターのダウンロード
注意：この拡張機能は、OpticStudioのAnsysバージョンでのみ利用できます。

ベータ版に関するお知らせ

この拡張機能は現在ベータ版です。予期しないバグやエラーが発生する可能性があるため、変換された設計を再確認することをお勧めします。変換に関するフィードバックや情報がある場合は、Ansys カスタマー サポート スペース (ACSS) で当社のチームにケースを開いてください。変換に関する問題を把握するために、変換レポートを一緒に確認することもできます。このレポート (および可能であれば SEQ ファイル) を共有して、障害や制限をよりよく理解することができます。

はじめに

OpticStudioには、CODE V設計をインポートする拡張機能が搭載されています。この拡張機能は、従来のZPLマクロ（CodeV to OpticStudio Converter.ZPL）を置き換え、改良することを目的としています。CODE V設計をインポートするには、テキストベースのSEQファイルで保存します。コンバーターは、CODE Vコマンドを1行ずつ読み込むことで、OpticStudio内で動的に設計を再作成できます。拡張機能には、設計を構築または変更するためのコマンドを1つずつ直接入力するためのインターフェースも用意されています。コンバーターでは、すべてのCODE Vコマンドおよび機能が完全にサポートされているわけではありません。ツールは継続的に改善されていますが、いくつかの制限事項もあり、変換された設計を検証する必要があります。

拡張機能のダウンロードとインストール

コンバーターは、この記事に添付されているZIPフォルダでダウンロードできます。インストールするには、まずOpticStudioを閉じます。次に、添付されているZIPファイルをDocuments\Zemax\ZOS-API\Extensionsフォルダに解凍します。実行ファイル（「'CODE V Converter.exe'」）がこのフォルダの最上位にあることを確認してください。OpticStudioを開くと、[ユーザー拡張機能] (User Extension) リストに [CODE V Converter] がオプションとして表示されます。

設計を変換するプロセス

CODE V設計をテキストベースのSEQファイルにエクスポートすると、OpticStudioの [プログラミング] (Programming) タブから拡張機能にアクセスできます。

拡張機能を開くと、メインGUIインターフェースが表示されます。変換を完了するには、SEQファイルに移動し、「Convert System」をクリックします。変換にはいくつかのオプションがあります：

• 変換の拡張子に、より詳細でフォーマットされた出力HTMLファイルが追加されています。「Show Summary」をオンにすると、変換が完了するとHTMLサマリーが自動的に開きます。
• 「Real-time Updates」オプションを選択すると、変換の実行時にOpticStudioで変更が表示されます。このオプションをオフのままにすると、変換が完了した後にインポートされたシステムが表示されます。
• 通常、変換中、OpticStudio の現在のシステムは削除され、SEQ コマンドは新しいシステムを作成します。ただし、現在のシステムを（最初に削除せずに）変更したいコマンドを含むSEQファイルを作成した場合は、「Import to Current Design 」で現在のシステムに変更が加えられます。
• 「Autoclose」オプションは、変換が正常に完了するとコンバーターを自動的にクローズします。

変換が完了すると、ツールはリッチテキストの変換レポート（下図）をHTMLファイル出力として作成します。このレポートには、変換に関する情報と、実行中に記録されたエラーと警告が表示されます。レポートの冒頭には、失敗したコマンドの数や認識されなかったコマンドの数などのメトリックを示すサマリーもあります。

バッチSEQファイル処理

統合されたユーザー拡張機能にはバッチ処理機能が含まれており、複数のSEQファイルを一度に変換できます。また、OpticStudio GUIと対話する必要がないため、ユーザー拡張機能として実行するよりも大幅に高速化できます。この機能を使用するには、OpticStudioの外部から呼び出す必要があります。このモードには2つのオプションがあります：

1. Documents\Zemax\ZOS-API\Extensions の下の Zemax ディレクトリに移動して、CODE V Converter.exe を実行します。アプリケーションを実行すると、SEQファイルかディレクトリのどちらかを選択するポップアップ・ウィンドウが表示されます。単一の SEQ ファイルまたはディレクトリの変換を切り替えるには、「Directory of Files」オプションのチェックを外すかオンにします。
    
2. Windows のコマンド ラインを使用すると、自動化されたスクリプトの一部としてコンバーターを呼び出すことができます。コンバーターは最大 3 つのパラメーターを受け取ります。最初のパラメーターは常に「-convert」で、その後に SEQ ファイル (フル パス付き) または変換する複数の SEQ ファイルを含むディレクトリ パスが続きます。最後に、マシンに複数のバージョンの OpticStudio がインストールされている場合は、最後のオプション パラメーターで、使用するバージョンの OpticStudio のプログラム ファイル ディレクトリを指定できます。
   

   “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 のコマンドラインから (またはリストされている引数を使用して) ツールを開くと、変換が完了すると自動的に閉じます。各変換の進行状況が報告され、スクリーンショットに示すように、変換が失敗したか成功したかが通知されます。

補足

最新のサポートコマンド一覧

次の表は、コンバーターで現在サポートされているコマンドを一覧にしたものです。コマンドがサポートされていると表示されていても、サポートされていないコマンドパラメーターやケースが存在する可能性があることに注意してください。コマンドのインポート方法やエラーについて場合は、Ansys カスタマー サポート スペース (ACSS) までお問い合わせください。