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

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

图片:1-1Q113224953T4.png

? A#z~;X@  
C
Y).I`aJ  
可编程界面所在位置：目录 ;WAu]C|  
%Kfa|&'zV  

图片:1-1Q11322501Y47.png

ds[Z=_Ll  
(X7yNIPfA  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 {}C7VS1  
v%7JZ<I'A  
可编程界面所在位置：组件 5'Ay@FJ:  
&+{xR79+&  

图片:1-1Q1132251523M.png

gV44PI6h  
_,?HrL9  
编写代码 0m!ZJHe  
nMoF;AdKm  
•右侧面板显示了可用的独立参数列表。 Fl>j5[kLZ  
•x和y表示独立变量，即平面上的2D坐标。 $I0a2Z=dP  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 KQZRzX>0  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 )3\rp$]1  
•使用Snippet Body将支持函数中的部分代码分组。 2}Plr{s9  
;S27m]Q?  

图片:1-1Q1132253435R.png

;B7|tajd  
>Ez}r(QQ^  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 128 rly  
Cr
X-
?$  
表面梯度的定义 ^a5~FI:  
i1&noRGl  
•精确计算界面的梯度是光学仿真的基础。 g^^m a}i  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 ,^66`C[G  
(xJBN?NRO  

图片:1-1Q1132254294X.png

oqo8{hrdHk  
tl^;iE!-  
用户自定义的表面梯度 9>, \QrrH  
vKLG9ovlY  
/ ^M3-5@Q  
•右侧面板显示了相同的可用独立参数列表。 dsoRPX']=  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 ;.m[&h 0  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ HY#("=9< h  
dM.Ow!j  

图片:1-1Q113225625919.png

93b5S>&r  
]>!_OCe&  
可编程界面的输出 |8+rUFkU8  
b|'LtL$Y  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 bbA<Zp  
•在有需要时，可在实际组件内直接编程自定义界面。 md_s2d  
•或者，将其保存在目录中供后续使用。 sW`iXsbWM>  
oYm"NDS_.  

图片:1-1Q113225FL09.png

C>-"*Lt  
Ps,w(k{d  
对球形表面进行编程 ViONG]F  
P9~kN|  
球形表面 `u)V9{  
Ok"wec+,  

图片:1-1Q113225P1295.png

Gwk@X/q  
V:
npcKpu  
可编程界面所在位置：目录 IiU|@f~k  
1x8]&  

图片:1-1Q113225ZY61.png

+eat,3Ji  
xBd%e-r  
可编程界面所在位置：组件 wQ95tN  
O3^@"IY  

图片:1-1Q11322592b42.png

I*t}gvUt9  
artS*fv3r  
设置表面的定义区域 UcIR0BYa  
v0pEN\  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 E$baQU hKS  
•在本例中，我们使用圆孔。 U_04QwhK7  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ ON^u|*kO  
g-`NsqzD  

图片:1-1Q1132259514E.png

!b Km}1T  
z}|'&O*.F  
进入可编程界面 o{eG6  
iE{SqX  

图片:1-1Q113230035R8.png

3?<vnpN=5d  
;">hCM7  
可编程界面：全局参数 IEj`:]d  
={d\zjI$  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 gNBI?xs`p  
•在那里，添加和编辑一个参数： D=+sD"<|  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 8Aqe'2IH=  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 e hGC N=  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 D-/A>  
$NSYQF%aO  

图片:1-1Q11323011A22.png

&'j77tqOk  
\^D`Hvg  
可编程界面：代码段帮助（Snippet Help） A#{*A  
-A~<IyPt  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 F.6SX (x  
•此选项对于使用可编程元素跟踪进度非常有用。 #YV;Gp(2h  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ P^r8JhDJ  
36z{TWF  

图片:1-1Q11323015HB.png

LNWp$"  
(nG  

图片:1-1Q113230325X3.png

@A%`\Ea%   
MiI7s;  
可编程界面：编写代码 jLU)S)  
3Hr%G4  

图片:1-1Q113230354L2.png

^YV[1~O  
_,QUH"
  
可编程界面：用户自定义梯度 ^  +G> N  
s4\2lBU?  

图片:1-1Q113230414a1.png

#k6T_
ki  
可编程界面：使用您的代码段（Snippet） 1U!CD-%(  
:nn'>  

图片:1-1Q113230441529.png

U/;Vge8{  
mv_-|N~  
可编程界面的输出 7(-<x@e  
K,Vl.-4?  

图片:1-1Q113230513340.png

]](hwj  
J=Z"sU=  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） 3FfS+q*3S  
L!RLw4   
将自定义界面保存到目录中 6\
L,L
&  
{1mD(+pJ{  

图片:1-1Q11323055K33.png

~PH
G5?X  
f3O'lc3  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 A.Njn(z?Lz  
'DPSM?]fA  
故障排除提示 GOjri  
pbNVj~#6  

图片:1-1Q11323062S59.png

OmW|\d PU  
Tu"](|I>   
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ ;3_'{  
.#SWfAb2h  

图片:1-1Q113230A3617.png

rx<fjA%  
p
E#0949  
测试代码! 4R.#=]F  
!nVuvsbv  

图片:1-1Q113230G5391.png

-Cl0!}P4I  
! d(,t[cV  

图片:1-1Q113230I3W0.png

l%fl=i~oN  
qohUxtnTK>  
文件信息 wiZK-#\x  
"xKJ?8   

图片:1-1Q113230K5B1.png

BQ(`MM@  
6b0#z#E