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

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

图片:1-1Q113224953T4.png

;q59Cr75  
Ay22-/C|@  
可编程界面所在位置：目录 W1i
Kn  
$*{PUj  

图片:1-1Q11322501Y47.png

Y6,< j|  
`b+f^6SJn  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 eOE7A'X  

^D ;X  
可编程界面所在位置：组件 s-J>(|  
z<hy#BIjnd  

图片:1-1Q1132251523M.png

OIe {Sx{y  
!Z`~=n3bk  
编写代码 ebcGdC/%>  
ZjF$zVk  
•右侧面板显示了可用的独立参数列表。 t=d~\_Oa  
•x和y表示独立变量，即平面上的2D坐标。 ]4@_KKP  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 0bVtku K;G  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 r*OSEzGUz  
•使用Snippet Body将支持函数中的部分代码分组。 j|A *rzL8  
b,cA mZ  

图片:1-1Q1132253435R.png

/xWkP{
 
A\
CtM`  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 Nc,"wA  
a]Bm0gdrO  
表面梯度的定义 |)B&-~a+p  
cAogz/<S  
•精确计算界面的梯度是光学仿真的基础。 j*Ta?'*  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 Ola>] 0l  

QS4sSu
a  

图片:1-1Q1132254294X.png

hbD@B.PD  
hHm&u^xY  
用户自定义的表面梯度 ) ^'Q@W  
&HNJ'  
U@@#f;&  
•右侧面板显示了相同的可用独立参数列表。 s7A{<>:  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 ce0TQ  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ |<96H8  
bjmUU6VLT  

图片:1-1Q113225625919.png

47ppyh6@  
S#8wnHq  
可编程界面的输出 ),(ejRP'r  
MRwls@z=  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 EW%%W6O6  
•在有需要时，可在实际组件内直接编程自定义界面。 `(vgBz`e[  
•或者，将其保存在目录中供后续使用。 O[+S/6uy  
Oz#
$x  

图片:1-1Q113225FL09.png

j7K9T  
fIu5d6;'  
对球形表面进行编程 DN2K4%cM%'  
r :{2}nE  
球形表面 2Vxr  
N)K};yMf  

图片:1-1Q113225P1295.png

mT <4@RrB  
[ dpd-s  
可编程界面所在位置：目录 Kn SXygT  
gbL99MZ@~  

图片:1-1Q113225ZY61.png

(C={/waJ  
OmQSNU.our  
可编程界面所在位置：组件 BC ]^BKP
 
!@{_Qt1  

图片:1-1Q11322592b42.png

IHZ WNT2  
#O6SEK|Z  
设置表面的定义区域  kj~)#KDN  
(cAv :EKpo  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 LY'_U0y4  
•在本例中，我们使用圆孔。 OD-CU8X9  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ a,b;H(em  
7h?PVobe  

图片:1-1Q1132259514E.png

b#(SDNo6  
RIJ+]uir4  
进入可编程界面 f50qA;7k  
.^>[@w3  

图片:1-1Q113230035R8.png

I&l1b>  
aR6?+`6<  
可编程界面：全局参数 Dq/[g,(  
O+%Y1=S[WQ  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 8W)3rD>  
•在那里，添加和编辑一个参数： .'mmn5E  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 <?kr"[cQeP  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 HK)$ls  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 I~\j%zD  
.\= GfF'  

图片:1-1Q11323011A22.png

%_;q<@9)  
*M\Qt
_[  
可编程界面：代码段帮助（Snippet Help） ;ob-'  
Ck8`$x&t  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 h@=H7oV7k  
•此选项对于使用可编程元素跟踪进度非常有用。 zDeh#  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ EKZ40z`  
E#JDbV1AC  

图片:1-1Q11323015HB.png

-BfZ P5  
.%_scNP  

图片:1-1Q113230325X3.png

ks<gSCB  
`Jhu&MWg  
可编程界面：编写代码 7r 07N'  
7D\#1h  

图片:1-1Q113230354L2.png

#~*fZ|sq+3  
} R!-*Wk  
可编程界面：用户自定义梯度 REDh`Wd  
)[yM4QFl  

图片:1-1Q113230414a1.png

 ?1?D[7$  
可编程界面：使用您的代码段（Snippet） !^cQPX2<  
ugcWFB5
|  

图片:1-1Q113230441529.png

zD}dvI}  
wr,X@y%(!  
可编程界面的输出 ZGK*]o=)  
cG1-.,r  

图片:1-1Q113230513340.png

*X8<hYKZq  
mwVH>3{j  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） C9`#57Pp  
pm$,B7Q`oO  
将自定义界面保存到目录中 
kKAK;JQ  
,pE{N&p9  

图片:1-1Q11323055K33.png

= q9>~E{}  
}&sF \b  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 GV#"2{t j  
TV\21  
故障排除提示 ' Z:FGSwT  
}+G6`Zd  

图片:1-1Q11323062S59.png

)D_#  
]f#ZU{A'mt  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ <
iVn!P  
[}q6bXM*  

图片:1-1Q113230A3617.png

W}#eQ|oCV  
:pj#t$:!  
测试代码! ~K]5`(KV  
Cp=DdmR  

图片:1-1Q113230G5391.png

"- @{ )  
n,}\;Bp  

图片:1-1Q113230I3W0.png

(@@t,\iF  
<o,]f E[  
文件信息 C-'n4AY^  
QxG:NN;jW  

图片:1-1Q113230K5B1.png

]+\;pb}bq  
{jO:9O@