Ansys Zemax | 在 MATLAB 或 Python 中使用 ZOS-API 进行光线追迹的批次处理

图片

附件下载

联系工作人员获取附件

这篇文章会说明如何在 MATLAB 或 Python 中以 Zemax OpticStudio 应用程式介面 (ZOS-API)处理光线数据库(Ray Database, ZRD)档案,过程中我们将使用ZRDLoader.dll。本文提供了在 Matlab 中批次处理序列光线追迹(一般、归一化、偏振或非偏振),以及在 Matlab 和 Python 中使用方法 ReadNextSegmentFull() 批次处理非序列 ZRD 档案的范例。

什么是 RayTrace.dll?

RayTrace.dll 结合了 ZRDLoader.dll 和 ReadNextSegmentFull,并在序列模式中与4个 IBatchRayTrace 介面共同运作。此外,RayTrace.dll 这个动态连结函式库涵盖了以下的介面,并且继承了 ZOSAPI.Tools.RayTrace 的命名空间:

  • IRayTraceDirectPolData (sequential):
    在这个介面中,我们可以直接在 XYZ 座标中完成批次的偏振光线追迹,而这也和 DDE 光线追迹指令(模式3)十分相似。此外,该介面属于 IBatchRayTrace 介面的一种。

  • IRayTraceDirectUnpolData (sequential):

    在这个介面中,我们可以在 XYZ 坐标中完成批次的非偏振光线追迹,而这与 DDE 光线追迹指令(模式1)相似。此外,该介面也同样属于 IBatchRayTrace 介面的一种。

  • IRayTraceNormPolData (sequential):
    在这个介面中,我們可以使用归一化光瞳坐标(normalized pupil coordinate)进行批次偏振光线追迹,这个 DDE 光线追迹指令(模式2)相似。此外,这介面也同样属于 IBatchRayTrace 介面的一种。

  • IRayTraceNormUnpolData (sequential):
    在这个介面中,我们可以使用归一化光瞳坐标进行批次非偏振光线追迹,这与 DDE 光线追迹指令(模式0)相似。

  • IZRDReader (non-sequential):
    我们使用这个介面在 Matlab 中設定 RayDatabaseReader 並使其运作,同時读取 C#dll 中每一个区段(segment)的值。

这个 DLL  的设计是为了使光线或区段的原始值(raw value)可以作为宣告物件的属性,而被传递到 MATLAB 或 Python,因此 DLL 运作的过程中不会涉及任何的计算、合并和分析。这个 DLL 的主要目的是为了減少 MATLAB 或 Python 中十分耗时的 for 回圈,將原先效率极低的程式转为原生且编译完成的 C# 程式码。接著,当原始值经过所有回圈后,C# 程式码会将数值回传到  MATLAB 或 Python 进行最后的处理。

在序列模式的介面中有两种情況会需要 for 回圈的协助: AddRays()和ReadNextResults(),分別用来增加光线和读取数据。为了提高效率,我们会以 DLL 达成这两项任务。文章附件的其中两个范例示范了如何在序列模式中高效率的产生方形网格或低量化误差的光线 (dithered rays)。根据预期达成的光线模式(若与预设模式不同的话),我们可以在 MATLAB 中使用原生阵列索引 (native array indexing)的方式增加 DLL 中的光线,这与原本的方法是十分相似的。无论是在ReadNextResult()或 ReadNextResultFull(),最终回传到 MATLAB 或 Python 中的结果均会与该介面最复杂輸出(verbose output)有着相同的物件属性,包含了正确的相位和相对应的案例。为了提高效率,我们会试着以 MATLAB 的阵列索引(array indexing)取代 for 或 while 回圈的使用。

DLL 使用范例

我们使用三个基础和三个进阶范例示范如何在一般序列模式(sequential direct)、归一化序列模式(sequential normalized)和非序列 ZRD 光线追迹的情況下使用RayTrace.dll。这些示范档案都可以直接下载并使用,不需要对程式码进行任何更改。要注意的是,RayTrace.dll  必须被存放在和其他 MATLAB 或Python 脚本(script)相同的资料夹中,才能确保使用时能被顺利的呼叫。产生每个 DLL 所使用的 C# 原始码以及 Visual Studio 的解都可以在下方的文章中找到。

基本范例

  • MATLAB_BatchRayTrace_Direct.m – (SEQ Direct).
    这个范例使用了 IRayTraceDirectUnpolData 介面。此外,它还同时使用了RayTrace.dll (DirectUnpol.cs) 中的 ReadDirectUnpolData 函数。范例中,系统追迹了特定透镜表面的光迹图(footprint diagram),同时绘出系统的净口径 (Clear Semi-Diameter)和机械半直径 (Mechanical Semi-Diameter)。

    图片

  • MATLAB_BatchRayTrace_Normalized.m – (SEQ Norm).
    这个范例使用了 IRayTraceNormUnpolData 介面,而该介面还包含了RayTrace.dll (NormUnpol.cs) 中的 ReadNormUnpolData 函数。范例中,系统以超过10,000条光线追迹一個方形图案投射至像面的结果。设定上只使用了单一视场,且整个过程耗时不到一秒。

    图片

  • MATLAB_ZRDLoaderFull.m or PythonNET_ZRDLoaderFull.py – (NSC ZRD)
    这个范例使用了 IZRDReader 介面,且同時使用了RayTrace.dll (ZRDLoaderFull.cs)中的 ReadZRDData 函数。范例中,系统解析了 ZRD 档案并决定了特定探测器上接收到的总能量。

    图片

