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

摘要 <4D.P2ct  
0LN"azhz  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 o[&*vc)  
YyjnyG  
M qFuZg  
可编程界面所在位置：目录 R~PD[.\u  
g>u{H:  
7c5+8k3  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 R:fERj<s  
Fe{lM' 8  
可编程界面所在位置：组件 ^yyL4{/  
qwoF4_VN  
ewvFUD'j  
sZx
f.  
|@!4BA  
编写代码 Lzm9K
h;  
lpvZ[^G  
Eg$ I  
•右侧面板显示了可用的独立参数列表。 MZZEqsD5[  
•x和y表示独立变量，即平面上的2D坐标。 WzDL(~m+Z  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 DQui7dr)l  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 CD]"Q1 t}  
•使用Snippet Body将支持函数中的部分代码分组。 )O;6S$z9Y  
Wl\.*^`k  
:2ILN.&  
8eGq.+5G  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 ~ HN  
$F2A  
表面梯度的定义 4L)#ku$jW  
n W:P"L  
oG{0{%*@  
•精确计算界面的梯度是光学仿真的基础。 }M7{~ov#s  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 3)cH\gsg9  
4AW-'W  
gc,%A'OR^<  
用户自定义的表面梯度 Kg?(Ax4  
5e1;m6  
v,, .2UR4  
•右侧面板显示了相同的可用独立参数列表。 icS%])3LF  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 ]L)l5@5^  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ w>S;}[fM  
=[5F~--Tf  
{8]Yqx)1]]  
*62Cf[a  
可编程界面的输出 ~/C9VR&  
inQ1$  
l5P!9P  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 [A\DuJx  
•在有需要时，可在实际组件内直接编程自定义界面。 (r*"}"ZG  
•或者，将其保存在目录中供后续使用。 -A1@a=q  
^-nL!>FYY  
`s8*n(\h  
q8 &\;GK|  
%/;*Ewwb  
FT8<a }o  
9t8NK{
  
T:/mk`>  
对球形表面进行编程 D*0[7:NSO  
球形表面 db*yA@2Lg  
8f`r!/j  
|-l9Z  
可编程界面所在位置：目录 e92,@  
-sqd?L.p  
w 3kX!%a:  
K&4FFZ  
可编程界面所在位置：组件 @js`$  
{q!GTO
 
zu_bno!  
设置表面的定义区域 z&wJ"[nOC  
utzf7?nIS  
E[NszM[P  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 u(W>HVEG  
•在本例中，我们使用圆孔。 xYp-Y"a.  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ b9R0"w!ml  
joA>-k04  
x1`4hB  
进入可编程界面 R :*1Y\o(  
`(uN_zvH  
u u$Jwn!S  
9y}/ G  
可编程界面：全局参数 XOL_vS24  
PiIP%$72O  
+aQM %~  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 2WUl8?f2Y  
•在那里，添加和编辑一个参数： oM^VtH=>  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 h$]nfHi_Q  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 =F% <W7  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 *X!+wK-+  
.npD<*  
GdM|?u&s"  
Gs/G_E(T  
可编程界面：代码段帮助（Snippet Help） $}EI3a  
_"t"orD6  
"^)$MAZ  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 D}rnpwp{  
•此选项对于使用可编程元素跟踪进度非常有用。 KwY6pF*  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ 4N)45@jk[  
O[8wF86R  
*XI- nH  
z s\N)LyM  
8&:dzS  
!jR 1!i  
可编程界面：编写代码 
z $iI  
_xM}*_<VP  
io
w"X6_l_  
~H4Tr[8a  
可编程界面：用户自定义梯度 (g>&ov(d  
zG7y$\A  
xUPg~c0  
可编程界面：使用您的代码段（Snippet） ,V
y_%f  
n){u!z)Al  
7yal  T.  
~X-v@a  
可编程界面的输出 3 jghV?I{T  
6RfS_  
CN6b982&  
&r!jjT  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） ?s]?2>p  
m'eM&1Ba  
将自定义界面保存到目录中 82YZN5S3]3  
L;U?
s2&Y  
i'
`>YX  
~PX#' Jr  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 BSY7un+`:  
s,j=Kym%  
故障排除提示 g{Hb3
id9  
zCrM~  
~Efi|A/  
IIAm"=*  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ in>?kbaG+  
36d6KS 7  
Bam 4%G5  
 -K4uqUp  
lGEfI&1%!  
测试代码! wx^1lC2  
QaLVIsnfN  
5ZjM:wrF|  
`<?((l%;R  
w_#5Na}>d  
30QQnMH3  
文件信息 > M4QEv  
!I Byv%m&\  
rk `]]  
8'0KHn{#  
`3vt.b  
QQ：2987619807 { pu .l4nk