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

摘要 S z3@h"  
O6LuFT.  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 Ol,Tw=?  
| %Dh  

图片:1-1Q113224953T4.png

24T
Ql<H{  
p+O2:  
可编程界面所在位置：目录 m)A~1+M$)L  
CvwC| AW  

图片:1-1Q11322501Y47.png

>-s\$8En'  
(z}q6Lfa  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 MLL4nkO,`  
t?1+Yw./em  
可编程界面所在位置：组件 L}bS"=B[&W  
,= ;d<O8  

图片:1-1Q1132251523M.png

UIUCj8QJg  
,&II4;F  
编写代码 $e=pdD~  
tN'-4<+  
•右侧面板显示了可用的独立参数列表。 r@_`ob RW;  
•x和y表示独立变量，即平面上的2D坐标。 S C8r.
  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 }";\8  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 .=WsB@+   
•使用Snippet Body将支持函数中的部分代码分组。 }c>[m,lz  
vHY."$|H  

图片:1-1Q1132253435R.png

kKV`9&d
Ze  
`ySm
zp  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 zV(F9}^  
9rr"q5[  
表面梯度的定义 x0ZEVa0`4  
o}XbFLn  
•精确计算界面的梯度是光学仿真的基础。 -k
p!.c  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 A$K>:Tt>  
S7cxEOfAu  

图片:1-1Q1132254294X.png

6m_whGosi  
ORPQ1%tu  
用户自定义的表面梯度 0hTv0#j#  
rrGsam\.  
DP=4<ES%+  
•右侧面板显示了相同的可用独立参数列表。 5>J{JW|  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 <<@vy{*Hg  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ ^<0u~u)%T  
&J~vXk: !  

图片:1-1Q113225625919.png

M<t>jM@'A#  
WlHw\\ur  
可编程界面的输出 o(iN}.c  
Xg|_  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 Jsee8^_~  
•在有需要时，可在实际组件内直接编程自定义界面。 d($f8{~W  
•或者，将其保存在目录中供后续使用。 ='1J&w~7  
Gld|w=qr  

图片:1-1Q113225FL09.png

3lc'(ts%  
VmLV:"P}^  
对球形表面进行编程 Py$*c  
2| u'J  
球形表面 uJ<sa;  
=4z:Df  

图片:1-1Q113225P1295.png

73?ZB+\)0A  
[4:_6vd7X  
可编程界面所在位置：目录 \BC|`)0h  
.aWEXJ  

图片:1-1Q113225ZY61.png

cyq]-B  
.YquOCc(  
可编程界面所在位置：组件 ,^MA,"8  
C<CE!|sfr  

图片:1-1Q11322592b42.png

L^:+8g  
q^],K'  
设置表面的定义区域 8UArl
3  
wy5vn?T@  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 CybHr#LBc  
•在本例中，我们使用圆孔。 M9{?gM9  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ yW.s?3X  
7_ g}t!b`  

图片:1-1Q1132259514E.png

%of#VSk  
#z{9:o7[-  
进入可编程界面 *h Ph01  
I^'kt[P'FZ  

图片:1-1Q113230035R8.png

<7TE[M'  
is`Eqcj`dr  
可编程界面：全局参数 |,F/_   
rt] @Z`w  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 7-81,ADv(  
•在那里，添加和编辑一个参数： o >bf7+D  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 b]hP;QK`U$  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 Two$wL/  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 afRUBjs  
=BpX;n<  

图片:1-1Q11323011A22.png

IpQ5
1  
VJ P]Jy_  
可编程界面：代码段帮助（Snippet Help） #imMkvx?  
UahFs  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 SlvQ)
jw%  
•此选项对于使用可编程元素跟踪进度非常有用。 IGs!SXclCs  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ 7>`QX%  
B3u
v>\  

图片:1-1Q11323015HB.png

N?0T3-/K  
P X?!R4S  

图片:1-1Q113230325X3.png

DWDL|4 og  
weC$\st:D  
可编程界面：编写代码 Px:
PoOw\  
\:C@L&3[  

图片:1-1Q113230354L2.png

Qy |*[  
Jla ;^X  
可编程界面：用户自定义梯度 t5n$sF  
4;8 Z?.  

图片:1-1Q113230414a1.png

wYZFW'5p  
可编程界面：使用您的代码段（Snippet） :~BY[")  
L2Uk/E  

图片:1-1Q113230441529.png

MnUal}MO  
Hw[u Sv8  
可编程界面的输出 x]6OE]]8L  
nE)?P*$3Z  

图片:1-1Q113230513340.png

x7 jE Ns )  
1QXv}36#3n  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） !u@e^J{Ao  
e>1z1Q;_uv  
将自定义界面保存到目录中 * 3mF.^  
HjUs}#</  

图片:1-1Q11323055K33.png

`yJpDGh  
($&i\e31N  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 ve_TpP  
[5^"U+`{x  
故障排除提示 /qA\|'~  
k2muHKBlk  

图片:1-1Q11323062S59.png

37Vs9w  
d4F3!*@(  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ yU3fM?
a  
P#bZtWx'<N  

图片:1-1Q113230A3617.png

82Dw,Cn  
yhg^1l|t,  
测试代码! n#,|C`2
r  
w=I8f}(  

图片:1-1Q113230G5391.png

Hzh?w!Ow  
lO>w|=<  

图片:1-1Q113230I3W0.png

 RSXYz8{  
jHq.W95+P  
文件信息 ju`x   
_oxhS!.*  

图片:1-1Q113230K5B1.png

PJLSDIeN  
TyVn5XHl^