进阶范例

  • MATLAB_BatchRayTrace_Surface_AOI.m – (SEQ Direct).
    这个范例使用了 IRayTraceDirectUnpolData 介面,且同時使用了RayTrace.dll (DirectUnpol.cs)的ReadDirectUnpolData 函数。范例中,系统追迹了光线网格投射至一个特定表面的结果。过程中使用了 LMN 方向的 cosine 向量和 Nxyz 法向量计算光线在表面上每个 XY 点的入射角。

    图片

  • MATLAB_BatchRayTrace_Ex22_Performance_Comparison.m – (SEQ Norm).
    这个范例使用了 IRayTraceNormUnpolData 介面,同时还使用了RayTrace.dll (NormUnpol.cs)的ReadNormUnpolData 函数。范例中,系统使用低量化误差光线图型(dithered ray pattern) 绘制了整个视场的点列图(spot diagram)。模拟过程中,系统可以在一秒內追迹10,000条光线。相同情況下,若使用原生 MATLAB 的 for 回圈,绘制961条光线将耗时超过4秒。根据电脑的性能差异,使用 DLL 最高可将运算过程加速为原先的40倍。

    图片

  • MATLAB_ZRD_Pixelated_Detector_xybin.m – (NSC ZRD).
    这个范例使用了IZRDReader介面,同時也使用了RayTrace.dll (ZRDLoaderFull.cs)的 ReadZRDData 函数。范例中的系统有矩形光源、矩形探测器,以及一个由 “LETTERF.BMP”产生的幻燈片(Slide) 物件,最后在探测器上显现出图型 “F”。接着,我们使用 ZRD 档案中的“xybin”将每个像素的光通量加总,重新在 ZRD 档案中产生一个新的探测器结果。这样的做法可使我们免于使用探测器查看器(Detector Viewer)的分析功能,直接在 MATLAB 中看到结果。

图片

疑难排解

若是使用了范例提供的 Visual Studio 解,但却在编译的过程中出现错误的话,请先照着以下步骤操作以确保 ZOSAPI  和 ZOSAPI_Interfaces 的来源(Reference)是正确的。我們可以打开 Solution Explorer,并点选 References。假如这时 ZOSAPI  和 ZOSAPI_Interfaces  旁边出现黃色的警示标语,你将会需要进行以下操作:

  • 移除现有的 references (滑鼠右键>移除(Remove))

  • 右键选取 Reference 并选择 Add References

  • 点选 Browse 并找到 OpticStudio 的安装资料夹

  • 以快捷键 Shift+Click 选择 ZOSAPI 和 ZOSAPI_Interfaces,接着点选 Add

  • 点选 OK 加入新的解

  • 选取所有的 references,打开 Properties 接着将 Copy Local 由True 改为 False

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/771263.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

定制化区块链交易所开发:Dapp、DeFi和IDO的全方位解决方案

随着区块链技术的不断发展,区块链交易所已经成为数字资产交易的主要场所之一。然而,由于不同项目的需求和特点各不相同,通用的交易所往往无法满足所有的需求。因此,定制化区块链交易所的需求逐渐增加,以满足不同项目的…

搜维尔科技:「工业仿真」煤炭矿井模拟仿真救援项目实施

煤炭矿井模拟救援系统满足煤矿企业在紧急避险应急演练方面的实际需要,在不耽误井下正常生产的情况下,高效率、低成本地实现对本矿区入井人员进行避灾演练培训,并学会正确的避灾自救互救方法。并可在本系统中直观的看到人员定位系统、监控系统…

【JAVA】建立一个图书管理系统

