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

摘要 ?45kN=%*s  
F_ ~L&jHP  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 ?2VY^7N[  
ag^L' h$  

图片:1-1Q113224953T4.png

N=K|Nw  
eqcV70E8cK  
可编程界面所在位置：目录 lkf(t&vL2  
aG7
QLCL  

图片:1-1Q11322501Y47.png

aH)$#6${Ap  
eR r.j  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 !|`G<WD  
[B9'/:  
可编程界面所在位置：组件 4l2i'H  
;aBK4<-vl  

图片:1-1Q1132251523M.png

.$+]N[-=  
OKfJ  
编写代码 Ec| Gom?  
kVs'>H@FY  
•右侧面板显示了可用的独立参数列表。 >{i/LC^S  
•x和y表示独立变量，即平面上的2D坐标。 b:.aZ7+4  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 A87JPX#R?  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 ig:/60Z  
•使用Snippet Body将支持函数中的部分代码分组。 &Zl$7  
d3h2$EDD  

图片:1-1Q1132253435R.png

uR{HCZ-  
I*R[8|  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 '3Yci(t+  
@'U9*:}U  
表面梯度的定义 _^Lv8a3(O  
*vFVXJ
o  
•精确计算界面的梯度是光学仿真的基础。 Z]l<,m  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 }}XYV eI  
edhNQWn  

图片:1-1Q1132254294X.png

)W)m?%  
5k.NZ  
用户自定义的表面梯度 m"\jEfjO  
{dJC3/Rf  
a&~_ba+  
•右侧面板显示了相同的可用独立参数列表。 DGr{x}Kq  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 1g6AzUXg  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ Z^,C><Yt  
2bxkZS]  

图片:1-1Q113225625919.png

U>6MT@\  
$$~
x: iN  
可编程界面的输出 Eq^k@  
X-9>;Mb~y  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 n'=-bj`  
•在有需要时，可在实际组件内直接编程自定义界面。 y0>as
l  
•或者，将其保存在目录中供后续使用。 Mk"+*G  
?-0k3  

图片:1-1Q113225FL09.png

VTySKY+  
{~>?%]tf  
对球形表面进行编程 6 ]W!>jDc  
xc[@lr  
球形表面 w\k|^  
t9SzZ2E  

图片:1-1Q113225P1295.png

{]<l|qK  
I&]d6,  
可编程界面所在位置：目录 aYr?J Ol  
Kdk0#+xtP  

图片:1-1Q113225ZY61.png

PHl{pE*  
RvKP&  
可编程界面所在位置：组件 "l!WO`.zp=  

.GUm3b  

图片:1-1Q11322592b42.png

t m?[0@<s  
zF6R\w  
设置表面的定义区域 yjUZ40Dq  
c
jt<&b*  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 F,Q\_H##x4  
•在本例中，我们使用圆孔。 $Z6g/bD`E  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ py.lGywb_  
[2#5;')  

图片:1-1Q1132259514E.png

K,e"@G  
}#'wy  
进入可编程界面 "OF4#a17  
Ig75bZz   

图片:1-1Q113230035R8.png

\Km!#:  
P:h
;"  
可编程界面：全局参数 :+{G|goZ*  
'^ bB+  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 JP`$A  
•在那里，添加和编辑一个参数： rF:C({y  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 
;q]Jm  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 +aaj3m  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 qp_lMz  
b/'{6zn  

图片:1-1Q11323011A22.png

A^:[+PJHN  
\7PPFKS  
可编程界面：代码段帮助（Snippet Help） fe PH=C  
 H"czF  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 2g~qVT,  
•此选项对于使用可编程元素跟踪进度非常有用。 -SZXUN  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ a5=8zO#%g  
<WFA3  

图片:1-1Q11323015HB.png

52?zBl`|  
q/U(j&8W{  

图片:1-1Q113230325X3.png

koOkm:(,  
OE
' ?3S  
可编程界面：编写代码 jGpSECs  
Oxs O  

图片:1-1Q113230354L2.png

zaWy7@?  
F: %-x=q  
可编程界面：用户自定义梯度 yO*~)ALb+  
it]im  

图片:1-1Q113230414a1.png

FsQeyh>  
可编程界面：使用您的代码段（Snippet） .j?`U[V%a  
I?`}h}7.  

图片:1-1Q113230441529.png

!>QS746S@  
-n&g**\w  
可编程界面的输出 ]D?//  
FjRt'  

图片:1-1Q113230513340.png

_:@~bHd  
Q#"p6ZmI  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） j1{|3#5V  
?>c*[>LpZ  
将自定义界面保存到目录中 xxjg)rVuy  
-]""Jl^  

图片:1-1Q11323055K33.png

sd4eJ  
p}q27<O*/  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 HJ#3wk"W  
<vMna< /d  
故障排除提示 Qn=3b:S-  
Zoe>Ow8mE`  

图片:1-1Q11323062S59.png

9V
&}%  
,=sbK?&  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ O/g|E47  
PWeCk2xH  

图片:1-1Q113230A3617.png

 x{K^u"  
EmrUzaGD  
测试代码! ?LJ$:u  
*+(t2!yFmE  

图片:1-1Q113230G5391.png

EUBJnf:q  

p7 s#j  

图片:1-1Q113230I3W0.png

=KQQS6  
3#GZ6:rVJ  
文件信息 &\<!{Y<'  
337
y,;  

图片:1-1Q113230K5B1.png

HIiMq'H^  
B ~u9"SR.