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

摘要 \h-[
u%  
(n<xoV[e  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 QMIXz[9w  
C8?/$1|RL  

图片:1-1Q113224953T4.png

[8"nRlXH  
pO^ 6p%  
可编程界面所在位置：目录 <AVpFy  
@*oi1
_q  

图片:1-1Q11322501Y47.png

8wBns)wy@  
v1} $FmHL"  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 N5_v}<CN  
'D1@+FFU0  
可编程界面所在位置：组件 =X`/.:%|[  
GXAcyOV  

图片:1-1Q1132251523M.png

,YoIn  
i@2?5U>h  
编写代码 a}wB7B;,g  
1G\ugLm  
•右侧面板显示了可用的独立参数列表。 n8?gZ` W  
•x和y表示独立变量，即平面上的2D坐标。 GB-=DC6  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 /XXW4_>  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 mBNa;6w?{*  
•使用Snippet Body将支持函数中的部分代码分组。 +h =lAHn&  
(]ORB0kl  

图片:1-1Q1132253435R.png

y]/{W}D  
A >x
{\  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 lU@ni(69d  
3}H94H)]a  
表面梯度的定义 8]0^OSS  
ua0k)4|  
•精确计算界面的梯度是光学仿真的基础。 pd|c7D!6U,  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 E_h9y  
ZXco5,1  

图片:1-1Q1132254294X.png

f[.]JC+,  
6gp3n;D  
用户自定义的表面梯度  ~d }-  
5L4~7/kj  
`T-(g1:9  
•右侧面板显示了相同的可用独立参数列表。 $N+azal+y  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 kJ~^ }o  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ w_9:gprf  
?^yZVmAo]  

图片:1-1Q113225625919.png

HMBxj($eR  
U'@_fg  
可编程界面的输出 2lGq6Au:  
QutQG  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 }ulFW]A^7  
•在有需要时，可在实际组件内直接编程自定义界面。 bJ9>,,D  
•或者，将其保存在目录中供后续使用。 \ Xuu|]  
QtRKmry{
 

图片:1-1Q113225FL09.png

D[U5SS!)  
I@[.W!w  
对球形表面进行编程 H*l8,*M}  
gllXJM^ -  
球形表面 JK,k@RE y]  
WhvO-WF  

图片:1-1Q113225P1295.png

o\2#o5#  
$ZE OE8.\  
可编程界面所在位置：目录 %GAEZH,2sG  
yaeX-'(Fv[  

图片:1-1Q113225ZY61.png

e`Yx]3;u(  
6tP^_9njy  
可编程界面所在位置：组件 c/pT2/y  
5J 0  

图片:1-1Q11322592b42.png

+`\C_i-  
@ j'
I  
设置表面的定义区域 YT#
"HYO  
Byon2|nf7  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 Y0U:i.)  
•在本例中，我们使用圆孔。 TC ^EyjD  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ Ww@Rewo  
V7 c7(G  

图片:1-1Q1132259514E.png

#VD[\#  
H+-9R  
进入可编程界面 7Sr7a{  
C7,Ol0`v  

图片:1-1Q113230035R8.png

2E;*kKw[  
AOeptv^k3}  
可编程界面：全局参数
wz;IKdk[  
oc>,5 x  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 <0pBu7a  
•在那里，添加和编辑一个参数： l9#vr  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 ;Cm%<vW4!  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 6EJ,czt(  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 iYBs )  
8L.Y0_x  

图片:1-1Q11323011A22.png

|UE&M3S  
2{g~6U.  
可编程界面：代码段帮助（Snippet Help） 9V("K  
%J7 ;b<}To  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 I%;xMtY1o  
•此选项对于使用可编程元素跟踪进度非常有用。 e<>(c7bF  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ d:Wh0y}  
f0}+8JW5h  

图片:1-1Q11323015HB.png

3-srt^>w*  
;L++H5Kz6  

图片:1-1Q113230325X3.png

G^5}T>TV  
]Z2;sA  
可编程界面：编写代码  h9RG?r1  
jbGP`b1_  

图片:1-1Q113230354L2.png

T/UhZ4(V  
]xbR:CYJ  
可编程界面：用户自定义梯度 }5FdX3YR  
5 J61PuH   

图片:1-1Q113230414a1.png

K6{{\r  
可编程界面：使用您的代码段（Snippet） z^O>'9#
 
m^%[  

图片:1-1Q113230441529.png

o"J}@nF  
PL[7|_%  
可编程界面的输出 S2h?Q$e3  
c{7!:hi`x  

图片:1-1Q113230513340.png

+m]$P,yMt  
+t})tDPXw  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） :
6./yj(  
H~e;S#3_v  
将自定义界面保存到目录中 Ft#d& I  
2mWW0txil  

图片:1-1Q11323055K33.png

98x]x:mgI_  
N{ @B@]  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 '/J}T -,Z  
DI"mi1ObE  
故障排除提示 1nye.i~  
 _p<s!  

图片:1-1Q11323062S59.png

$RfM}!7?  
S1.w^Ccy  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ jqhd<w  
]4
ya$%A  

图片:1-1Q113230A3617.png

j ~:Dr  
CD;C
z*c  
测试代码! }PTYNidlR  
 LkD$\i  

图片:1-1Q113230G5391.png

06|+_  
a2 e-Q({  

图片:1-1Q113230I3W0.png

qCi6kEr  
J]^)vxm3  
文件信息 <b~KR8  
@2yi%_]h  

图片:1-1Q113230K5B1.png

l\vtz5L  
^F"Q~?D)