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

摘要 {~g7&+9x*
 
6+s&%io4  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 I~"l9Jc!"  
=/ !A  

图片:1-1Q113224953T4.png

p ~+sk1[.  
MD4mh2  
可编程界面所在位置：目录 Ew{N2  
%%wngiz\  

图片:1-1Q11322501Y47.png

w+\RSqz/  
\b)P4aL  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 /@&uaw  
#^-'q`)  
可编程界面所在位置：组件 0}kvuuR  
<X1[j9Qtv0  

图片:1-1Q1132251523M.png

b*nI0/cbR.  
#:MoZw`rlw  
编写代码 5*B'e{C  
bgInIe
 
•右侧面板显示了可用的独立参数列表。 m<MN.R7  
•x和y表示独立变量，即平面上的2D坐标。
&Dp&  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 NY[48H  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 .Z17X_  
•使用Snippet Body将支持函数中的部分代码分组。 P=9sP:[f6  
7 X~JLvN  

图片:1-1Q1132253435R.png

geqx":gpx9  
$'a]lR  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 l,b_'
m@  
Ut2x4$9  
表面梯度的定义 jM'Fb.>~  
~ :B/`1[m  
•精确计算界面的梯度是光学仿真的基础。 p1z^i(  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 lrMkp@f.  
pG/g  

图片:1-1Q1132254294X.png

7:.!R^5H  
^#7&R"  
用户自定义的表面梯度 `E>o:tff  
GL&rT&  
; Oz p  
•右侧面板显示了相同的可用独立参数列表。 {N-*eV9#  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 w;Pe_m7\EO  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ U[@B63];0  
:f RGXrn  

图片:1-1Q113225625919.png

g-+/zEOUS  
U4e9[=q`'  
可编程界面的输出 \]L ha  
)YLZ"@  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 <|a9r: [  
•在有需要时，可在实际组件内直接编程自定义界面。 xz/G$7q7  
•或者，将其保存在目录中供后续使用。 fvDcE]_%H  
-dUXd<=ue  

图片:1-1Q113225FL09.png

YE@!`!`d:  
2|+4xqNJm  
对球形表面进行编程 J8`vk#5  
OadGwa\:s  
球形表面 -]MZP:s  
+$GP(Uu,  

图片:1-1Q113225P1295.png

16N`xw+{  
OgyHX>}bH  
可编程界面所在位置：目录 !AL?bW  
dC">AW  

图片:1-1Q113225ZY61.png

pkA(\0E8  
ZpU4"x>  
可编程界面所在位置：组件 \88IFE  
DTx>^<Tk  

图片:1-1Q11322592b42.png

?)+I'lW!  
Y{m1\s/o  
设置表面的定义区域 of.=n  
2wZyUB;  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。
7:S)J~s*O  
•在本例中，我们使用圆孔。 |F>'7JJJ  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ T(eNK c2  
g*:f#u5  

图片:1-1Q1132259514E.png

HBgt!D0MZ  
^(yU)k3pu  
进入可编程界面 sX
=_|<[  
Y3f2RdGl  

图片:1-1Q113230035R8.png

/=:X,^"P  
("@ih]zYf  
可编程界面：全局参数  qr7_3  
;KW}F|  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 -B#>Jn#F  
•在那里，添加和编辑一个参数： +P 9h%/Yk  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 *ps")?tlC  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 Y!nE65  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 Sc$]ar]S  
W6uz G  

图片:1-1Q11323011A22.png

\RyW#[(  
Z6r_T  
可编程界面：代码段帮助（Snippet Help） C+c;UzbD  
]1n =O"vE  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 2UjQ!g`  
•此选项对于使用可编程元素跟踪进度非常有用。 Gcu?xG{  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ D7b] ;Nf\  
IH'&W  

图片:1-1Q11323015HB.png

ZZ{:f+=?$  
"EC,#$e%ev  

图片:1-1Q113230325X3.png

,Tc598D  
$[8GFv  
可编程界面：编写代码 c4n]#((%a  
N;]"_
"  

图片:1-1Q113230354L2.png

Q>emyij  
2p|[yZ  
可编程界面：用户自定义梯度 JN-wToOF  
&7t3D?K'qX  

图片:1-1Q113230414a1.png

=;^#5dpt$  
可编程界面：使用您的代码段（Snippet） ^iaG>rvA  
r5N.Qt8  

图片:1-1Q113230441529.png

Zb=H\#T  
t#6@~49  
可编程界面的输出 3]1uDgfr  
F%pYnHr<  

图片:1-1Q113230513340.png

ht%:e?@i  
zDO`w0N  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） [1{uK&$e  
vEIDf{  
将自定义界面保存到目录中 ;y"quJ'O  
X8(, ,>_  

图片:1-1Q11323055K33.png

#^fDKM  
UFy"hJchO  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 jN43vHm\Y9  
<Sx-Ca7  
故障排除提示 z tLP {q#  
K7H`Yt  

图片:1-1Q11323062S59.png

Wp<4F6C$@  
w(KB=lA2  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ #4e Taik  
~ g\GC  

图片:1-1Q113230A3617.png

yBwgLn  
Spossp`|  
测试代码! hI{M?LQd  
-mlBr63Bj  

图片:1-1Q113230G5391.png

~]_gq;bG  
G'sEbw'[  

图片:1-1Q113230I3W0.png

fH/J8<  
')Drv)L  
文件信息 nDvj*lZF  
vf+GC*f  

图片:1-1Q113230K5B1.png

l|c#  
P
<@V