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

摘要 *75YGD  
M]rO;^;6?  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 `!4,jd  
tw K^I6@  

图片:1-1Q113224953T4.png

$P {K2"
Oc  
PlxIfL  
可编程界面所在位置：目录 mOBACTY^  
lxb zHlX  

图片:1-1Q11322501Y47.png

nWYCh7  
?vtX"Fdz  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 Lxe^v/LsT  
L'A)6^d@S  
可编程界面所在位置：组件 b]fzRdhl  
#/-_1H  

图片:1-1Q1132251523M.png

4YROB912
 
6[ga$nF?  
编写代码 O[q\e<V<  
ERMa# L  
•右侧面板显示了可用的独立参数列表。 4ne5=YY*  
•x和y表示独立变量，即平面上的2D坐标。 9^ed-h Bf  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 C"pB"^0  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 l?
qqqB  
•使用Snippet Body将支持函数中的部分代码分组。 Kuw^qX"  
&9[P-w;7u  

图片:1-1Q1132253435R.png

tjnPyaJEl  
Kx`/\u=/  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 ,[rPe\w.z  
+OaUP*\Dd  
表面梯度的定义 b~Y%gC)FR  
NTs7KSgZ  
•精确计算界面的梯度是光学仿真的基础。 FiAY\4  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 n(ir[w#,]"  
tNaL;0#Tx  

图片:1-1Q1132254294X.png

-yH,5vD  
"j
g@w%~  
用户自定义的表面梯度 PD[z#T!'  
Yc Q=v
t{  
B|=|.qp$)  
•右侧面板显示了相同的可用独立参数列表。 (GKpA}~R  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 rfcN/:k  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！   WY  
<O~WB  

图片:1-1Q113225625919.png

(#\pQ51  
@J'YV{]  
可编程界面的输出 u0s8yPA  
W_YY#wf_  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 _c(4o:  
•在有需要时，可在实际组件内直接编程自定义界面。 u eb-2[=  
•或者，将其保存在目录中供后续使用。 1`bl&}6l|E  
PgM(l3x  

图片:1-1Q113225FL09.png

Z?NW1m()F  
1QqHF$S  
对球形表面进行编程 62'1X"  
'\q f^?9  
球形表面 K{fsn4rk  
!]` #JAL7  

图片:1-1Q113225P1295.png

'_P\#7$!MV  
Zi\['2CG  
可编程界面所在位置：目录 ?DV5y|}pj  
@Yw,nQE)b  

图片:1-1Q113225ZY61.png

4-GXmC  
E6B!+s!]  
可编程界面所在位置：组件 sJx+8 -  
E; $+f  

图片:1-1Q11322592b42.png

y3u+_KY-  
aolN<u3G  
设置表面的定义区域 R<ND=[}s  
UYP9c}_,4  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 V%0I%\0Y  
•在本例中，我们使用圆孔。 oEz%={f  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ d%@~mcH>  
2S3lsp5!  

图片:1-1Q1132259514E.png

oPKr* `'  
MTGiAFE  
进入可编程界面 L)QE`24  
LA3<=R]  

图片:1-1Q113230035R8.png

CWo1.pVw  
o KD/rI  
可编程界面：全局参数 ppIbjt6r  
)2q~u%9n  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 RZpcXv  
•在那里，添加和编辑一个参数： ,
6^znOt  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 5v\!]?(O;  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 E`H$YS3o  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 :q<Z'EnW  
_/*U2.xS  

图片:1-1Q11323011A22.png

q-ES6R  
RE$`YCs5  
可编程界面：代码段帮助（Snippet Help） ~9\WFF/  
$QEilf;E  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 JPM))4YDR  
•此选项对于使用可编程元素跟踪进度非常有用。 L%}zVCg  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ >N\0"F7.  
Q zZ;Ob]'  

图片:1-1Q11323015HB.png

%owsBO+  
Wjh/M&,  

图片:1-1Q113230325X3.png

>>Ts??  
9z;HsUv  
可编程界面：编写代码 Hd7,ZHj3^  
Sw`RBN[ yo  

图片:1-1Q113230354L2.png

h0oMTiA  
Ll4bdz,  
可编程界面：用户自定义梯度 +QM@VQ  
;g_> ;tR/  

图片:1-1Q113230414a1.png

l:6,QaT1  
可编程界面：使用您的代码段（Snippet） {*ZY(6^  
jJ4qR:]  

图片:1-1Q113230441529.png

!}\4utHY  
3lLMu B+  
可编程界面的输出 `s '#  
Sx:Ur>?hd5  

图片:1-1Q113230513340.png

JxLf?ad.  
p2J|Hl|  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） e}@)z3Q<l  
)2UZ% ?V#  
将自定义界面保存到目录中 S.B<pjgt  
6OiSK@<Hk  

图片:1-1Q11323055K33.png

zL5d0_E9  
!|2VWI}  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 q(5j(G ;  
_8}QlT  
故障排除提示 wpA`(+J  
z3t~}aL  

图片:1-1Q11323062S59.png

4RKW  
Fg$3N5*
 
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ krq/7|  
y5= `ap  

图片:1-1Q113230A3617.png

&X9Z W$C  
Mh(]3
\  
测试代码! 2=-utN@Z  
M >:]lpRK  

图片:1-1Q113230G5391.png

c4e_6=Iv  
d;Hn#2C  

图片:1-1Q113230I3W0.png

*5sBhx  
l5Y/Ok0,  
文件信息 3`O?16O  
OE)~yKy  

图片:1-1Q113230K5B1.png

{^{p,9  
:J}t&t