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

摘要 sV{[~U,|  
g*!2.P  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 &@{Ba~S  

7gPk
g63  

图片:1-1Q113224953T4.png

18|H  
}`*]&I[P  
可编程界面所在位置：目录 tl0_as  
R3.tkFZq]  

图片:1-1Q11322501Y47.png

@8DA  
jcevpKkRG  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 W;u~}k<  
f{ENSUtCrR  
可编程界面所在位置：组件 o6oZk0  
du`],/ 6  

图片:1-1Q1132251523M.png

<.
RgMPi  
&OWiA;e?f  
编写代码 5C2 *f4|  
.Ml}cE$L  
•右侧面板显示了可用的独立参数列表。 RqH"+/wR  
•x和y表示独立变量，即平面上的2D坐标。 nj #Ab  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 Fi1gM}>py  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 ;M\H#%G.  
•使用Snippet Body将支持函数中的部分代码分组。 U%j=)VD])  
*H:;pIWP  

图片:1-1Q1132253435R.png

m {wMzsQ  
iK'bV<V&7  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。  cfpP?  
YVqhX]/
  
表面梯度的定义 6z!?U:bT  
ZuILDevMD  
•精确计算界面的梯度是光学仿真的基础。 ~Ui<y=d  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 vU&gFEWg  
rhwY5FD?  

图片:1-1Q1132254294X.png

rp.JYz,  
gmy_ZVU'  
用户自定义的表面梯度 Y <Ta2H  
Yb6(KT  
bU(t5 [
  
•右侧面板显示了相同的可用独立参数列表。  2o?!m2W  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 =w_y<V4  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ ;40!2P8t  
vgo-[^FiP$  

图片:1-1Q113225625919.png

_U%!&_m6  
wp$CJ09f*  
可编程界面的输出 T&X*[kP  
N-4LdC  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 N1zB;-0t  
•在有需要时，可在实际组件内直接编程自定义界面。 e*Sv}4e=.  
•或者，将其保存在目录中供后续使用。 K/ I3r_  
K{t7_i#tv  

图片:1-1Q113225FL09.png

+#A>[,U  
w*uHB;?  
对球形表面进行编程 HB
V~`0O$  
&5)Kg%r  
球形表面 w}K<,5I>  
.~4%TsBaY  

图片:1-1Q113225P1295.png

>-c;  
0bzD-K4WVd  
可编程界面所在位置：目录 4%aODr8  
F!tn|!~  

图片:1-1Q113225ZY61.png

#3f\,4K5  
l5l:'EY>  
可编程界面所在位置：组件 yOxJx7uD  
Vdjf F&q  

图片:1-1Q11322592b42.png

Azxy!gDT"  
@=E@ *@g  
设置表面的定义区域 9\0  
X25cU{  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 aF;Q
SI  
•在本例中，我们使用圆孔。 LZqx6~]O  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ >}\!'3)_  
MW &iNioX  

图片:1-1Q1132259514E.png

_8)9I?jH  
)wQR2$x~  
进入可编程界面 ~3dBt@%0  
l'fUa  

图片:1-1Q113230035R8.png

jFZJ #'CNS  
f`*Ip?V-  
可编程界面：全局参数  P 1X8  
MoIVval/  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 $cHA_$ `  
•在那里，添加和编辑一个参数： ]O3[Te  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 Edj}\e*-J  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 ]7}2"?J4v  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 IKb 7#Ut  
!n~p?joJ*  

图片:1-1Q11323011A22.png

):E4qlB  
ev7Y^   
可编程界面：代码段帮助（Snippet Help） qd6XKl\5  
&ok2Xw  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 `{s:lf  
•此选项对于使用可编程元素跟踪进度非常有用。 5K|1Y#X  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ 0&E{[~Pv  
)=V0  

图片:1-1Q11323015HB.png

w+(bkqz]  
pPem;i^~  

图片:1-1Q113230325X3.png

,.6Hh'^65^  
kaQn'5  
可编程界面：编写代码 c&z@HEzV7  
U@x5cw:  

图片:1-1Q113230354L2.png

3yn>9qt  
Ufd{.o[{-  
可编程界面：用户自定义梯度 %:yJ/&-Q,Z  
Ll\y2oJ  

图片:1-1Q113230414a1.png

WQv%57+  
可编程界面：使用您的代码段（Snippet） CKeT%3  
#9uNJla
 

图片:1-1Q113230441529.png

. S4Xw2MS  
c,-3+b  
可编程界面的输出 GawQ~rD  
`2Rd=M]?  

图片:1-1Q113230513340.png

?G%C}8a  
bII pJQ1.[  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） v#J2yg  
U
[1Rw6  
将自定义界面保存到目录中 w6(E$:#d  
ZT;$aNy  

图片:1-1Q11323055K33.png

|X@ZM  
}xXUCU<  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 <=2\xJfxB  
Hz39
v44  
故障排除提示 BnJpC<xm  
Q'D%?Vg'  

图片:1-1Q11323062S59.png

d^AXhQjQN-  
03Czx`  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ x-J.*X/aB  
W>$2BsO  

图片:1-1Q113230A3617.png

4h% G %>j  
W.u+R?a=  
测试代码! 84(NylZ  
K[{hh;7
 

图片:1-1Q113230G5391.png

#_oN.1u57  
cP8g.+  

图片:1-1Q113230I3W0.png

[\|`C4@3a  
o_=t9\:  
文件信息 \piB*"ln  
(.r9bl  

图片:1-1Q113230K5B1.png

`X;'*E]e  
7S^ba