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

摘要 z'9U.v'M)  
n+57# pS7  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 jdX*  
x K ;#C  

图片:1-1Q113224953T4.png

hf\/2Vl  
2GxkOch  
可编程界面所在位置：目录 d]K
$0HY  
[=TD)o>W(p  

图片:1-1Q11322501Y47.png

Vr:`?V9Q2(  
ML.|\:r*  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 bJcO,M:2  
ZkryoIQ%=  
可编程界面所在位置：组件 ^#!\VGnL  
.dsB\C  

图片:1-1Q1132251523M.png

@^.o8+Pp  
L
T#EYnG  
编写代码 .q<5O
E(f  
9v/=o`J#  
•右侧面板显示了可用的独立参数列表。 <+Gf!0i  
•x和y表示独立变量，即平面上的2D坐标。 ue*o>iohB  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 lS]6SkZ6  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。
^Rh}[  
•使用Snippet Body将支持函数中的部分代码分组。 [r1dgwh8  
7c!#e=W@B  

图片:1-1Q1132253435R.png

mFmx
Ev  
DWS#q|j`"  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 &$ fyY:<\  
~gaWZQXyu  
表面梯度的定义 V  n+a-v  
n#
sK31;yb  
•精确计算界面的梯度是光学仿真的基础。 ?R_fg  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 mqbCa6>_S  
r>gf&/Pl  

图片:1-1Q1132254294X.png

M+I9k;N6&  
`FwE^_9d  
用户自定义的表面梯度 4";NT;_q5  
4X!4S6JfB  
}0sLeGJ!  
•右侧面板显示了相同的可用独立参数列表。 RKZBI?@4  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 cl`7|;v|?  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ 1'P4{T0 [  
3 2"f'{  

图片:1-1Q113225625919.png

T\#Gc4  
KWM.e1(  
可编程界面的输出 _GM?`  
%{rPA3Xoy  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 ss6{+@,  
•在有需要时，可在实际组件内直接编程自定义界面。 %`~+^{Wp  
•或者，将其保存在目录中供后续使用。 9{e/ V)  
j3H_g
^  

图片:1-1Q113225FL09.png

9GsG*$-I  
]~~G<Yh:=  
对球形表面进行编程 KyQTrl.qdl  
L2_[M'  
球形表面 e*}:tH  
"G,,:H9v  

图片:1-1Q113225P1295.png

yo(MJ^=d  
)a5ON8?  
可编程界面所在位置：目录 e"*1l>g  
lr[T+nQ  

图片:1-1Q113225ZY61.png

]O{i?tyX  
VFMn"bYOB  
可编程界面所在位置：组件 ^>>9?  
We\i0zUU  

图片:1-1Q11322592b42.png

D>;_R HK  
d`C$vj  
设置表面的定义区域 W /*?y&  
w^=(:`  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 Jt#HbAY  
•在本例中，我们使用圆孔。 q317~z_nl  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ Z:Vde^Ih  
oO`a{n-  

图片:1-1Q1132259514E.png

x%9Ca)r?}  
c5uC?b].  
进入可编程界面 Gy;Fe=  
mlLqQ<  

图片:1-1Q113230035R8.png

[b&V^41W  
J#FHR/zV  
可编程界面：全局参数 xWqV~NnE  
sa _J6~  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 A.@wGy4  
•在那里，添加和编辑一个参数： + !"YC  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 _Pa@%/  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 V~ MsGj  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 l_$>$d  
:Ny[?jtc  

图片:1-1Q11323011A22.png

nqx0#_K-E  
E2t&@t%W  
可编程界面：代码段帮助（Snippet Help） j
JNl{nyq  
sZxTsUW  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 tZm`(2S  
•此选项对于使用可编程元素跟踪进度非常有用。 ZMr[:,Jp  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ Q4*{+$A  
<P ?gP1_zi  

图片:1-1Q11323015HB.png

.Ln98#ZR  
D5({&.X[-  

图片:1-1Q113230325X3.png

W8u&5#$I  
f*88k='\W  
可编程界面：编写代码 t^>P,%$  
__s'/6u  

图片:1-1Q113230354L2.png

=./PY10'  
>?)_, KL  
可编程界面：用户自定义梯度 F|/6;&*?M  
BB9eQ: xO  

图片:1-1Q113230414a1.png

]q4LNo  
可编程界面：使用您的代码段（Snippet） vXwMo4F*  
6/Yo0D>M$  

图片:1-1Q113230441529.png

8.^`~ta  
jk_yrbLc  
可编程界面的输出 ?/5<}W#7}  
y!
:vX6l  

图片:1-1Q113230513340.png

1M?x,N
_W  
3D5adI<aq"  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） 23K#9!3  
}?Pa(0=U  
将自定义界面保存到目录中 _8-1wx  
p[%~d$JUq  

图片:1-1Q11323055K33.png

F3$8l[O_  
6Fk[wH7  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 Au/'|%2#(  
WLh!L='{BK  
故障排除提示 .#a7?LUH  
Uvi@HB HJ  

图片:1-1Q11323062S59.png

CN-4FI)1D9  
A,4} $-7  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ #a9R3-aP  
L"?4}U:  

图片:1-1Q113230A3617.png

DAtAc(05)  
p&`I#
6{  
测试代码! BtJF1#f  
" ;8kKR  

图片:1-1Q113230G5391.png

YY7dw:>e/  
QZO<'q`L  

图片:1-1Q113230I3W0.png

u`-
:'@4  
ogdAJw6 9  
文件信息 )^)|b5,  
,s@S`KS0  

图片:1-1Q113230K5B1.png

5$$]ZMof  
z!~{3M