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

摘要 <B)lV'!Bd  
z;-2xD0&U[  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 3KGDS9I  
iVD9MHT4  

图片:1-1Q113224953T4.png

/<@oUv  
rl4-nA  
可编程界面所在位置：目录 OHB!ec6W  
XG0,
@Ly  

图片:1-1Q11322501Y47.png

{d)+a$qj  
x`$4  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 E0YXgQa  
M/BBNT  
可编程界面所在位置：组件 9s}--_k?F2  
DpA)Z??  

图片:1-1Q1132251523M.png

:U~[%]  
]
p~XTZgW  
编写代码 `.n[G~*w~1  
r8mE   
•右侧面板显示了可用的独立参数列表。 Es?~Dd  
•x和y表示独立变量，即平面上的2D坐标。 P
S>k67sI  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 !=ZbBUJF  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
aFLm,  
•使用Snippet Body将支持函数中的部分代码分组。 ~q<UE\H  
IE
3GM
^7\  

图片:1-1Q1132253435R.png

_c[t.\-`]  
`A#r6+  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 l?ofr*U&-x  
!dZHG R  
表面梯度的定义 *-2u0%  
K%S k
{'  
•精确计算界面的梯度是光学仿真的基础。 T\OLysc  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 (HY|0Bgr  
^NP" m
  

图片:1-1Q1132254294X.png

AE@*#47  
0%vXPlfnY  
用户自定义的表面梯度 {W@Y4Qqq  
JTx&_Ok#  
98x(2fCvF(  
•右侧面板显示了相同的可用独立参数列表。 .Emw;+>  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 zp d4
uto5  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ % nJ'r?+h  
n*U1 M  

图片:1-1Q113225625919.png

Ehg5u'cj  
KVJiCdg-  
可编程界面的输出 r3#H]c  
vQztD_bX%  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 JI(8{ f  
•在有需要时，可在实际组件内直接编程自定义界面。 zL1H[}[z+  
•或者，将其保存在目录中供后续使用。  F`f#gpQ  
1'M<{h<sP  

图片:1-1Q113225FL09.png

<UeO+M(  
ceAK;v o  
对球形表面进行编程 V"gnG](2l  
|FH/Q-7[  
球形表面 A2]N :=  
]
kR 93  

图片:1-1Q113225P1295.png

Q9{%  
FD[*mCGZ  
可编程界面所在位置：目录 zf#V89!]C"  
wOINcEdx  

图片:1-1Q113225ZY61.png

\S3C"
P%w  
JeuW/:Wv  
可编程界面所在位置：组件 A:>G:X5t  
.hnGHX  

图片:1-1Q11322592b42.png

aHS.U^2  
3. fIp5g  
设置表面的定义区域 $f_Brc:n {  
gZ:)l@ Wu  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 cvi+AZ=  
•在本例中，我们使用圆孔。 |0BmEF  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！  !1;DRF  
sJ25<2/  

图片:1-1Q1132259514E.png

%=%jy  
[[ HXOPaV  
进入可编程界面 ^<7)w2ns  
>
PfYHO  

图片:1-1Q113230035R8.png

uG~%/7Qt{  
IYb@@Jzo  
可编程界面：全局参数 XV]`?  
i e%ZX  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 d2Bn`VI  
•在那里，添加和编辑一个参数： 0~Z2$`(  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 =2# C{u.  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 0O|T\E8e  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 Z'hW;^e%_z  
^7V9\Q9  

图片:1-1Q11323011A22.png

pO4}6\1\  
mq do@  
可编程界面：代码段帮助（Snippet Help） JmtU>2z\
 
}r9f}yX9Q  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 JEGcZeq)  
•此选项对于使用可编程元素跟踪进度非常有用。 %BC*h}KGH  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ ySL 31%  
Xq1n1_Z  

图片:1-1Q11323015HB.png

6uOR0L  
JO1KkIV  

图片:1-1Q113230325X3.png

!zVuO*+  
Kw+?Lowp  
可编程界面：编写代码 [wi "
 
;XRLp:y  

图片:1-1Q113230354L2.png

zH.DyD5T;  
|r$Vb$z  
可编程界面：用户自定义梯度 n
(0O'nS^  
ym{?vY h  

图片:1-1Q113230414a1.png

 3_+-t5  
可编程界面：使用您的代码段（Snippet） /|bir6Y:  
Z ~:S0HDP  

图片:1-1Q113230441529.png

L Lm{:T7  
)UO:J7K  
可编程界面的输出 :OUNZDL  
,g;~:  

图片:1-1Q113230513340.png

p9y "0A|  
IF(W[J  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） Ot`jjZ&  
nxA Y]Q  
将自定义界面保存到目录中 u yzc"di  
5M;fh)fT  

图片:1-1Q11323055K33.png

=;9Wh!{  
g~S>_~WL  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 LsS/Sk  
kVCSFF*  
故障排除提示 uI}S9  
z;xp1t@  

图片:1-1Q11323062S59.png

I QS|  
f nX!wN  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ DvKM[z3j  
<=l!~~%  

图片:1-1Q113230A3617.png

{Nuwz|Ci  
!;x  
测试代码! wWKC.N  
Nq/,41  

图片:1-1Q113230G5391.png

/QZnN?k  
)O#]Wvr  

图片:1-1Q113230I3W0.png

bjmUU6VLT  
bN`oQ.Z 4  
文件信息 S#8wnHq  
),(ejRP'r  

图片:1-1Q113230K5B1.png

eu@-v"=w  
s/Fc7V!;