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

摘要 +a/o
)C{  
aJ8pJ{,P  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 >|?T|  
H#inr^Xa  

图片:1-1Q113224953T4.png

4*x!B![]y  
9$&e~^&B  
可编程界面所在位置：目录 ^%&x{F.  
c~xo@[NaS  

图片:1-1Q11322501Y47.png

ImY.HB^&  
 3Mx@  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 7X(]r1-+\  
It4z9Gh  
可编程界面所在位置：组件 rf->mk{  
}4SSo)Uv/  

图片:1-1Q1132251523M.png

y.p6%E_`  
N@6OQ:,[F  
编写代码 hFMst%:y$  
rxj@NwAno  
•右侧面板显示了可用的独立参数列表。 87KrSZ  
•x和y表示独立变量，即平面上的2D坐标。 o^Ysp&#p  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 .vS6_  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 y?n2`l7f  
•使用Snippet Body将支持函数中的部分代码分组。 "F$o!Vk  
H'{?aaK|t  

图片:1-1Q1132253435R.png

>}b6
J7_  
S tnv>  
提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 f&}A!uLe4x  
tx5T^K7[  
表面梯度的定义 ZuvPDW%  
!?o$-+a|  
•精确计算界面的梯度是光学仿真的基础。 !UoU
#YU  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 1@^Ek8C  
zL
Q#GF  

图片:1-1Q1132254294X.png

ydND$@; Z  
q|o|/O-{  
用户自定义的表面梯度 4su_;+]  
#[a"%byTR  
J+b!6t}mZn  
•右侧面板显示了相同的可用独立参数列表。 xN3 [Kp  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 pAil]f6  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ B9e.-Xaf  
NdsX*o@a  

图片:1-1Q113225625919.png

)ojx_3j8  
px_s@>l`  
可编程界面的输出 cRh\USS  
5, -pBep<  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 HX3D*2v":  
•在有需要时，可在实际组件内直接编程自定义界面。 hu P^2*c  
•或者，将其保存在目录中供后续使用。 >X[|c"l.  
RQ^m6)BTo  

图片:1-1Q113225FL09.png

%9T~8L @.  
mA(nyF  
对球形表面进行编程 w dGpt_  
t/KcXM  
球形表面 ^n&]HzT`y  
q Vm"f,ruo  

图片:1-1Q113225P1295.png

GS ;HtUQ  
5zNSEI"PY  
可编程界面所在位置：目录 =[]x\&@t  
AqV09 $  

图片:1-1Q113225ZY61.png

K,f* SXM  
FZe:co8Mu  
可编程界面所在位置：组件 x37/cu  
59{;VY81  

图片:1-1Q11322592b42.png

(U|)xA]y!  
Dv<wge`  
设置表面的定义区域 I@n*[EC   
)@}A r  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 O(VxMO  
•在本例中，我们使用圆孔。 SQ}S4r  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ vO\:vp4fH  
i=
oTg  

图片:1-1Q1132259514E.png

WgE@89  
bqSMDK  
进入可编程界面 @-0Fe9 n=  
s(teQ\  

图片:1-1Q113230035R8.png

'%R<"  
"tqnx?pM  
可编程界面：全局参数 lM>.@:  
>-!r9"8@  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 Nepi|
{  
•在那里，添加和编辑一个参数： p"2m9
0IO  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 .}o~VT:!?Y  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 W3)\co  
提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 ;AKwx|I$g  
!x>,N%~  

图片:1-1Q11323011A22.png

Mm5c8[   
bl=ku<}@  
可编程界面：代码段帮助（Snippet Help） }MP>]8Aq  
A_Rrcsl4  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 'r\ 4}Ik  
•此选项对于使用可编程元素跟踪进度非常有用。 I7~|~<  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ =J](.78  
fN@{y+6  

图片:1-1Q11323015HB.png

uAUp5XP|Z  
5Q W}nRCZ  

图片:1-1Q113230325X3.png

M ,`w A  
{{\ce;hN  
可编程界面：编写代码 2VA
!&`I  
V,Q4n%h1.  

图片:1-1Q113230354L2.png

L_Q S0_1
 
A|L'ih/  
可编程界面：用户自定义梯度  S(  
RbEKP(uw  

图片:1-1Q113230414a1.png

DN_W.o  
可编程界面：使用您的代码段（Snippet） E8ta|D  
2
o4^  

图片:1-1Q113230441529.png

Y]Vq\]m\  
Z+4D.bA  
可编程界面的输出 bWmw3w  
T]9m:zX9s  

图片:1-1Q113230513340.png

+.kfU)6@  
T.ML$"f  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） yCP4r6X0  
IeP W
Opj3  
将自定义界面保存到目录中 w!&~??&=}  
ok{!+VCB5  

图片:1-1Q11323055K33.png

AX
PMnbUS  
nB5zNyY4  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 +?dl
`!rE  
/.1.MssQM  
故障排除提示 _zMgoc7  
'e!J06  

图片:1-1Q11323062S59.png

;j%BK(5  
,xfO;yd  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ [eUf
tr9&0  
6"f}O<M5H  

图片:1-1Q113230A3617.png

7.g[SBUOG  
nNt1C  
测试代码! O"G >wv  
S*
*oA 6  

图片:1-1Q113230G5391.png

[U/(<?F{(  
hrGH}CU"  

图片:1-1Q113230I3W0.png

Z\}K{#   
=#gEB#$x:  
文件信息 s?R2B)a  
P [Uy  

图片:1-1Q113230K5B1.png

~@.%m"<.  
={>Lrig:l