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

摘要 WmLl.Vv=  
J'^s5hxn+0  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 0?l|A1I%  
SPW @TF1  

图片:1-1Q113224953T4.png

[9UKVnX.V  
hABC rd Em  
可编程界面所在位置：目录
E(tdL,m'  
!OM9aITv[  

图片:1-1Q11322501Y47.png

g.aNITjP  
Mh'QD)28c  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 xjOy3_Js  
3P Twpq1  
可编程界面所在位置：组件 @8C^[fDL  
DrbjqQL+.  

图片:1-1Q1132251523M.png

,R0@`t1 p  
Ou/@!Y1  
编写代码 6"WR}S0o  
C-]H+p  
•右侧面板显示了可用的独立参数列表。 Gdnk1_D>  
•x和y表示独立变量，即平面上的2D坐标。 V`~$| K[  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 Y{Kpopst  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 o*97Nbjn  
•使用Snippet Body将支持函数中的部分代码分组。 ;+K:^*oJ  
T3Kq1 Rh  

图片:1-1Q1132253435R.png

#O]F5JB  
&J^@TgqL^  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 (xK=/()}q  
0*VRFd4  
表面梯度的定义 Cca( oV  
X obiF  
•精确计算界面的梯度是光学仿真的基础。 UV)[a%/SB&  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 Q@%VJPLv.  
lT$Vv=M  

图片:1-1Q1132254294X.png

qfE/,L(B  
&9PzBc  
用户自定义的表面梯度 wM(!9Ws3  
y% uUA]c*m  
lE08UEk1i  
•右侧面板显示了相同的可用独立参数列表。 VZYdCZ&l7  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 2j-|.l c  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ aGNt?)8WPZ  
*rp@`W5  

图片:1-1Q113225625919.png

N::_JH?^=  
JXBW0|8b  
可编程界面的输出 ru3nnF_I  
ItQIM#  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 nlHH}K  
•在有需要时，可在实际组件内直接编程自定义界面。 E& T9R2Y  
•或者，将其保存在目录中供后续使用。 4 *He<2g  
x '3<F  

图片:1-1Q113225FL09.png

zF<*h~  
dTyTj|"x{  
对球形表面进行编程 9%oLv25{)  
8~:qn@Z|E  
球形表面 U/yYQZ\)  
M]jzbJ3Q  

图片:1-1Q113225P1295.png

RmO-".$yt  
|^Try2@  
可编程界面所在位置：目录 9NaC7D$,  
~zRUJ2hD!  

图片:1-1Q113225ZY61.png

#93;V'b]  
eL^,-3JA(]  
可编程界面所在位置：组件 :~:(49l  
^o!K0t*  

图片:1-1Q11322592b42.png

6 )0$UW  
vkE6e6,Qc  
设置表面的定义区域 %&Z!-k(  
dSsMa3X[n  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 P~;NwHZ?k  
•在本例中，我们使用圆孔。 vb9G_Pfz  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ #1z}~1-  
'68{dyFZL  

图片:1-1Q1132259514E.png

it
X<!  
ub}t3#  
进入可编程界面 V5K`TC^
 
mY(~94{d  

图片:1-1Q113230035R8.png

|g> K$m^  
Mh>^~;  
可编程界面：全局参数 :2 ?dl:l  
$tj[*  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 Eo)Q> AM  
•在那里，添加和编辑一个参数： ff-9NvW4v  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 nEQw6q~je  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 p:k>!8.Qho  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 .cQwjL  
}UHuFff,  

图片:1-1Q11323011A22.png

`P)a
tQ  
m]=|%a6  
可编程界面：代码段帮助（Snippet Help） l *yml  
u` `FD  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 ?*tpW75hR[  
•此选项对于使用可编程元素跟踪进度非常有用。 oVb6,
Pn  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ h?bm1e5kE  
Jmf&&)p  

图片:1-1Q11323015HB.png

fph*|T&R  
`WC~cb\  

图片:1-1Q113230325X3.png

4tCyd5u a8  
~${.sD\  
可编程界面：编写代码 e {N8|l  
ss236&  

图片:1-1Q113230354L2.png

0kQAT#  
Xko[Z;4v8'  
可编程界面：用户自定义梯度 <{9E.6G`n  
hi*\5(uH  

图片:1-1Q113230414a1.png

{#zJx(2yG  
可编程界面：使用您的代码段（Snippet） 87>\wUJ  
N#6&t8;kTC  

图片:1-1Q113230441529.png

F
,P,dc  
$vTU|o>|  
可编程界面的输出 `+\+  
+*DXzVC  

图片:1-1Q113230513340.png

hCc_+/j|  
F4e<=R  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） gUy >I(  
o\g",O4-  
将自定义界面保存到目录中 (4>k+ H  
9%$4Ux*q  

图片:1-1Q11323055K33.png

|B;:Ald  
Jf|J":S  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 7 H.2]X  
S)n~^q  
故障排除提示 +K; X$kB  
&f|LjpMCf  

图片:1-1Q11323062S59.png

U5Q `r7  
JyjS#BWi  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ ZxwI< T:&  
}Rt?p8p  

图片:1-1Q113230A3617.png

B7fURL Rqr  
{Tm31f(oD  
测试代码! wx>BNlT@?  
H`9E_[  

图片:1-1Q113230G5391.png

^^{K[sLB  
t1 OnA#]/_  

图片:1-1Q113230I3W0.png

,~hvF
TJI  
y7u"a)T  
文件信息 >IJH#>i  
("}
TW-r~  

图片:1-1Q113230K5B1.png

;xN4L  
<JuP+\JAm