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

摘要 `&ufdn\j  
K93L-K^J  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 {6Y|Z>  
;$,b w5  

图片:1-1Q113224953T4.png

L7\V^f%yCm  
3D 4
-Wo4  
可编程界面所在位置：目录 M5 \flE2  
jKr\mb  

图片:1-1Q11322501Y47.png

4N6JKS  
wtM1gYl^  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 +2xgMN6B@  
|2ImitN0  
可编程界面所在位置：组件 =T!eyG
E  
"`Q&s  

图片:1-1Q1132251523M.png

XM1; >#kz  
%9vl  
编写代码 Jlp nR#@  
IC"Z.'Ph  
•右侧面板显示了可用的独立参数列表。
q"(b}3  
•x和y表示独立变量，即平面上的2D坐标。 boS=  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 aAKwC01?  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 cl04fqX  
•使用Snippet Body将支持函数中的部分代码分组。 ibH!bS{  
~aPe?{yIUa  

图片:1-1Q1132253435R.png

jYUN:  
Oh# z zo  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 FYs]I0}|  
[[$dPa9  
表面梯度的定义 uwl_TDc>%  
%lq[,6?>5  
•精确计算界面的梯度是光学仿真的基础。 7+9o<j@@o  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 IJ]rVty  
ONVhB  

图片:1-1Q1132254294X.png

TB}6iIe  
{
x{~%)-  
用户自定义的表面梯度 ]A%]W^G  
/|0xOiib  
j)ME%17  
•右侧面板显示了相同的可用独立参数列表。 n g%~mt  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 v}LI-~M>U  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ `L LS|S]  
`^ZhxFX  

图片:1-1Q113225625919.png

"%}24t%  
(/7b8)g  
可编程界面的输出 j*\oK@  
{oSdVRI  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 dBw7l}  
•在有需要时，可在实际组件内直接编程自定义界面。 3{)!T;Wd  
•或者，将其保存在目录中供后续使用。 fUMjLA|*I<  
!\VzX  

图片:1-1Q113225FL09.png

e@Mg9VwDc  
w_h{6Kc<  
对球形表面进行编程 qv
^P  
%oB0@&!mS  
球形表面 Q5c3C&$6  
J}NMF#w/;  

图片:1-1Q113225P1295.png

<?nz>vz  
qjObu\r  
可编程界面所在位置：目录 !YPwql(  
IaZmN.k*  

图片:1-1Q113225ZY61.png

Z`_x|cU?J  
<Drm#2x!E  
可编程界面所在位置：组件 0!-'4+"  
Mw3$QRM  

图片:1-1Q11322592b42.png

$K.DLqDt  
$l2`@ia"  
设置表面的定义区域 <6Y|vEo!N  
15@2h  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 cLEd-{x  
•在本例中，我们使用圆孔。 LC4VlfU  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ wPEK5=\4Ob  
jzJQ/ZFS  

图片:1-1Q1132259514E.png

Iprt ZqiL  
IsmZEVuC  
进入可编程界面 [>N#61CV5  
7]} I  

图片:1-1Q113230035R8.png

,m[XeI  
?wu@+  
可编程界面：全局参数 -:95ypi  
A_l\ij$Y  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 veuX/>!  
•在那里，添加和编辑一个参数： 4#{f8  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 O|S,="h"}  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 9

N `WT=  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 F!3p )?  
t{>#)5Pqv  

图片:1-1Q11323011A22.png

&#JYh=#  
L[ZS17;*  
可编程界面：代码段帮助（Snippet Help） ZJF"Yo  
9Nps<+K  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 qdLzB  
•此选项对于使用可编程元素跟踪进度非常有用。 }W@refS  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ (a0(ZOKH  
r95,X!  

图片:1-1Q11323015HB.png

+.&P$`;TZj  
vp2w^/])u  

图片:1-1Q113230325X3.png

>;XtJJS  
}]H7uC!t  
可编程界面：编写代码 8!0fT}  
^,YTQ.O  

图片:1-1Q113230354L2.png

(u^8=#  
J90:c@O"w  
可编程界面：用户自定义梯度
^\g.iuE  
 71@kIJI  

图片:1-1Q113230414a1.png

$K+|bb  
可编程界面：使用您的代码段（Snippet） W**[:n+  
i3mw.`7  

图片:1-1Q113230441529.png

$3B%4#s  
g0"xG}d  
可编程界面的输出 z:Tj0<A'  
I{0cnq/  

图片:1-1Q113230513340.png

q6N{N
>-D  
?FNgJx*\S  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） CVvl &on  
B8eZ}9X  
将自定义界面保存到目录中 oexTz[  
u:']jw=f  

图片:1-1Q11323055K33.png

oQrfrA&=M  
\9@}0}%`  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 Y[vP]7-  
x${C[gxq9F  
故障排除提示 0C.5Qx  
xOPQ~J|z  

图片:1-1Q11323062S59.png

T59FRX  
EZ{{p+e^  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ ~Er0$+q=Y;  
JBA{i45x  

图片:1-1Q113230A3617.png

s-5#P,Lw  
iDX<`)  
测试代码! q+4dHS)x  
7XT(n v  

图片:1-1Q113230G5391.png

?]bx]Y;
 
&>+5 8  

图片:1-1Q113230I3W0.png

<m^a ?q^  
Ym"^Ds}  
文件信息 U+#^>}wc  
43y@9P0  

图片:1-1Q113230K5B1.png

K|\0jd)N  
\D'mo