在建立一个图书管理系统的时候我们首先需要构造一个书类 public class Book {private String name;private String author;private int price;private String type;private boolean isBorrwed;public Book(String name, String author, int price, String type) {this.name n…

【原创】RockyLinux9.3手动编译MySQL8.2.0源码,超详细!!

前言 MySQL安装如果使用rpm包安装实在过于麻烦,缺这缺那的,我就想能不能就源码包自己手动编译安装,编译完的包可以给其他服务器直接用,这样只需要麻烦一次,后面就方便了。至于为什么不用RockyLinux8.6版本&#xff0c…

Java虚拟机运行原理

在 Java 中新建一个类Test: class Test {int a; }在Main方法中创建两个 Test 对象,并给 a 赋不同的值。 写一个 exchange 方法,在方法中交换两个Test 对象,最后输出两个对象中 a 的值。 public class Main {public static void…

SaaS模式java智慧工地源码 有演示 AI视频智能分析解决工地安监需求

SaaS模式java智慧工地源码 AI视频智能分析解决工地安监需求 有演示 智慧工地系统充分利用计算机技术、互联网、物联网、云计算、大数据等新一代信息技术,以PC端,移动端,平板端三位一体的管控方式为企业现场工程管理提供了先进的技术手段。让劳…

第四讲:隐语SecretFlow安装部署

SecretFLow安装 环境要求: Python>3.8; 操作系统:CentOS7,Anolis8,Ubuntu 18.04/20.04,macOS11.1,WSL2; 资源:>8核16GB 安装包:SecretFLow, SecretF…

物联网数据报表分析

随着物联网技术的迅猛发展,越来越多的企业开始将物联网解决方案应用于各个领域,从提高生产效率到优化用户体验,物联网都发挥着至关重要的作用。然而,如何有效地分析和管理物联网产生的海量数据,成为企业面临的挑战之一…

fl破解补丁下载2024FL Studio v21.1.1.3750 Crack永久下载和使用激活图文教程

FL Studio21简介 各位,大家晚上好,今天给大家带来最新最新2024水果编曲软件FL Studio 21中文版下载安装激活图文教程。我们一起先了解一些FL Studio 。FL Studio21是目前流行广泛使用人数最多音乐编曲宿主制作DAW软件,这款软件相信广大网友并…

【c++】【STL】stack类、queue类、deque类详解及模拟

🪐🪐🪐欢迎来到程序员餐厅💫💫💫 今日主菜:stack和queue,deque类 主厨:邪王真眼 所属专栏:c专栏 主厨的主页:Chef‘s blog 这可是…

JVM垃圾收集——概述

文章目录 1、什么是垃圾2、为什么需要垃圾收集3、如何进行垃圾收集3.1、早期垃圾收集3.2、Java垃圾收集机制 4、小结 垃圾收集(Garbage Collection,GC)并不是Java语言所独有的,早在1960年,Lisp语言中就已经开始使用内存的动态分配和垃圾收集技术。可见&a…

基于SSM框架的酒店预订系统

基于SSM框架的酒店预订系统的设计与实现 摘要 当今世界的互联网信息技术飞速发展,网络化的工作模式已经几乎覆盖到各个工作领域中的业务内,人们的日常生活也渐渐离不开互联网。因此,在当下全国各处的酒店都开始构建起了自己的网络预订系统。…

Spring Boot整合Spring Security

Spring Boot 专栏:Spring Boot 从零单排 Spring Cloud 专栏:Spring Cloud 从零单排 GitHub:SpringBootDemo Gitee:SpringBootDemo Spring Security是针对Spring项目的安全框架,也是Spring Boot底层安全模块的默认技术…

Netty学习——源码篇6 Pipeline设计原理

1 Pipeline设计原理 在Netty中每个Channel都有且仅有一个ChannelPipeline与之对应,它们的组成关系如下图: 通过上图可以看到,一个Channel包含了一个ChannelPipeline,而ChannelPipeline中又维护了一个由ChannelHandlerContext组成的…

【笔记】深入理解JVM机制

🎥 个人主页:Dikz12📕格言:吾愚多不敏,而愿加学欢迎大家👍点赞✍评论⭐收藏 目录 JVM 运⾏流程图 JVM 中内存区域划分 方法区 / 元数据区 堆 栈 程序计数器 本地方法栈 内存区域总结 JVM 中类加载过程 …

C++ STL- list 的使用以及练习

目录 0.引言 1. list 介绍 2. list 使用 2.1 构造函数 2.2 list iterator 的使用 3 list capacity 4. list element access 5. list modifiers 6. list 迭代器失效 7. list 与vector 对vector 8. OJ 题讲解 删除链表的倒数第 N 个节点: 0.引言 …

Jetson AGX ORIN 配置 FGVC-PIM 神经网络(包含 arm64 下面 torch 和 torchvision 配置内容)

Jetson AGX ORIN 配置 FGVC-PIM 神经网络 文章目录 Jetson AGX ORIN 配置 FGVC-PIM 神经网络配置 ORIN 环境创建 FGVC-PIM 虚拟环境安装 PyTorch安装 torchvision安装其他依赖包 配置 ORIN 环境 首先先配置 ORIN 的环境,可以参考这个链接: Jetson AGX …

Go第三方框架--gin框架(一)

序言 Gin框架作为go语言使用最多的web框架,以其快速的响应速度和对复杂http路由配置的支持受到程序员和媛们的喜爱,几乎统治了web市场。但作为一名合格的程序员,要知其然更要知其所以然,不然八股文背的也没有啥意思。本着这个原则…

JavaScript中的Lexical Environment

概要 本文主要介绍JavaScript中的一个重要概念Lexical Environment,它可以帮助我们解释我们为什么可以通过嵌套方法,共享数据,以及为什么可以在函数中定义一个和全局变量同名的变量,并且不会影响到全局变量。 基本分析 基本概念…

如何使用Python进行网络安全与密码学【第149篇—密码学】

👽发现宝藏 前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。【点击进入巨牛的人工智能学习网站】。 用Python进行网络安全与密码学:技术实践指南 随着互联网的普及,网络…