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

摘要 + Q $Jq  
YhZmyYamE  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 nWyn}+C-  
b!pG&7P  

图片:1-1Q113224953T4.png

(B0tgg^jj,  
t:SME'~.P  
可编程界面所在位置：目录 k9'`<82Y  
NJe^5>4`  

图片:1-1Q11322501Y47.png

/c>@^  
S(c&XJR  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 E\X:VQ9  
G<8d=}  
可编程界面所在位置：组件 oaK&!$S]  
K).Gj2 $  

图片:1-1Q1132251523M.png

Oh|KbM*vS  
TsvF~Gdp  
编写代码 _>k&,p]y  
g aq"+@fH  
•右侧面板显示了可用的独立参数列表。 HqZ3]  
•x和y表示独立变量，即平面上的2D坐标。 !n?8'eqWru  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 HZ+l){u  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 kt0ma
/QpP  
•使用Snippet Body将支持函数中的部分代码分组。 6UXDIg=  
qkg`4'rLg  

图片:1-1Q1132253435R.png

"E6*.EtTN#  
da,Bnze0  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 \MY`R  
_UqE -+&  
表面梯度的定义 j\uh]8N3<  
_T{ "F  
•精确计算界面的梯度是光学仿真的基础。 { +$zgg  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 Q8~|0X\
.g  
-%g$~MZ?'  

图片:1-1Q1132254294X.png

Ow@}6&1  
"s!|8F6$  
用户自定义的表面梯度 t.ci!#/d  
uE]kv  
-fB;pS,  
•右侧面板显示了相同的可用独立参数列表。 V*C%r:5 ,v  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 lDV}vuM<4  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ k|SywATr  
==?!z<I.d  

图片:1-1Q113225625919.png

UrP jZ:K'  
X>$s>})Y  
可编程界面的输出 G%RL8HU  
w`Ss MI  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 zIeJ[J@  
•在有需要时，可在实际组件内直接编程自定义界面。 nc.(bb),  
•或者，将其保存在目录中供后续使用。 q9^6A90  
3rUuRsXn  

图片:1-1Q113225FL09.png

eL`}j9  
\D<w:\P  
对球形表面进行编程 /
ta5d;
@  
,*r}23  
球形表面 ]nM 2J}7  
zBKfaQI,  

图片:1-1Q113225P1295.png

DA(ur'D  
v"K #  
可编程界面所在位置：目录 I8s%wY9  
z5|m`$gy  

图片:1-1Q113225ZY61.png

xeGl}q|  
:CR1Oy9  
可编程界面所在位置：组件
WA$Ug  
_>LI[yf{  

图片:1-1Q11322592b42.png

'WC> _L  
b;O@|HK&~  
设置表面的定义区域 ayR;|S  
L#}HeOEi[  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 uYu/0fQD  
•在本例中，我们使用圆孔。 Jj:Bi&C  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ UgBD|~zu  
0YApaL+jt  

图片:1-1Q1132259514E.png

] C&AU[U*  
&W|r P(
 
进入可编程界面 fEMz%CwH  
4uV,$/  

图片:1-1Q113230035R8.png

kYl')L6  
L4x08 e  
可编程界面：全局参数 c'XvZNf .C  
'/[9Xwh9  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 v Wt{kg;  
•在那里，添加和编辑一个参数： kR1dk4I4  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 e+? -#  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 pT;{05  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 #zL0P>P'a  
&|%F=/VU  

图片:1-1Q11323011A22.png

,m08t9F  
nbhzLUK  
可编程界面：代码段帮助（Snippet Help） "4,Zox{^  
9_07?`Jr  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 VY#:IE:T  
•此选项对于使用可编程元素跟踪进度非常有用。 |rhCQ"H  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ $zR[2{bg  
p^(gXzW  

图片:1-1Q11323015HB.png

]\8
{z"  
[&B}{6wry  

图片:1-1Q113230325X3.png

B\ITXmd   
`n{yls7.  
可编程界面：编写代码 MUeS8:q-N  
!K~L&.\T  

图片:1-1Q113230354L2.png

|K jy4.2  
ENEnHu^  
可编程界面：用户自定义梯度 TfFuHzZZ  
bB#6Xx  

图片:1-1Q113230414a1.png

+1]xmnts  
可编程界面：使用您的代码段（Snippet） 1,/L&_=_A  
r8uc.z2%  

图片:1-1Q113230441529.png

NyTGvBf  
Y>N`(  
可编程界面的输出 ,M)NC%0X  
a BHV  

图片:1-1Q113230513340.png

1q&gTvIp  
3o>.Z;  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） G.}Ex!8R7_  
_&~y{;)S  
将自定义界面保存到目录中 `B4Px|3  
G|"`kAa  

图片:1-1Q11323055K33.png

Ijs"KAW ?  
UhX`BGpM{  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 02EbmP  
pR VL}^Rk  
故障排除提示 `c-(1;Jb  
o (OC3  

图片:1-1Q11323062S59.png

?pLKUAh  
X`QfOs#\  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ q%/ciPgE  
wU|Y`wJmF  

图片:1-1Q113230A3617.png

9m:qQ1[\  
*"%MT:  
测试代码! NyJ=^=F#  
>;ucwLi  

图片:1-1Q113230G5391.png

j+p=ik  
XP$1CWI  

图片:1-1Q113230I3W0.png

lk5}bnd5  
0k];%HV|  
文件信息 @+S5"W  
8+b ?/Rn0  

图片:1-1Q113230K5B1.png

:h|nV ~  
D-zqu~f`