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

摘要 V`feUFw3  
F22]4DLHO  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 =}SC .E\  
k>\s6  

图片:1-1Q113224953T4.png

L9z5o(Aa  
pM!cF  
可编程界面所在位置：目录 eE0nW+i  
6WLq>Jo  

图片:1-1Q11322501Y47.png

7V~ gqum  
\ERHnh  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 f2Tz5slE  
hN;$'%^  
可编程界面所在位置：组件 6:G::"ew  
<Lq.J`|+  

图片:1-1Q1132251523M.png

M>jk"*hA|  
I
TU6Eq  
编写代码 
oi^pU  
;@[ax{ J  
•右侧面板显示了可用的独立参数列表。 N#X(gEV  
•x和y表示独立变量，即平面上的2D坐标。 %#lJn.o  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 \e?w8R.6w^  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 QUc&f+~  
•使用Snippet Body将支持函数中的部分代码分组。 KKwJ=za  
F4&`0y:  

图片:1-1Q1132253435R.png

gBXbB9  
"Za
'K+4  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 /JP%gD"8  
?)/&tk9.n  
表面梯度的定义 gBy7q09r  
+[=%
W  
•精确计算界面的梯度是光学仿真的基础。 Jn1(-  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 R"JT+m  
p+{*&Hm5  

图片:1-1Q1132254294X.png

k'1iquc#u  
{UOR_Vt!*  
用户自定义的表面梯度 9,AHC2kn%  
:k oXS  
SBG.t:  
•右侧面板显示了相同的可用独立参数列表。 R94ID@LF  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 _R|8_#yM  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ 4jz2x #T  
Y:K1v:Knw  

图片:1-1Q113225625919.png

1\if XJ  
.!h`(>+@  
可编程界面的输出 EY.Z.gMZI(  
?C|b>wM/  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 +"SYG  
•在有需要时，可在实际组件内直接编程自定义界面。 w 8oIq*  
•或者，将其保存在目录中供后续使用。 3*[YM7y  
<a$'tw-8  

图片:1-1Q113225FL09.png

+Zi@+|"BCN  
~HyqHxy  
对球形表面进行编程 #p|7\Y  
PQ`~qM:3st  
球形表面 v.e~m2u_F  
8j&LU,  

图片:1-1Q113225P1295.png

xrCb29{  
D7(kkr:r  
可编程界面所在位置：目录 dfA4OZ&  
ojy[<  

图片:1-1Q113225ZY61.png

Ni)/L( &  
9A9yZlt  
可编程界面所在位置：组件 RS1c+]rr  
C\C*'l6d  

图片:1-1Q11322592b42.png

Cdbh7  
"A%JT3  
设置表面的定义区域 a
YPD4yX"/  
[%yCnt  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 y6 _,U/9
 
•在本例中，我们使用圆孔。 aMycvYzH  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ (cEjC`]  
>ay% !X@3"  

图片:1-1Q1132259514E.png

BF(.^oh"n0  
0 P-eC|0  
进入可编程界面 $ -n?q w  
]2o?Gnn@  

图片:1-1Q113230035R8.png

^SH8*7l7  
pz@wbu=($4  
可编程界面：全局参数 kc&MO`2 W\  
f6-OR]R5  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 `p)$7!  
•在那里，添加和编辑一个参数： OKp0@A)8  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 f-/zR%s{  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 982n
G-"  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 ;`MKi5g  
VOK0)O>&  

图片:1-1Q11323011A22.png

Yr9!</;T  
6YeEr!zt%  
可编程界面：代码段帮助（Snippet Help） 
b"C1  
vpl> 5%  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 ^u[n!R\  
•此选项对于使用可编程元素跟踪进度非常有用。 LU7d\Ch  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ z&r@c-l@  
iw==q:$  

图片:1-1Q11323015HB.png

yG<`7v  
%RF9R"t$  

图片:1-1Q113230325X3.png

0qUBt9rA  
kX)Xo`^Ys  
可编程界面：编写代码 C:WXI;*cr  
b/eJEL  

图片:1-1Q113230354L2.png

5bKm)|4z6  
Y^~Dr|5%  
可编程界面：用户自定义梯度 cK(S{|F  
I"<ACM  

图片:1-1Q113230414a1.png

*[^[!'kT&  
可编程界面：使用您的代码段（Snippet） > R5<D'cEN  
_
:0  

图片:1-1Q113230441529.png

@L ,hA v^  
(s2ke  
可编程界面的输出 N-O"y3W}  
&n)=OConge  

图片:1-1Q113230513340.png

g~i%*u,Y<  
`/0S]?a.{B  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） 3h-C&C  
 aX'R&R  
将自定义界面保存到目录中 @1UC9}>  
E 9LKVs}  

图片:1-1Q11323055K33.png

>w~Hq9  
hkhk,bhI  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 2MapB*  
`X06JTqf:  
故障排除提示 mrgi
eb%  
1>BY:xZr  

图片:1-1Q11323062S59.png

B]o5HA<k  
GYq.!d@O  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ k1
5B5
 
I#m0n%-[  

图片:1-1Q113230A3617.png

~RRp5x _  
?'dsiA[  
测试代码! 9J0JSy  
E~y@ue:  

图片:1-1Q113230G5391.png

5A~lu4-q  
-t:~d:  

图片:1-1Q113230I3W0.png

X_6h8n}i  
-9Ll'fbq  
文件信息 l".LtU
f-  
CQ`$' oy?W  

图片:1-1Q113230K5B1.png

G{ 9p.Q  
tTzPT<