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

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

图片:1-1Q113224953T4.png

|SSSH  
Hzz %3}E  
可编程界面所在位置：目录 '<)n8{3Q5w  
;ef}}K  

图片:1-1Q11322501Y47.png

:eCwY  
ML 9' |  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 I$G['`XX/  
V2EUW!gn 2  
可编程界面所在位置：组件 K@]4g49A/j  
J*A,o~U|  

图片:1-1Q1132251523M.png

V=l0(03j~  
G~a ZJ,  
编写代码 {S)6;|ua'  
Q3~H{)[Kq  
•右侧面板显示了可用的独立参数列表。 Hvi49c]]  
•x和y表示独立变量，即平面上的2D坐标。 &6!)jIWJ  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 *N<]Xy@  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 g:@#@1rB6  
•使用Snippet Body将支持函数中的部分代码分组。 (5YM?QAd  
sll\g  

图片:1-1Q1132253435R.png

h;"4+uw  
Sz`,X0a  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 2]*OQb#O6e  
!;A\.~-!G  
表面梯度的定义 $h"\N$iSq  
PC8Q"O  
•精确计算界面的梯度是光学仿真的基础。 ^^$s%{ep"  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 tDcT%D {:  
@S;'@VC  

图片:1-1Q1132254294X.png

JH9J5%sp  
Rhs/3O8k  
用户自定义的表面梯度 bAqA1y3=  
iYoMO["X  
FW4<5~'  
•右侧面板显示了相同的可用独立参数列表。 6nvz8f3*r]  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 C,r;VyW6BI  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ f$$/H>MJ  
tyFzSrfc  

图片:1-1Q113225625919.png

J*M>6Q.)  
#;yZ  
可编程界面的输出 n_A3#d<9  
gwMNYMI  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 r,p%U!S<hV  
•在有需要时，可在实际组件内直接编程自定义界面。 S,UDezxg  
•或者，将其保存在目录中供后续使用。 +r2-S~f3N  
XRi8Gpg  

图片:1-1Q113225FL09.png

kDxFloK  
g) jYFfGfH  
对球形表面进行编程 Xx:"4l.w.  
#X1
ND  
球形表面 #\OA)`U  
PJH&  

图片:1-1Q113225P1295.png

ZFL~;_r  
#*
Ctwl,T  
可编程界面所在位置：目录 VTE .^EK!  
Fx.=#bVX7  

图片:1-1Q113225ZY61.png

57c8xk[.2  
4tBYR9|  
可编程界面所在位置：组件 :vbW  
e\L8oOk#r  

图片:1-1Q11322592b42.png

^1.By^ $  
.ioEIsg  
设置表面的定义区域 7kEn \
 
4kx N<]  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 I!K6o.|1  
•在本例中，我们使用圆孔。 b>ySv  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ ^1];S^nD  
Gd85kY@w7  

图片:1-1Q1132259514E.png

Dlvz)  
R6->t #n,  
进入可编程界面 \9T7A&  
nu%*'
.  

图片:1-1Q113230035R8.png

OneY_<*a<  
M\BRcz  
可编程界面：全局参数 =I_'
.b  
%pCT
N P  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 +NUG  
•在那里，添加和编辑一个参数： i83OOV$1J  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 R:qW;n%AF  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 f!X[c?Xy"  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 Z%UP6%  
dR]m8mdqc1  

图片:1-1Q11323011A22.png

G3T]`Atf  
Q~9^{sHZjP  
可编程界面：代码段帮助（Snippet Help） ]`WJOx4  
QMm%@zH  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 ;O,jUiQ  
•此选项对于使用可编程元素跟踪进度非常有用。 }Q+|W=2t  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ C0Z=~Q%  
q) KKvO  

图片:1-1Q11323015HB.png

JucY[`|JV  
mt.))#1  

图片:1-1Q113230325X3.png

8z\xrY  
E]r?{t`]  
可编程界面：编写代码 owv[M6lbD  
jebx40TA3  

图片:1-1Q113230354L2.png

^iYj[~  
R4d=S4i  
可编程界面：用户自定义梯度 rytyw77t(  
MolgwVd
 

图片:1-1Q113230414a1.png

)V9bI(v  
可编程界面：使用您的代码段（Snippet） tZo} ;|~'  
$ocdI
5  

图片:1-1Q113230441529.png

A3*!"3nU  
TA~{1_l  
可编程界面的输出 j] [,J49L  
aw>#P   

图片:1-1Q113230513340.png

I%Z  
,hmL/K0"(5  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） c:.eGH_f  
*Pg2c(Vg  
将自定义界面保存到目录中 Etm?'  
zbPqYhJzA  

图片:1-1Q11323055K33.png

1h5 Akq  
ybUaTD@?}b  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 u]@['7  
gQ.Sa j $  
故障排除提示 akQ7K  
NGWxN8P6  

图片:1-1Q11323062S59.png

2J;g{95z  
i!Ga5v8n:  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ i}?>g-(  
Kc(FX%3LU  

图片:1-1Q113230A3617.png

? =+WRjF  
:M5l*sIO2  
测试代码! TS5Q1+hWHV  
u#SWj,X  

图片:1-1Q113230G5391.png

?bu>r=oIO]  
LOJAWR9$^U  

图片:1-1Q113230I3W0.png

{l>hMxij  
>o,TZc\  
文件信息 GPkpXVm  
,Y48[_ymm  

图片:1-1Q113230K5B1.png

v.5+7,4  
u<&m]]*