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

摘要 9 }|Bs=q  
5|NM]8^^0[  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 xO9,,w47  
FT/H~|Z>  

图片:1-1Q113224953T4.png

g10$pf+L  
!sEI|
47{  
可编程界面所在位置：目录 b.47KJzt  
[{6]iJ  

图片:1-1Q11322501Y47.png

EyI 9$@4  
`(H]aTLt ,  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 I?J$";A  
6=Kl[U0Y  
可编程界面所在位置：组件 fU!C:  
VvSD&r^qI  

图片:1-1Q1132251523M.png

,[,+ _A  
J*U,kyYF  
编写代码 3%{XJV  
}h5pM`|1  
•右侧面板显示了可用的独立参数列表。 "Vho`x3  
•x和y表示独立变量，即平面上的2D坐标。 PDREwBX  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 /XEcA5C<  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 5aL0N  
•使用Snippet Body将支持函数中的部分代码分组。 Cq !VMl>hP  
6|X  

图片:1-1Q1132253435R.png

{G&K_~Vj  
g % q7  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 S"CsY2;  

7SoxsT)  
表面梯度的定义 }EE  
9Vxsv*OR,  
•精确计算界面的梯度是光学仿真的基础。 xVuGeanCv  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 jeN_ sm81b  
%((F}9_6  

图片:1-1Q1132254294X.png

(:,N?bg  
#E5Sc\,  
用户自定义的表面梯度 fxI>FhU_  
D}HW7Hnu^  
~d/Doi  
•右侧面板显示了相同的可用独立参数列表。 $ n`<,;^l  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 w?Nvm?_]  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ %LXk9K^]e  
c;Hf+n  

图片:1-1Q113225625919.png

+NxEx/{  
64#~p)  
可编程界面的输出 BEg%u)"([  
W|G(x8  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 ^.mQ~F  
•在有需要时，可在实际组件内直接编程自定义界面。 r|fJ~0z  
•或者，将其保存在目录中供后续使用。 kFHqQsaG  
1oFU4+{ 4  

图片:1-1Q113225FL09.png

'dQ2"x?4  
702&E(rx,  
对球形表面进行编程 ul(1)q^  
8 fVI33  
球形表面 `dMOBYV  
U.crRrN  

图片:1-1Q113225P1295.png

uWG'AmK_#E  
tU!"CX  
可编程界面所在位置：目录 xh#ef=Bw  
q_g'4VZv  

图片:1-1Q113225ZY61.png

8|dlt$  
7xVI,\qV  
可编程界面所在位置：组件
jsf=S{^2  
<&8cq@<  

图片:1-1Q11322592b42.png

:)q/8 0@  
-tF5$pb'  
设置表面的定义区域 D(~6h,=m  
/]>&OSV  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 v8y77:  
•在本例中，我们使用圆孔。 {p9y{$  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ /6gqpzum4  
b^
y#.V.|k  

图片:1-1Q1132259514E.png

BpDf4
)|  
NrgN{6u;  
进入可编程界面 AQbbIngo  
4L^KR_h/  

图片:1-1Q113230035R8.png

3`n5[RV  
TcpD*%wW  
可编程界面：全局参数 f>\?\!  
ah"2^x  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 .o:Pe2C  
•在那里，添加和编辑一个参数： 6y%BJU.I  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 gpHI)1i'H  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 6.Ef
M^[  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 >pv~$  
j &,vju  

图片:1-1Q11323011A22.png

M7eO
5  
oE"!  
可编程界面：代码段帮助（Snippet Help） 6IPhy.8  
e|):%6#  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 +TpM7QaL  
•此选项对于使用可编程元素跟踪进度非常有用。 Fu )V2[TY  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ @-kzSm  
G&/}P$  

图片:1-1Q11323015HB.png

m3F.-KPO  
5EFow-AH  

图片:1-1Q113230325X3.png

<Sm=,Sw  
C(}9  
可编程界面：编写代码 ^^jF*)DT@  
H3QAIsGS  

图片:1-1Q113230354L2.png

@D9c  
? 4qN>uW=  
可编程界面：用户自定义梯度 ? RB~%^c!  
_<pG}fmR  

图片:1-1Q113230414a1.png

67 7p9{:  
可编程界面：使用您的代码段（Snippet） ]o6yU#zn~e  
u 6la  

图片:1-1Q113230441529.png

5>KAVtYvc  
mrqC
W]#u  
可编程界面的输出 .oaW#f}0P  
-R~;E[ {%  

图片:1-1Q113230513340.png

WE|L{  
q jDWA'  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） 1 YMaUyL 1  
6M"J3\ x  
将自定义界面保存到目录中 j:) (`  
z|+L>O-8  

图片:1-1Q11323055K33.png

@o9EX }
 
_#f/VE  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 |]+m<Dpyr2  
?F AsV&y  
故障排除提示 9^v|~f  
rU<  H7U  

图片:1-1Q11323062S59.png

o$d;
Y2K  
%lv2
;-  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ w]tv<U={  
n_$l
RX5  

图片:1-1Q113230A3617.png

eJ'2CM6  
DXSZ#^,S[W  
测试代码! w,eYrxR|N  
gWy2$)  

图片:1-1Q113230G5391.png

r.-NfK4  
C.8]~MP  

图片:1-1Q113230I3W0.png

[%P_ Y/  
y"e'Gg2  
文件信息 .A\9|sRZ5  
%3fHitCikc  

图片:1-1Q113230K5B1.png

\
dIIZSN  
0u'2f`p*