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

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

图片:1-1Q113224953T4.png

.sbU-_ij@U  
ngsa
x1xO  
可编程界面所在位置：目录 >QE^KtZ  
ojs&W]r0Z  

图片:1-1Q11322501Y47.png

_-%ay  
>-s}1*^=oD  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 j+Y4>fL$  
8MX/GF;F  
可编程界面所在位置：组件 _a+0LTo".  
N5}vy$t_P  

图片:1-1Q1132251523M.png

AU^Wy|i5Q  
[l-zU}u&v  
编写代码 Rb#Z'1D'G  
)_GM&-  
•右侧面板显示了可用的独立参数列表。 ]1)@.b;QR  
•x和y表示独立变量，即平面上的2D坐标。 >, 234ab=d  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 }sPY+ZjV  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 \CUxGyu  
•使用Snippet Body将支持函数中的部分代码分组。 i#kRVua/  
yZ0;\Tr*J  

图片:1-1Q1132253435R.png

XhWMvme  
^nbze  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 Jgtvia  
z9w@-])  
表面梯度的定义 Mky$#SI11  
zesEbR)j  
•精确计算界面的梯度是光学仿真的基础。 <Ks?g=K-  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 /D1Bf:'(  
zHb<YpU  

图片:1-1Q1132254294X.png

0qG[hxt%  
d2.n^Q"?3  
用户自定义的表面梯度 <'P|g  
GVn
9=[r
 
+ {a  
•右侧面板显示了相同的可用独立参数列表。 &\<RVE  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 :vurU$
\  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ ,yV pB)IQ  
?z:xQ*#X  

图片:1-1Q113225625919.png

^z[s;:-  
]3d&S5zU  
可编程界面的输出 LTzf&TZbx5  
/ sH*if  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 Mh~T.;f.qq  
•在有需要时，可在实际组件内直接编程自定义界面。 $XyGCn  
•或者，将其保存在目录中供后续使用。 R)<Fqa7Tm  
hZ2PP ^  

图片:1-1Q113225FL09.png

cb'8Li8,j  
X){F^1CT{  
对球形表面进行编程 PDD` eK}Fj  
})mez[UmZ  
球形表面 ?ZDx9*f  
(/k,q  

图片:1-1Q113225P1295.png

Q=^}B}G  
Xo%Anqk  
可编程界面所在位置：目录 6bHj<6>MX  
Rx`0VQ  

图片:1-1Q113225ZY61.png

h(G&X9*  
< "~k8:=4  
可编程界面所在位置：组件 n8:2Z>  
Cs
]x
s9  

图片:1-1Q11322592b42.png

P92:}" )*>  
"H G:by  
设置表面的定义区域 zEO 9TuBO  
!^8'LMY<I  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 KpwUp5K  
•在本例中，我们使用圆孔。 Ei}DA=:s  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ vm4]KEyrX  
.S?,%4v%%  

图片:1-1Q1132259514E.png

/OxF5bN2  
(qPZEZKx  
进入可编程界面 8i:b~y0  
"UAW  

图片:1-1Q113230035R8.png

58v5Z$%--  
R0/~) P  
可编程界面：全局参数 \[D"W{9l  
koqH~>ZtD  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 2l\Oufer"  
•在那里，添加和编辑一个参数： K} ;uH,  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 X;6X K$"  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 GbL,k?ey  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 7gJy xQ  
GGLVv)  

图片:1-1Q11323011A22.png

\lY26'  
~?L. n:wu  
可编程界面：代码段帮助（Snippet Help） F[?t"d  
[n:R]|^a  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。
$}\.)^[}  
•此选项对于使用可编程元素跟踪进度非常有用。 fqF1-%  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ pkxW19h*0  
?iia  

图片:1-1Q11323015HB.png

Sk1yend4  
q-!m|<Z  

图片:1-1Q113230325X3.png

(TY^ kySr  
kwyvd`J8  
可编程界面：编写代码 xknP `T  
wiFckF/  

图片:1-1Q113230354L2.png

3gGF?
0o  
}2h~o~  
可编程界面：用户自定义梯度 ZAiQofQ:2  
J7l1-  

图片:1-1Q113230414a1.png

ml3]CcKn  
可编程界面：使用您的代码段（Snippet） 9^aMmN&6N2  
@|cas|U.r  

图片:1-1Q113230441529.png

4)"jg[  
"urQUpF  
可编程界面的输出 t=yM}#r$  
U,+=>ns>  

图片:1-1Q113230513340.png

n\P{Mc  
M"V?fn'  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） R"82=">v  
@,s[l1P  
将自定义界面保存到目录中 SYC_=X  
Wm"W@LPx5  

图片:1-1Q11323055K33.png

V= .'Db2D  
$Itehy  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 :Tjo+vw7$H  
ikofJl]9  
故障排除提示 Q*lZ;~R  
_$F I>  

图片:1-1Q11323062S59.png

EmH2 Dbw  
K\;
b3  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ 0mCrA|A.  
tt`b+NOH>  

图片:1-1Q113230A3617.png

8WaVs6  
@=@WRPGM*9  
测试代码! fc&4e:Ve  
Rr:,'cXGi  

图片:1-1Q113230G5391.png

%*Y:Rm'>  
g y&B"`  

图片:1-1Q113230I3W0.png

c"fnTJXr79  
A3h[VnuG,  
文件信息 ,!Q2^R  
*xt3mv/<z  

图片:1-1Q113230K5B1.png

'GNT'y_  
<S5Am%vo