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

摘要 _6(QbY'JV`  
5L%A5C&|  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 NAlYfbp  
l+Uy  

图片:1-1Q113224953T4.png

F2:?lmhL<  
AMGb6enl  
可编程界面所在位置：目录 SZea[~&  
ci <`*>l  

图片:1-1Q11322501Y47.png

wZ5+ H%x  
#B_ ``XV  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 =i4Ds  
U8PSJ0ny  
可编程界面所在位置：组件 4&2aJ_ 2y  
2r^|  

图片:1-1Q1132251523M.png

%c*azo.  
;|5m;x/a  
编写代码 HE,# pj(D  
,nD:W  
•右侧面板显示了可用的独立参数列表。 rp (nGiI  
•x和y表示独立变量，即平面上的2D坐标。 oDXUa5x  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 _ko16wfg  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 l}
A8  
•使用Snippet Body将支持函数中的部分代码分组。 8A~5@  
!'Q/9%g  

图片:1-1Q1132253435R.png

w(zlHj  
y'(l]F1]  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 h/j+b.|  
lU`]yL  
表面梯度的定义 !ZPa
U11  
mFC0f?nr  
•精确计算界面的梯度是光学仿真的基础。 I9-vV>:z  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 }SR}ET&z  
:UGc6  

图片:1-1Q1132254294X.png

DG}} S5  
-{dsl|Dl  
用户自定义的表面梯度 (iXo\y`z  
'8R5?9"  
E"ijNs  
•右侧面板显示了相同的可用独立参数列表。 ;I1}g]  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 dlsVE~_G  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ Dm?>U1{   
n7>CK?25  

图片:1-1Q113225625919.png

=\GuIH2  
NHG+l)y:  
可编程界面的输出 uDJi2,|n  
fOs"\Y4  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 RsIR}.*  
•在有需要时，可在实际组件内直接编程自定义界面。 -'*\KA@u  
•或者，将其保存在目录中供后续使用。 #05#@v8.f  
(\}>+qS[  

图片:1-1Q113225FL09.png

St}j^
i  
tkx1iBW=  
对球形表面进行编程 z;yb;),  
~0aWjMc(>  
球形表面 Hg\+:}k&9  
xs_l+/cZ  

图片:1-1Q113225P1295.png

6m"_=.k%  
=X6WK7^0  
可编程界面所在位置：目录 t2d_XQOK  
{KYbsD  

图片:1-1Q113225ZY61.png

GP6-5Y"8  
a<9cj@h  
可编程界面所在位置：组件 ^_BHgbS%;  
O)NEt  

图片:1-1Q11322592b42.png

(,<&H;,8  
!4cO]wh5  
设置表面的定义区域 *F|j%]k~  
lX$6U|!  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 ICwhqH&  
•在本例中，我们使用圆孔。 `oQ)qa_  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ q|,cMPS3  
gU1E6V-Jm  

图片:1-1Q1132259514E.png

\lwYDPY:  
<+ 0cQq=2  
进入可编程界面 HH =sq  
q y"VrR  

图片:1-1Q113230035R8.png

+^1E0@b%  
<20rxOEnf  
可编程界面：全局参数 0?59o!@h  
(GB2("p`  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 )2t!= ua  
•在那里，添加和编辑一个参数： .zxP,]"l  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 Cj^:8 ?%  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 3NRxf8  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 /c
/t_xB  
."9t<<!  

图片:1-1Q11323011A22.png

JQ|qg\[  
8;2UP`8s?  
可编程界面：代码段帮助（Snippet Help） 0ant0<  
S0?4}7`A  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 C%P)_)--V  
•此选项对于使用可编程元素跟踪进度非常有用。 &
E|2-
)  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ pUtd_8  
v_-S#(  

图片:1-1Q11323015HB.png

_cra_(b  
PAG.],"D  

图片:1-1Q113230325X3.png

*K#7,*Oz  
R'bmE:nL  
可编程界面：编写代码 bH+x `]{A  
=*EIe z*.x  

图片:1-1Q113230354L2.png

jM`)Nd  
($a ?zJr  
可编程界面：用户自定义梯度 Pp-\#WJ  
~<b/%l>h1  

图片:1-1Q113230414a1.png

X"QIH|qx-  
可编程界面：使用您的代码段（Snippet） ~P&Brn"=Rs  
05eth  

图片:1-1Q113230441529.png

a(}dF?M=  
VxD_:USIF  
可编程界面的输出 C'8v\C9Ag  
27mGX\T  

图片:1-1Q113230513340.png

yh9fHN)F  
o+
(>/Ou  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） 1~BDtHW7`n  
r(sQI# P  
将自定义界面保存到目录中 A)9[.fhx  
gq9D#B  

图片:1-1Q11323055K33.png

0Y rdu,c  
'u@_4wWp  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 ^`b&fbv  
lZT9 SDtS  
故障排除提示 Hg8n`a;R  
Q\(VQ1c  

图片:1-1Q11323062S59.png

yn&AMq ]o  
X r7pFw  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ Q y(Gy'q~  
|$[WnYP  

图片:1-1Q113230A3617.png

En&bwLu:s  
gucd]VH  
测试代码! _?UW,5=O  
!N5+.E0j  

图片:1-1Q113230G5391.png

'qD5  
w k1O*_76  

图片:1-1Q113230I3W0.png

|ocIp/$  
+<p?i]3CHe  
文件信息 \BB(0Ah+t  
,:yv T6)p  

图片:1-1Q113230K5B1.png

-[-LR }u  
B<.XowT'