[分享]如何使用可编程界面及示例（球面） [复制链接]

摘要 Y4@~NCU/  
zY[6Ia{L  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 )#ic"UtR  
akm)X0!-}  

图片:1-1Q113224953T4.png

:b=`sUn<X+  
bT[Q:#GL  
可编程界面所在位置：目录 J9/9
k  
]_d(YHYf  

图片:1-1Q11322501Y47.png

'QeqWn  
IZJV6c
lM  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 3(^9K2.s}  
kt[#@M!}  
可编程界面所在位置：组件 F!pUfF,&  
&^9f)xb  

图片:1-1Q1132251523M.png

o"Ef>5N  
Lrq+0dI 65  
编写代码 8k_,Hni  
4DuZF -y  
•右侧面板显示了可用的独立参数列表。 "kP.Kx!  
•x和y表示独立变量，即平面上的2D坐标。 e6
sL N  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 YvBUx#\  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 Ma-^
o<{  
•使用Snippet Body将支持函数中的部分代码分组。 ]P(Eo|)
m  
deHBY4@  

图片:1-1Q1132253435R.png

^Xa-)Pu  
hH"3Y}U@  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 w$Dp m.0(  
,:>>04O  
表面梯度的定义 gjo\gP@  
5U1@wfKE3>  
•精确计算界面的梯度是光学仿真的基础。 9!bD|-6y  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 |8+<qgQ  
'QCvN b6  

图片:1-1Q1132254294X.png

.]r[0U  
{zVJlJKxs  
用户自定义的表面梯度 0>Mm |x*5  
QR4v6*VpD  
EVb'x Zr  
•右侧面板显示了相同的可用独立参数列表。 pNQd\nY|0  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 DKK200j  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ ,{'~J @  
s<<vHzm  

图片:1-1Q113225625919.png

H7l[5ib  
=i:?4pIZ  
可编程界面的输出 "DRp4;  
q".l:T%|C}  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 "Jv&=zJ  
•在有需要时，可在实际组件内直接编程自定义界面。 [c>X Q  
•或者，将其保存在目录中供后续使用。 [W^6=7EO  
'7Te{^<FQ$  

图片:1-1Q113225FL09.png

/x$jd)C  
HO' ELiZ_q  
对球形表面进行编程 CuuHRvU8  
xg3G  
球形表面 {tWfLfzU  
w'L;`k;Q  

图片:1-1Q113225P1295.png

$#KSvo{otI  
bE0S)b)  
可编程界面所在位置：目录 m1+DeXR_g  
!>>$'.nb@~  

图片:1-1Q113225ZY61.png

|$1j;#h  
s[xdID^3.  
可编程界面所在位置：组件 P6IhpB59  
4<lZ;M"  

图片:1-1Q11322592b42.png

&3u* zV$  
v{%2`_c  
设置表面的定义区域 A;2?!i#f  
?+5K2Zk  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 .5ingB3%  
•在本例中，我们使用圆孔。 *d,SI[c%e  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ CrqWlO  
[8
)Zhw$  

图片:1-1Q1132259514E.png

"]JS,g {m  
^-=,q.[7  
进入可编程界面 z` gR*+  
8.9S91]=  

图片:1-1Q113230035R8.png

=&}dP%3LC)  
L#NPt4Sz+  
可编程界面：全局参数 '9^x"U9c  
ri
\r%x  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 M4')gG;  
•在那里，添加和编辑一个参数： Bd\p!f<  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 [kC-g
@  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 M+nz~,![  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 }|A%2!Q}  
8G{} r  

图片:1-1Q11323011A22.png

nq_sbli  
gy*N)iv%  
可编程界面：代码段帮助（Snippet Help） \/lS!+~'']  
iL5+Uf)E3  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 >i`'e~%  
•此选项对于使用可编程元素跟踪进度非常有用。 A:;KU  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ NCl={O9<j  
vH7"tz&RIp  

图片:1-1Q11323015HB.png

0!!pNK%(  
2;6p2GNSh  

图片:1-1Q113230325X3.png

<L5[#V_  
[g<6i.<I  
可编程界面：编写代码 5GpRN  
(^057  

图片:1-1Q113230354L2.png

nDaQ1  
<$7*yV  
可编程界面：用户自定义梯度 _>&zhw2  
2&5"m;<  

图片:1-1Q113230414a1.png

=DF7l<&km  
可编程界面：使用您的代码段（Snippet） ?M\3n5;  
P_i2yhpK  

图片:1-1Q113230441529.png

=u73AM}  

uZW1 :cx  
可编程界面的输出 7?cZ9^z`w  
<PJwBA%{  

图片:1-1Q113230513340.png

5v>(xl  
#nn2odR  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） }4ta#T Ea  
{$Fg+~
 
将自定义界面保存到目录中 eK3J9;X  
'<8ew
U  

图片:1-1Q11323055K33.png

n_?<q{GW  
spn1Ji  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 :^?ZVi59j  
iVnrv`k,  
故障排除提示 rWSw1(sAA  
QJ pUk%Wj  

图片:1-1Q11323062S59.png

^9"|tWf6O  
P1H`NOC  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ }%_x T  
J&Le*R'  

图片:1-1Q113230A3617.png

'du:Bxl`d4  
hIP
DJ1a  
测试代码! YceiP,!4?v  
Z\O ,9  

图片:1-1Q113230G5391.png

_Z5l Nu  
A-.jv  

图片:1-1Q113230I3W0.png

I@ }:} 8t  
Z]oa+W+  
文件信息 0B1*N_.L@  
QT\S>}  

图片:1-1Q113230K5B1.png

ToDN^qE+  
*F~"4g