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

摘要 VH+%a<v"  
{5F-5YL+>  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 m|{3),#V  
BaSZ71>9]r  

图片:1-1Q113224953T4.png

p4'G$]#  
v#.r.{t  
可编程界面所在位置：目录 j#+!\ft5  
;j^H)."A\  

图片:1-1Q11322501Y47.png

Jh ]i]7r  
&Rvm>TC=  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 [/Rf\T(,jn  
,6om\9.E@  
可编程界面所在位置：组件 fZ*+2T>  
;`^WGS(3.%  

图片:1-1Q1132251523M.png

oZ!m  
8DegN,?  
编写代码 K2J\awX  
*T5!{  
•右侧面板显示了可用的独立参数列表。 mT.u0KUIy  
•x和y表示独立变量，即平面上的2D坐标。 ApAO/q  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 4scNSeW  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 JwAYG5W  
•使用Snippet Body将支持函数中的部分代码分组。 BFo5\l:q8  
V+VkY3  

图片:1-1Q1132253435R.png

paKSr|O  
P@9t;dZ
N  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 dvt9u9Vg=  
[uI|DUlI6o  
表面梯度的定义 Mz~M3$$9n  
zmSUw}-4N  
•精确计算界面的梯度是光学仿真的基础。 vTJ}8  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 fSs4ZXC  
bT^I"  

图片:1-1Q1132254294X.png

jO!y_Y]B  
{\c(ls{  
用户自定义的表面梯度 HbXPok  

uf&myV7  
+\F'iAs@  
•右侧面板显示了相同的可用独立参数列表。 cd$m25CxC  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 i 7x7xtq  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ Fsif6k=4  
%Ti}CwI`  

图片:1-1Q113225625919.png

0tEYU:Qu  
cp#JBHO  
可编程界面的输出 ha(Z<  
(2:/8\_P  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 DX"
xy  
•在有需要时，可在实际组件内直接编程自定义界面。 6WU(%  
•或者，将其保存在目录中供后续使用。 ?e,pN,4  
PYM(Xz$  

图片:1-1Q113225FL09.png

r=X}%~_8X  
HN&Z2v  
对球形表面进行编程 2JJ"O|Ibz  
Ahk8  
球形表面 ]dI2y=[!C  
M;p em<  

图片:1-1Q113225P1295.png

gG-BVl"59  
iVy7elT;R  
可编程界面所在位置：目录 YN!>}  
-Xxqm%([71  

图片:1-1Q113225ZY61.png

`"&da#N]  
rzh#CnL3  
可编程界面所在位置：组件 bpKZ3}U  
A7%:05  

图片:1-1Q11322592b42.png

&:
,dJ  
6y6<JR-V2k  
设置表面的定义区域 nIU6h  
1#0{@35  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 0IfKJ*]M  
•在本例中，我们使用圆孔。 b#K:_ac5
 
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ 3WUTI(  
}lfnnK#  

图片:1-1Q1132259514E.png

IGtl\b=  
= Wu *+paQ  
进入可编程界面 =u+d_'P7-R  
_g~qu [1  

图片:1-1Q113230035R8.png

[L:o`
j  
h\PHKC2  
可编程界面：全局参数 >]W)'lnO  
V\^EfQ  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 @ ]/AjjLt  
•在那里，添加和编辑一个参数： A@sZ14+f  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 WV#%PJ  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 Vv8jEZ8  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 ^Nmg07_R  
iv>SsW'p_  

图片:1-1Q11323011A22.png

[]A%<EI7  
nSkPM5\TI  
可编程界面：代码段帮助（Snippet Help） #3_*]8K.R  
AKRTB
jG"  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 |Tm!VFd  
•此选项对于使用可编程元素跟踪进度非常有用。 ,;(PwJe  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ _h":>  
}b0; 0j  

图片:1-1Q11323015HB.png

rwG CUo6Z  
w*|7!iM  

图片:1-1Q113230325X3.png

=Q[b'*o7  
UGuxV+Nwf  
可编程界面：编写代码 &d5ia+#  
ngat0'oa  

图片:1-1Q113230354L2.png

sRrzp=D  
ea~:}!-P  
可编程界面：用户自定义梯度 )I$q5%q8  
9$|Gfyv  

图片:1-1Q113230414a1.png

k}0^&Quc4  
可编程界面：使用您的代码段（Snippet） \@1=stK:F  
!}
r% u."  

图片:1-1Q113230441529.png

S}ECW,K  
#*g5u{k'P  
可编程界面的输出 5GPo*Qpl  
Ko/ I#)  

图片:1-1Q113230513340.png

&ZX{R#[L  
r?*NhLG;  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） EB_NK  
qq1-DG  
将自定义界面保存到目录中 L0tAgW!@  
]<q[Do8k  

图片:1-1Q11323055K33.png

lME)?LOI  
hwIMn33  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 ]Wq?H-B{  
" $ew~;z  
故障排除提示 f}@jFhr'<  
P b]3&!a  

图片:1-1Q11323062S59.png

?w+Ix~k  
@bnG:np  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ 0sh/|`\  
\C`~S7jC  

图片:1-1Q113230A3617.png

fz3lV  
yin'vgQ  
测试代码! 6"D/xV3Z  
^+1#[E
  

图片:1-1Q113230G5391.png

]d]JXt?)i  
vUnRi=:|  

图片:1-1Q113230I3W0.png

PT5AA8F  
KV*xApb9y  
文件信息 h#hxOVl%x  
I6s3+x;O  

图片:1-1Q113230K5B1.png

>Z;jY*  
03iv
3/{H