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

)+,h}XqlX  
为您的光学仿真提供最大的多功能性是我们的宗旨之一。在本文档中，我们将向您展示如何编写自定义表面：即如何定义高度函数h(x，y)。该函数是在参数化平面上用x，y坐标来表示3D表面。我们可以使用这些表面来配置系统中的光学组件。在VirtualLab的默认模板中，我们提供最基本的锥形表面; 但在本教程中，我们使用球面作为简单的编程示例。 *m>[\)  
 yoe@]c=  
N5K2Hv<"  
    可编程界面所在位置：目录 <?DI!~  
t(6i4c>  
6~{'\Z  
提示：您可以在界面目录中保存自定义界面“customized interface”（作为用户自定义“User Defined”）供以后使用。 @aFk|.6  
47{5{/B-  
可编程界面所在位置：组件 &'Nzw2  
Fx1FxwIJ  
%}~(%@qB>+  
Zi\ex\ )5  
     g__s(  IJ  
编写代码 =\5f_g2M  
:?ZrD,D  
]^wr+9zd  
•右侧面板显示了可用的独立参数列表。 >hG*=4oh  
•x和y表示独立变量，即平面上的2D坐标。 3gJZlH5IR  
•由孔直径X“ApertureDiameterX”和孔直径Y“ApertureDiameterY”（两者都在界面的常规配置对话框中确定）来定义x和y的间隔。 T <k;^iqR  
•主函数中的代码必须每x，y点返回一个双精度“double”类型的值。该值表示该点的高度。所有这些高度值的集合定义了3D表面。 >fT%CGLC0  
•使用Snippet Body将支持函数中的部分代码分组。 74 )G.!  
Vep41\g^  
M5:*aCN6P  
e~'z;%O~  
        提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元素具有等效功能。 Tz9 (</y  
j}tGcFwvSN  
表面梯度的定义 LH_U#P`E  
c8Q2H  
f2Xn!]o  
•精确计算界面的梯度是光学仿真的基础。 69:-c@L0  
•VirtualLab中的可编程界面允许两种不同的梯度定义模式：数值模式，具有可调精度（由软件自动执行）或解析模式（由用户另外编程）。 b9T6JS j  
IW@phKz  
<:nyRy}  
用户自定义的表面梯度 `YZl2c<w*  
>mMfZvxl%  
.qYQ3G'V  
•右侧面板显示了相同的可用独立参数列表。 {^;7
DV:  
•该情况下，主函数中的代码必须返回一个向量D“VectorD”——一个带有两个双精度“double”（实值）坐标的向量。使用Snippet Body将支持功能中的部分代码分组。 \3K7)o^  
•尽可能使用梯度的解析定义，以获得更准确的替代方案。软件会检查代码的一致性，但用户必须确保为梯度输入的函数与相应的界面一致！ UpSJ%%.n  
fJk'5kv  
<u# 7K\:  
#s>'IPc0  
可编程界面的输出 #k>A,  
7\nXJ381  
;+o6"ky5  
•输出是3D表面，其可用于定义系统中实际光学组件的界面。 DVg$rm`  
•在有需要时，可在实际组件内直接编程自定义界面。 8*B+@`  
•或者，将其保存在目录中供后续使用。 $txF|Fj]^A  
Ayn$,  
]WcN6|b+  
'q}f3u
>  
     Kf$(7FT'`  
     (LXYx<  
     N6+^}2'*)  
      [Ne'2z  
对球形表面进行编程 /S~ =qodS  
    球形表面 FK-q-PKO#.  
%" l;  
;
9ChBA  
    可编程界面所在位置：目录 |:2B)X  
i!RYrae  
9OY ao  
     x7i<dg&  
可编程界面所在位置：组件 {%y|
A{}c  
uT<<G
)v)  
D8Mq '$-  
设置表面的定义区域 O%F*i2I:+k  
~MYE8xrId  
aiE\r/k8s  
•在进入编程界面之前的配置对话框中，用户可以定义表面定义区域（参数化）的形状和大小。 [)0^*A2  
•在本例中，我们使用圆孔。 a+~b3  
•请记住，球形表面的定义区域有一个自然限制，由其直径给定，在其外部没有定义表面！ 5U]@ Y?  
?(Plb&kR  
:kwDa a  
进入可编程界面 7d|1T'  
2:nI4S  
cg9}T[A  
3=Rk(%:;  
可编程界面：全局参数 \M0's&1(  
!su773vo  
OZ"76|H1`  
•打开编辑对话框（源代码编辑器）后，转到全局参数选项卡。 yA_ly <  
•在那里，添加和编辑一个参数： m
9&%A0  
- 双精度“double”半径= 10毫米（-1米，1米）：球面曲率半径。 jWh)bsqI!  
•使用带有小“注释”图标的按钮可以为您的自定义全局参数添加一些说明。 YH^@8   
        提示：此处可能有必要添加一些陈述文本以促进其他使用者理解和使用代码段。 KQw>6)  
=d:3]M^
 

E m+&I  
#,XZ@u+  
    可编程界面：代码段帮助（Snippet Help） :^>&t^E  
v
?Cakwu  
q6>}  
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些其他数据。 :7dc;WdM  
•此选项对于使用可编程元素跟踪进度非常有用。 ,]]IJ;:w  
•当可编程元素被发送给其他用户处理时，它的作用发挥得尤为明显！ QF*cdc<  
)"6"g9A  
&k-NDh3  
YmjA
!n  
5tZ0zr  
     ssoE,6kS  
可编程界面：编写代码 W@'*G*f  
ZBN,%P!P0  
fH:S_7i  
v*<rNZI  
可编程界面：用户自定义梯度 `P*BW,P'T  
=20 +(<  
734n1-F?I%  
可编程界面：使用您的代码段（Snippet） <63TN`B  
)/~o'M3  
ucU7 @j  
}_^ vvu  
可编程界面的输出 Q&^\YgkCf  
h%4UeL &F  
>Q[ Z{  
+*Uv+oC|  
此表面由代码完全解析定义——完全准确“full accuracy”（达到双精度水平） e+4Eiv  
Y"yrc0'&T  
将自定义界面保存到目录中 Ck"db30.  
u7Ix7`
V  
`Lavjmfr2V  
_Rkvg-  
提示：如果您使用目录来定义您的自定义界面，系统将会自动提示您将工作保存到目录中。 8pftc)k  
u%I%4 gM  
故障排除提示 ^W@%(,xb  
ZU+_nWnl  
g#7Q-n3^  
H=g%>W%3  
您注意到自定义表面3D可视化中奇特的边界效果“border effects”了吗？ ,&o^}TFkg  
(uhE'IQ{(  
[/VpvQ'  
7l~^KsX  
     Y%- !%|  
测试代码! PB5h5eX  
     UX<-jY#'V  
*p#@W-:9E  
     Z2H bAI8