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

802]M  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 YM,D`c[pX  
JY,l#?lM{  
brhJ&|QDE  
    可编程界面所在位置：目录 9M-]~.O  
dT0z^SG  
94>7-d  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 0ju wDd  
(x*2BEn|  
可编程界面所在位置：组件 Y;F,GxR}  
N[?4yV2s  
g275{2G9  
fPuQ,J2=  
     -QHzf&D?  
编写代码 -iZjs  
neMe<jr  
>Gu>T\jpe.  
•右侧面板显示了可用的独立参数列表。 e715)_HD  
•x和y表示独立变量，即平面上的2D坐标。 a0v1LT6  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 {7MgN'4  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 IEKX'+t'  
•使用Snippet Body将支持函数中的部分代码分组。 JeSkNs|vB  
ysP/@;jC  
@5nkI$>3z  
"9Fv!*<-W  
        提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 $AJy^`E^  
FK,r<+h  
表面梯度的定义 ,?skJ  
qm&53  
:ftyNaq'  
•精确计算界面的梯度是光学仿真的基础。 qcoZ2VJ hh  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 &wWGZ~T  
fVe-esAw  
[}g5Z=l  
用户自定义的表面梯度 V:$1o  
7Bb@9M?i  
uZ{xt6 f  
•右侧面板显示了相同的可用独立参数列表。 |D_n4#X7u  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 B 0fo[Ev  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ <zWQ[^  
Z-r0 D  
!QzMeN;D  
}t{^*(  
可编程界面的输出 ViC76aJ  
:zk.^q  
O9 r44ww  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 J'&?=|  
•在有需要时，可在实际组件内直接编程自定义界面。 k/f_@
8  
•或者，将其保存在目录中供后续使用。 _rWXcK3cjr  
wB0WR  
P6Ol+SI#m  
I,q~*d  
     $7ME a"a  
     =$`")3y3  
     &5CeRx7%  
     w@D@,q'x  
对球形表面进行编程 :=KGQ3V~eK  
    球形表面 t5[JN:an  
`>HthK  
>?\ !k c  
    可编程界面所在位置：目录 ku8Z;ONeH  
7VD7di=D  
k$m
X81  
     0R{R=r]  
可编程界面所在位置：组件 kxiyF$ 9  
J~ rC  
A.*nDl`H  
设置表面的定义区域 v*p)"J *  
CHSD8D  
9d|7#)a;  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 iONql7S @  
•在本例中，我们使用圆孔。 YXOD fd%L  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ Y\2>y"8>$x  
&l)v'  
(9QRg;   
进入可编程界面 .jU0Hu{F4  

",oUVl  
3m9E2R,  
biuo.OG]  
可编程界面：全局参数 Q9 ",  
zm.sX~j  
:D7!6}%  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 KV(W|~+rM  
•在那里，添加和编辑一个参数： B_1u<00kg  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 un%"
s:  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 ,l"2MXD  
        提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 BNUf0;
 
~H."{  
!I  P*  
`qEm5+`  
    可编程界面：代码段帮助（Snippet Help） 2Nzcej  
-igZU>0B_  
e/%YruzS  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 FC.-u
"V  
•此选项对于使用可编程元素跟踪进度非常有用。 5.;$9~d  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ _)\,6| #  
,)m-nZ5  
rI$10R$+H  
zL}DLfy>R  
7hE=+V8  
     .;Yei6H  
可编程界面：编写代码 J~6*d,Ry`  
e6a8ad  
eeZ9 w~<  
jt*@,+e|  
可编程界面：用户自定义梯度 wN.Jyb  
jl7-"V>j?;  
Qk?Jy<Ra  
可编程界面：使用您的代码段（Snippet） <FLc0s  
nQMN2jM  
1.CYs<  
6ng9 o6  
可编程界面的输出 oDK\v8w-  
I#%-A  
n\,W:G9AR7  
j(N9%/4u  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） jR:Fih-}  


BGOI  
将自定义界面保存到目录中 xJlq2cK  
\|s/_35(  
P]^] T}5  
;B@l0)7(x  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 B 8,{jwB  
)Qp?LECrt  
故障排除提示 w=
5qth7  
wVX0!y6  
*?\Nioii  
AG%aH=TKp  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ $'wl{D"  
ponvi42u  
B(U`Zd  
D:0PppE  
     U^I'X7`r  
测试代码! h[?28q$  
     2sH5<5G'  
$cedO']  
     wq#3f#3V