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

摘要 +B?qx Q  
~f<']zXv  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 Jh"[ug  
15:9J
VH3D  

图片:1-1Q113224953T4.png

(i&+=+"wn  
GS;GJsAs  
可编程界面所在位置：目录 Yh<F-WOo2  
QV|6"4\  

图片:1-1Q11322501Y47.png

>y%H2][  
&PMQ]B  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 ETDWG_H |  
*xnZTj:  
可编程界面所在位置：组件 ff--y8h  
VU3RFl  

图片:1-1Q1132251523M.png

N/a4Gl(  
2Bcc
E  
编写代码 zIa={tU  
} z'Jsy[s  
•右侧面板显示了可用的独立参数列表。 EC?5GNGT,  
•x和y表示独立变量，即平面上的2D坐标。 %i9S"  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 S_lGrk\j  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 i"Jy>'  
•使用Snippet Body将支持函数中的部分代码分组。 yR$_ZXsd  
3vrVX<_  

图片:1-1Q1132253435R.png

d`sZ"8}j  
{gD ED  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 M9"Bx/  
]E9iaq6Z  
表面梯度的定义 \Ec<ch[)c  
J""Cgf  
•精确计算界面的梯度是光学仿真的基础。 !LKxZ"  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 E\iK_'#  
-}7$;QK&a  

图片:1-1Q1132254294X.png

l*ltS(?  
_zj^k$ j  
用户自定义的表面梯度 r8:r}Qj2w[  
yP"2.9\erH  
6wlLE5  
•右侧面板显示了相同的可用独立参数列表。 f3UCELJ  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 /-M:6  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ XIcUoKg^  
HLyAzB~r  

图片:1-1Q113225625919.png

~WA@YjQ]  
V]zZb-m=  
可编程界面的输出 -2hirA<^  
-2.7Z`*(  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 XoN~d  
•在有需要时，可在实际组件内直接编程自定义界面。 :zL)O  
•或者，将其保存在目录中供后续使用。 CE"/&I  
Sca"LaW1  

图片:1-1Q113225FL09.png

]J Yz(m[   
BlJiHz!  
对球形表面进行编程 ~,lt^@a  
>LBA0ynh {  
球形表面 qda 2  
@.;+WQE  

图片:1-1Q113225P1295.png

(?zg.y  
:8b'HhjM  
可编程界面所在位置：目录 G)vNMl  
f:-)S8OJ  

图片:1-1Q113225ZY61.png

/pMOinuO  
V.Hv6  
可编程界面所在位置：组件 O84]J:b  
$PJ==N  

图片:1-1Q11322592b42.png

cSt)Na~C  
7. F'1oEf  
设置表面的定义区域 'lIs`Zc5N  
ZthT('"a  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 ^50dF:V(1  
•在本例中，我们使用圆孔。 217G[YE-  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ snaAn?I4  
\HGf!zZ  

图片:1-1Q1132259514E.png

4 OPY  
'i+L  
进入可编程界面 GxdAOiq;  
JxIJxhA>  

图片:1-1Q113230035R8.png

;!<}oZp{  
xmg3,bO  
可编程界面：全局参数 ,YD7p= PY  
TOwqr T/  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 oSCaP,P  
•在那里，添加和编辑一个参数： vF^d40gV  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 /A{ Zf'DI  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 UhH#>2r_  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 &y!?R$?b  
Tpl]\L1v-  

图片:1-1Q11323011A22.png

=W
TSaC  
z+MH co"  
可编程界面：代码段帮助（Snippet Help） K<P d.:  
@7 Ry{,A  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 ,AnD%#o  
•此选项对于使用可编程元素跟踪进度非常有用。 8'PZA,CW  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ @R&d<^I&M  
%]+R>+  

图片:1-1Q11323015HB.png

ceUe*}\cr  
XPdmz!,b  

图片:1-1Q113230325X3.png

Z- feMM  
[=K lDfU=  
可编程界面：编写代码 &M13F>!  
C]

!2  

图片:1-1Q113230354L2.png

cx[^D,usf~  
^_]ZZin  
可编程界面：用户自定义梯度 NzgG77>  
rUI?{CV  

图片:1-1Q113230414a1.png

o=Vs)8W  
可编程界面：使用您的代码段（Snippet） Q^b&   
Yg&(kmm  

图片:1-1Q113230441529.png

KlT:&1SB9  
8^>qor.]M  
可编程界面的输出 >pF*unC;  
UF+Qx/4h0  

图片:1-1Q113230513340.png

c_>Gl8J  
ed6@o4D/kf  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） ?Bf>G]zx  
s|\)
Y*B`  
将自定义界面保存到目录中 wtS*-;W  
xO|r<R7d7  

图片:1-1Q11323055K33.png

hU$aZ  
)ce 6~  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 p!pf2}6Fd  
#Y=^4U`  
故障排除提示 hhU_kI  
3-/|G-4k7  

图片:1-1Q11323062S59.png

{;{U@Z  
VM$n|[C~  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ t'U=K>7  
DP{nvsF  

图片:1-1Q113230A3617.png

*D|a`R!Y  
oh{>nwH  
测试代码! 9tHK_),9  
PK+sGV  

图片:1-1Q113230G5391.png

RBQ8+^  
6=f)3!=  

图片:1-1Q113230I3W0.png

?oYO !  
Sp\TaUzg  
文件信息 xSud
DhRP  
6l\5J6x  

图片:1-1Q113230K5B1.png

\B#tB?rA  
^*AI19w!Ys