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

摘要 |Y?<58[!)  
n5;@}Rai  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 QcJC:sP\>  
!%$,S=_F  

图片:1-1Q113224953T4.png

Uq`6VpZ  
g4YlG"O[~  
可编程界面所在位置：目录 HF"TS*  
\S1W,H|  

图片:1-1Q11322501Y47.png

%*o  
6RguUDRQ  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 SlHDBr!.z  
sv!v`zh  
可编程界面所在位置：组件 6 EfBz  
g^x=y  

图片:1-1Q1132251523M.png

UFu0{rY_  
H=w):kL|  
编写代码 2`j{n\/  
0pG +yec  
•右侧面板显示了可用的独立参数列表。 ^,FG9  
•x和y表示独立变量，即平面上的2D坐标。 `'>~(8&zE  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 uA;#*eiA/  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 #XB3Wden2  
•使用Snippet Body将支持函数中的部分代码分组。 7a^D[f0V  
6VuyKt  

图片:1-1Q1132253435R.png

;yyR_NS  
:I7mMy*  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 1P'A*`!K  
[\Nmm4  
表面梯度的定义 12?!Z  
#:P$a%V  
•精确计算界面的梯度是光学仿真的基础。 Km!ACA&s6  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 VBS}2>p  
60cQ3.e  

图片:1-1Q1132254294X.png

Gqc6]{  
*9xxX,QT8Q  
用户自定义的表面梯度 jT< I`K*  
Di27=_J  
Q672iR\#)  
•右侧面板显示了相同的可用独立参数列表。 43-Bx`6\  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 g5"I{ol5T~  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ I8% -ii  
9_F&G('V{a  

图片:1-1Q113225625919.png

*OdmKVw6G  
,4`Vl<6  
可编程界面的输出 7R m\#  
w{|`F>f9  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。  8y  
•在有需要时，可在实际组件内直接编程自定义界面。 D&I/Tbc  
•或者，将其保存在目录中供后续使用。 !Ur
.b @ke  
:
T?WN+3  

图片:1-1Q113225FL09.png

jkta]#O  
54JZOtC3~  
对球形表面进行编程 'q_Z dw%  
%'_:#!9  
球形表面 }9
W[7V?  
Ha/Qz'^S;  

图片:1-1Q113225P1295.png

l4.ql1BX@y  
JZ![:$:  
可编程界面所在位置：目录 !g6=/9  
&JKQH  

图片:1-1Q113225ZY61.png

S[yrGX8lu  
i+in?!@G:  
可编程界面所在位置：组件 T3<1{"&  
Ejr'Yzl3_  

图片:1-1Q11322592b42.png

wB'!@>db  
%
4F\#" A  
设置表面的定义区域 [tJn!cMs  
OFmHj]I7=  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 xV`l6QS  
•在本例中，我们使用圆孔。 On~KTt3Mp  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ ks6iy}f7  
hGw}o,g  

图片:1-1Q1132259514E.png

G4P*U3&p  
3**t'iWQ  
进入可编程界面 y!}XlllV  
1 I.P7_/  

图片:1-1Q113230035R8.png

8#tuB8>  
^b`-zFL7  
可编程界面：全局参数 r-L& ee  
^BRqsVw9  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 "*j8G8  
•在那里，添加和编辑一个参数： @Lf&[_  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 @x}^2FE  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 :[(%4se  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 ~|Ln9f-g  
p=A,yGDV  

图片:1-1Q11323011A22.png

cN?/YkW?]  
j<~T:Tk  
可编程界面：代码段帮助（Snippet Help） 0gW{6BtPWm  
ma@V>*u  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 [kqtkgK$j2  
•此选项对于使用可编程元素跟踪进度非常有用。 ~Js kA5h|&  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ &fWC-|  
CadIux^  

图片:1-1Q11323015HB.png

trrK6(p  
_izjvg  

图片:1-1Q113230325X3.png

Iy4%,8C]g  
IzUpkwN  
可编程界面：编写代码 ~8mz.ZdY  
`[#id@
Z1  

图片:1-1Q113230354L2.png

0L8fpGJ  
! }e75=x  
可编程界面：用户自定义梯度 U*\K<fw   
5Rs#{9YE  

图片:1-1Q113230414a1.png

X<Cfy  
可编程界面：使用您的代码段（Snippet） K$qY^oyQFw  
N6u>V~i  

图片:1-1Q113230441529.png

qwJp&6  
NQ[X=a8N  
可编程界面的输出 ~&RrlFh  
G'}N?8s1  

图片:1-1Q113230513340.png

>K4Nn(~ys  
`o }+2Cb  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） .*9u_2<  
[:gg3Qzx  
将自定义界面保存到目录中 lOeX5%$Z  
[?9 `x-Q  

图片:1-1Q11323055K33.png

bQq/
~  
$.d,>F6  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 ]>Z9K@  
uI?Z_  
故障排除提示 fR@Cg sw  
ovM;6o  

图片:1-1Q11323062S59.png

Op]*wwI*h  
P;z\vq<h  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ nr -< mQ  

6.
KEe^[-  

图片:1-1Q113230A3617.png

\ HUDZ2 s  
1Hr1Ir<KR  
测试代码! 1|xe'w{  
_z BfNz9D  

图片:1-1Q113230G5391.png

Udtz zka  
XLaD#J  

图片:1-1Q113230I3W0.png

d^6-P R_  
]j
VE
 
文件信息 "p;tj74O9  
L YB@L06a  

图片:1-1Q113230K5B1.png

$"|r7n5[  
F$ G)vskd