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

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

图片:1-1Q113224953T4.png

"`S6
1m_  
1pK7EK3R  
可编程界面所在位置：目录 mf3G$=[  
N%-nxbI\  

图片:1-1Q11322501Y47.png

uzo}?X#  
qr@,92_  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 {^qc
`oF  
<L-L}\-I"  
可编程界面所在位置：组件 r,}Zc W+  
_,}Ye,(^=  

图片:1-1Q1132251523M.png

;i]cmy  
s0:1G -I  
编写代码 S("bN{7nE  
S8y4 p0mV  
•右侧面板显示了可用的独立参数列表。 v=4TU\b%  
•x和y表示独立变量，即平面上的2D坐标。 "FU|I1Xz  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 *<@  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 ZG>OT@ GA
 
•使用Snippet Body将支持函数中的部分代码分组。 | @YN\g K;  
x83XJFPWL  

图片:1-1Q1132253435R.png

#GF1MFkoS  
qg O)@B+  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 @dXf_2Tv=  
=k_u5@.Z  
表面梯度的定义 \|(;q+n?k  
4k#6)e  
•精确计算界面的梯度是光学仿真的基础。 C@[:}ZGMV  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 p.%$  
X;1q1X)K  

图片:1-1Q1132254294X.png

$5A XE;~{  
OLi;/(g  
用户自定义的表面梯度 {T IGPK  
n33SWE(  
gk&?h7P"<  
•右侧面板显示了相同的可用独立参数列表。 >GcFk&x  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 lG{J  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ uYl ?Q  
h<j04fj  

图片:1-1Q113225625919.png

IP >An8+  
52"/Zr}j  
可编程界面的输出 ]
o
Y~8HW  
AT%0i  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 "mOoGy,(  
•在有需要时，可在实际组件内直接编程自定义界面。 VTHDGBU  
•或者，将其保存在目录中供后续使用。 +LyhF2  
d0xV<{
,-  

图片:1-1Q113225FL09.png

kA3kh`l  
^R\blJQ<^  
对球形表面进行编程 &K4o8Qz  
Ue%0.G|<W  
球形表面 }O>IPRZ  
brFOQU?  

图片:1-1Q113225P1295.png

;?cUF78#  
VcP#/&B|  
可编程界面所在位置：目录 P8EGd}2{8  
X bg7mj9c  

图片:1-1Q113225ZY61.png

Z
LV~It&)  
)uaB^L1  
可编程界面所在位置：组件 jm?mO9p~  
q^Z\V?  

图片:1-1Q11322592b42.png

gK>Vm9rO  
:Cuae?O,  
设置表面的定义区域 ,lUo
@+  
iN><m|  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 *qqFIp^  
•在本例中，我们使用圆孔。  WsoB!m  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ <s:Xj  
#4hP_Vhc  

图片:1-1Q1132259514E.png

OY)x Kca  
 2O  
进入可编程界面 SX4p(t  
2rH6ap  

图片:1-1Q113230035R8.png

0uvL,hF  
zqeU>V~<F  
可编程界面：全局参数 >5j/4Ly  
spI{d!c  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 3S9~rLrn?  
•在那里，添加和编辑一个参数： aT0 y  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 qkEy$[D9  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 07#!b~N  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 ~)Z`Q  
ERZ[t\g)  

图片:1-1Q11323011A22.png

y5#_@  
A gPg0(G  
可编程界面：代码段帮助（Snippet Help） c;e,)$)-|  
Z\Q7#dl  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 I|M*yObl6  
•此选项对于使用可编程元素跟踪进度非常有用。 w5;EnI  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ "gO5
dZ\0  
]+Vcuzq/  

图片:1-1Q11323015HB.png

l
ghzd6  
|WX4L7yrhK  

图片:1-1Q113230325X3.png

oHYD6qJX{  
5(W9Jj]  
可编程界面：编写代码 ]]7T5'.  
4EK[gM8  

图片:1-1Q113230354L2.png

)Ga6O2:  
S6QG:|#P  
可编程界面：用户自定义梯度 }>w; +XU  
WIghP5%W  

图片:1-1Q113230414a1.png

!9 F+uc5  
可编程界面：使用您的代码段（Snippet） r:IU+3  
s,RS}ek~|  

图片:1-1Q113230441529.png

h(L5MZs  
)t4C*+9<U  
可编程界面的输出 BCbW;w8aI  
$Yka\tS'  

图片:1-1Q113230513340.png

+D@R'$N  
G$j8I~E@  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） _e'mG'P(  
K+\hv~+@  
将自定义界面保存到目录中 p5KNqqZZ  
_=]
FJhO  

图片:1-1Q11323055K33.png

6PH*]#PfoD  
N_<n$3P\?f  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 by<2hLB9Q  
$d"+Njd  
故障排除提示 { \ePJG#  
D6t]E)FH  

图片:1-1Q11323062S59.png

;
p9D2&  
2KEww3.
{  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ NSq"\A\  
^wlep1D  

图片:1-1Q113230A3617.png

0TpA3K  
2XtQ"`)  
测试代码! J\V(MN,  
\a!<^|C&  

图片:1-1Q113230G5391.png

Jj " {r{  
)N<!3yOz  

图片:1-1Q113230I3W0.png

2?j1~]DvZ  
H #BgE29  
文件信息 *"ShE=\p  
H4,yuV  

图片:1-1Q113230K5B1.png

^Ram8fW  
msylb~^