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

摘要 C`R<55x6  
F2Y!aR  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 f >.^7.is  
Q :.i[  

图片:1-1Q113224953T4.png

'4_c;](W  
F-$!e?,H  
可编程界面所在位置：目录 \KzH5?  
cK >^8
T^  

图片:1-1Q11322501Y47.png

TyjZ  
k>\v]&|T`  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 8t. QFze?  
fs?H  
可编程界面所在位置：组件 a#k7 aOT0  
4$WR8  

图片:1-1Q1132251523M.png

Oi zj|'  
\|6VGh \Z  
编写代码 <&#
MX  

f%i%QZP  
•右侧面板显示了可用的独立参数列表。 PXqG;o*Q*?  
•x和y表示独立变量，即平面上的2D坐标。 -Lu&bVt<>  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 [uK{``"  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 iPkCuLQ}  
•使用Snippet Body将支持函数中的部分代码分组。 #lg R"%  
' ,S}X\  

图片:1-1Q1132253435R.png

d^J)Mhju  
.6T0d 4,1  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 $d
Xx@6fP  
iPCCTs  
表面梯度的定义 q2s
0g*z  
".%d{z}vz  
•精确计算界面的梯度是光学仿真的基础。 :o .+<_&  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 awwSgy  
ZX64kk+
 

图片:1-1Q1132254294X.png

[`oVMR  
<e?Eva%t`  
用户自定义的表面梯度 8#VD u(  
S1I.l">P  
hxK;f  
•右侧面板显示了相同的可用独立参数列表。 ~D>pu%F  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 bc4V&  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ KbtV>  
W7 dSx  

图片:1-1Q113225625919.png

Z.u1Dz  
#CaPj:>
[  
可编程界面的输出 IhBc/.&RL  
E_aBDiyDf  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 6[4VbIBSI  
•在有需要时，可在实际组件内直接编程自定义界面。 AB`.K{h  
•或者，将其保存在目录中供后续使用。 {x.0Yh7  
5.oIyC^Ik  

图片:1-1Q113225FL09.png

8\!E )M|4  
Y}v3
J(l  
对球形表面进行编程 Hj|&P/jY]*  
TKv!wKI  
球形表面 w$6Z}M1d  
3,Yr%`/5'  

图片:1-1Q113225P1295.png

n\l?+)S *  
|[IyqWG9  
可编程界面所在位置：目录 #}FUau$  
z__?kY  

图片:1-1Q113225ZY61.png

QJRnpN/
 
Tk4>Jb  
可编程界面所在位置：组件 "mf$E|  
=uH2+9.  

图片:1-1Q11322592b42.png

L;%w{,Ji  
twq~.:<o  
设置表面的定义区域 MCmb/.&wu  
!43!JfD  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 %g}d}5s  
•在本例中，我们使用圆孔。 KDq="=q  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ ^]nLE]M  
Rbf6/C  

图片:1-1Q1132259514E.png

3@Mh* \;\b  
5tQz!M  
进入可编程界面 mGj)Zrx>  
O*~z@"\  

图片:1-1Q113230035R8.png

o+A1-&qhN  
hOUH1m.  
可编程界面：全局参数 eMC^ORdY  
31a,i2Q4  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 "mW'tm1+  
•在那里，添加和编辑一个参数： )*;Tt @'y  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 B/1j4/MS  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 DFK@/.V  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 M`H#Qo5/  
SQ_?4 s::  

图片:1-1Q11323011A22.png

,G

t!nm_  
{,Q)D$i  
可编程界面：代码段帮助（Snippet Help） FnA Kfh(  
)}`z<)3jP  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 }}=n]_f  
•此选项对于使用可编程元素跟踪进度非常有用。 7H  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ T,pr&1]Lw  
FfJp::|ddr  

图片:1-1Q11323015HB.png

WzN c=@[W  
{Ya$Q#l  

图片:1-1Q113230325X3.png

WMf / S"=  
S} m=|3%y  
可编程界面：编写代码 tb+gCs'D  
J[ Gpd  

图片:1-1Q113230354L2.png

l#KcmOz  
5qtk#FB  
可编程界面：用户自定义梯度 Xfq`k/ W  
JX=rL6Y@:;  

图片:1-1Q113230414a1.png

szsVk#p  
可编程界面：使用您的代码段（Snippet） cmG27\cRO  
_YF>Y=D-  

图片:1-1Q113230441529.png

@ep.wW  
&)1.z7T  
可编程界面的输出 4^L;]v,|7  
<T}U 3lL^  

图片:1-1Q113230513340.png

2X@9o4_4q  
rFg$7  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） ,<
rC,4-F<  
`MOw\Z)..  
将自定义界面保存到目录中 @sLN  
=OHX5:Z  

图片:1-1Q11323055K33.png

&jF'2D^_  
I@cw=_EQL  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 *4U_MM#rX  
I`V<Sh^Qd  
故障排除提示 9p W~Gz  
= j1Jl^[  

图片:1-1Q11323062S59.png

%GhI0F #  
~XTC:6ts  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ Tz @=N]D  
"]S  

图片:1-1Q113230A3617.png

8Sr'  
duY?LJ@g  
测试代码! 4Hj)Av<O(  
z{rV|vQ  

图片:1-1Q113230G5391.png

GTP'js  
tAAMSb9[d  

图片:1-1Q113230I3W0.png

!?P8[K  
'C'mgEl%L  
文件信息 NU=ru/  
xb,d,(^]R  

图片:1-1Q113230K5B1.png

}4|EHhG  
xe!bfzU