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

#>0nNR[$Y  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 6l4l74  
f-Sb:O!V  
(efH>oY[  
    可编程界面所在位置：目录 uW]n3)7<I  
:KQ<rLd  
0@ -LV:jU  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 o,29C7Ii  
qU"+0t4  
可编程界面所在位置：组件 *StJ5c_kg2  
TPrwC~\B/  
*aSFJK  
}&=C*5JN  
     G B15  
编写代码 Z'\_YbB  
<_D+'[  
1&dWt_\  
•右侧面板显示了可用的独立参数列表。 [P^ .=F  
•x和y表示独立变量，即平面上的2D坐标。 p%}oo#%J  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 |2mEowAd  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 JLjx4B\  
•使用Snippet Body将支持函数中的部分代码分组。 rn(
T Z}  
[j5L}e!T  
]1klfp,`  
)0NA*<Q+.  
        提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 J<'4(}^|  
-G{}8GM  
表面梯度的定义 c[4Z_5B  
hp)3@&T  
P?>p+dM  
•精确计算界面的梯度是光学仿真的基础。 (mv8_~F0  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 GSypdEBj+w  
U:_&aY_  
5Rq
kAC  
用户自定义的表面梯度 LNe-]3wB  
,9=a(j"  
|S/nq_g]  
•右侧面板显示了相同的可用独立参数列表。 "BK&C6]  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 =>4,/g3  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ KX{S8_  
<CeDIX t  
ZMbv1*Vt  
(}'0K?  
可编程界面的输出 pZXva9bE  
cd\0  
oM J5;  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 /']Gnt G.  
•在有需要时，可在实际组件内直接编程自定义界面。  I"r
*p?  
•或者，将其保存在目录中供后续使用。 Tc{r}y[)  
8USF;k  
OD{Rh(Id  
u"nyx0<  
     >*EcX
3  
     z[l17+v  
     o[_{\  
     8hdd1lVKO8  
对球形表面进行编程 w_6h $"^x  
    球形表面  dY|(  
jytfGE:  
^*RmT  
    可编程界面所在位置：目录 CJ?Lv2Td  
f~9
ADb  
{~VgXkjsC  
     5X'[{'i,  
可编程界面所在位置：组件 D[ny%9 :  
)0YMi!&j`  
N_h)L`  
设置表面的定义区域 yo3'\I  
S&FMFXF@  
ur"ckuG!9  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 /=i^Bgh4  
•在本例中，我们使用圆孔。 d-lC|5U%  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ LC2t,!RRl&  
L=?Yc*vg  
0Kq\ oMn  
进入可编程界面 8nW#Q<s  
QXniWJJ  
]=7}Y%6  
\f05(ld  
可编程界面：全局参数 ?=-18@:.ss  
u+kXJ  
!'[f!vsyM{  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 ?FxxH*>"  
•在那里，添加和编辑一个参数： BNnGtVAbZ  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 $s5LzJn  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 YOy/'Le^:  
        提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 skf7Si0z  
7jvf:#\LtL  
>XM-xK-=  
5F18/:\n  
    可编程界面：代码段帮助（Snippet Help） k&
2U&  
c\065#f!  
,)[u<&  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 Y7{IF X  
•此选项对于使用可编程元素跟踪进度非常有用。 W^Wr  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ ML9ZS @  
B~G?&"]  
C5c@@ch :  
sFsp`kf  
\GO^2&g(  
     VE`5bD+%e  
可编程界面：编写代码 7o-umZ}8  
*0^!%Y'/4  
cQ} ,q+GR~  
:<r.n "  
可编程界面：用户自定义梯度 x* ?-KS|  
N7v7b<6  
4"nb>tA  
可编程界面：使用您的代码段（Snippet） %wzDBsX  
<%Zg;]2H`  
J^m#984  
wM9HZraB<  
可编程界面的输出 wuRQ H]N  
.B_LQ;0:   
;'~U5Po8  
]%>7OH'  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） hd^?mZ  
M_lQ^7/  
将自定义界面保存到目录中 N_Q)AXr)  
(NR8B9qLN  
^lud2x$O^C  
ND $m|V-C  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 SaceIV%(  
{]BP
Sj{B  
故障排除提示 VRV*\*~$  
|Ii[WfFA|J  
jeXP|;#Una  
'Z5l'Ac  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ GrPKJ~{6  
W6%\Zwav?)  
JcV'O)&
  
X67^@~l  
     1?%Q"*Y&  
测试代码! R-QSv$  
     q#s:2#=  
?&A)%6` ~  
     O=m_P}K