>aO.a[AM 为您的
光学仿真提供最大的多功能性是我们的宗旨之一。 在本
教程中，我们将介绍可编程探测器：可以最大限度地灵活地访问矢量场中包含的任何物理信息或到达探测器的
光线（取决于
模拟引擎）。 我们在这里使用一个简单的编程示例来说明其操作流程。
BL16?&RK 7UMZs7L$ 
rBTg"^jsw 6Qt(Yu*s 可编程探测器所在位置：目录 |di(hY| D`a6D 
M
x#L|w`r (is' ,4^b 可编程探测器所在位置：光学系统 -|#{V.G3' CE`]X;#y 
:&vX0
Ce: 关于光表征的注释 V RQ`-# @9HRGxJ =} zY_J7,0g 在物理光学中表示光的矢量电磁场在VirtualLab Fusion中始终可以通过系统进行追迹。
9efey? z •从计算效率的角度来看，为了使这种方法更实用，最重要的是拥有一套多样化的数学技术（高效傅里叶变换算法，插值和拟合方法，异构采样机制等）。
jL\j$'KC •在当前版本的VirtualLab Fusion中，该技术由多个模拟引擎的共同呈现：
Qq`S=:}~x - 光线追迹：纯光线追迹，产生2D和3D结果
<}{<FXk[ - 经典场追迹：可处理等距采样的EM场数据
iv~R4;;) - 第二代场追迹：还能够处理非等距的EM场数据
j*?8w(! •这与可编程探测器相关：探测器的良好实施需要考虑不同引擎中的光线表现方式！
T:@6(_Z >^jBE'' 
//2O#Fg{/ lfHN_fE>Mq 关于光表征的注释 \DQu!l@1U {fA CfSW6 2j%=o?me^p •此外，为了表达光的一系列重要物理属性（部分相干，例如，无论是时间还是空间），VirtualLab使用模态分解。
o{,I O! q hi!A9T3%}M •可通过一系列索引在可编程探测器中访问不同的模态。
z1Ieva] 6~% ><C •如果要可编程探测器呈现要求的正确物理特性，则考虑不同的模态也是至关重要的！
HRyFjAR\? 6^LXctW. 
LVB wWlJ q8d](MaX 编写代码：等距场数据 kJ5z['4 ? .8|wc p6<JpW5@_ •可编程探测器提供两种不同的编程控制设置。 这些与模拟引擎有关。 第一个标题为等距场数据的代码段，处理在等距矩形x，y网格上采样的电磁场对象。
$WIVCp •这是麦克斯韦方程的直接结果，在均匀介质中，六个电磁分量中只有两个是独立的; 因此，到达探测器的仅由Ex和Ey分量组成，所有其他分量因此可以明确地按需计算。
?0/$RpFEM# •根据输入场的偏振特性，Ex和Ey可以是两个独立的函数（局部偏振），也可以通过常数Jones'向量（在x和y是常数）从单个场函数U获得，因此Ex = Jx * U和Ey = Jy * U。
YQN:&Cls !~vK[G(R 
i|1*b Z6' c1k[)O ~ 提示：全局
参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元件一致。
!YAX .e 5,gT|4|B\g 编写代码：等距场数据 RD:G 9[ =l43RawAmu %jjPs . •右侧面板显示可用的独立参数列表。
u4~+Bc_GL •IndexOfDetector和IndexOfLinkage指的是包含相关探测器的光学系统配置中的相应元件。
)\Q (=: •SystemTemperature和SystemPressure是整个系统的参数，其值可以在代码中用于实现与温度和压力相关的响应。
tC'E#2 •AutomaticFieldSize，...，ManualNumberSamplingPoints是影响最终等距采样场结果的参数，其值可在探测器配置对话框的“探测器窗口”和“分辨率”选项卡中进行修改。
1@L18%h uM` i!7} 
%JE>Z] wH o}wp 提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元件一致。
l'(FM^8jv 2V)+ ba|+ 编写代码：等距场数据 Gf"TI:xa vd lss| }dzdx " •ResolveLinearPhase和ResolveRelativePosition是标志，其值可在探测器配置对话框的“探测器函数”选项卡中进行修改。 它们表明用户希望保持存储在光场内部坐标系中的线性相位和位置移位，或相反地，精确地分辨（这导致更高的采样要求，如Shannon-Nyquist所示）。 程序员有责任实现能够以某种方式正确反映这些愿景的代码。
~Q_7HJ=^$ •InputField表示到达探测器的光场（等距采样）。 遵循VirtualLab的模式概念，它由一组完全自相关的电磁模式组成，它们之间可以表现出不同的相干特性，如实地模拟物理场的相干特性。
oM!&S'M/ •ParentLightPath是指包含相关探测器的光学系统。 使用Snippet Body将支持函数中的部分代码分组。
>*{k~Y-G 'd$RNqe 
~-zIB=TyK 提示：全局参数（Global Parameters），代码段帮助（Snippet Help），高级设置选项卡（Advanced Settings tabs）和界面的其他方面与VirtualLab中的其他可编程元件一致。
W\zZ&*8$ P'qBqx[ 编写代码：非等距场和光线数据 (U & wvq4 P t\ oud{Cv •可编程探测器中的另一个编程对话框处理非等距采样的场数据和光线。
Z|E9}Il] •右侧的面板再次显示可用的独立参数列表。
v > wN
O •与等距采样场的代码段的唯一区别在于InputField被RayTracingResult替换。
,kJ7c;:i •不要让RayTracingResult这个名字欺骗你！ 这种术语已经过时，将在未来的版本中逐步淘汰。
a|z-EKV •对于非等距场，矢量场样本可能与光线样本重合。 因此，当所选引擎是第二代场追迹时，此代码段可以返回光线信息（如果使用光线追迹引擎运行模拟）和物理光学结果。 程序员有责任考虑这两种情况。
PN 93.G(W &qS%~h%2 
CO`)XB6W 输出 i1uoYb?4(I u"qVT9C$= 
J|
N 6r 6
^3RfF^W [bHm-X] •对于两种代码段，可编程探测器必须返回DetectorResultObject []数组。
*eoH"UFYQ# •此类对象可以包含
Fy{yg]O" - 物理量值：例如，计算功率的探测器
R0INpF'; - 2D图形表示：想象一个探测器，显示探测器平面中的所有六个电磁分量。
eI: [o •每一个DetectorResultObject
对应于一个物理量大小或一个2D图形。 [< 53_2]~
•可编程探测器的结果可用于参数扫描或参数优化！ {ze69 h
•自定义探测器可以保存在目录中供以后使用。 |2l-s 1|y
L4Jm8sy{
编程探测器探测入射光谱中的最小和最大波长 jM$bWtq2
fc3 nQp7
要求的自定义探测器的规格 ^ nPy(Q0
AT1cN1:4?
{KHI(*r;
•本例程产生的自定义探测器必须适用光线和场追迹两个引擎。 i-wRwl4aEF
veq3t$sj
•可编程探测器将产生至少三个结果： gttsxOgktH
- 光谱中的样本总数 +H3~Infr4f
- 光谱中存在的最小波长的值 Cw(e7K7&
- 光谱中存在的最大波长的值 Acw`ytV
q?7''xk7
•此外，还将包含用户控制的布尔参数。 VF2,(f-*
.9vS4C
•此布尔参数将允许用户选择是否要返回其他结果：此附加结果对应于到达探测器的光（光线或场）。 ,<L4tp+y0
~k&b
可编程探测器所在位置：目录 Sqn>L`Lz
W$`v^1M2o
/= ;,lC
$^fF}y6N
可编程探测器所在位置：光学系统 s-rc 0:I
&5-1Cd E
w3(G!:
可编程探测器：全局参数 i$] :Y`3h
:<P4=P P
KhWy
•点击打开“编辑”对话框后，转到“全局参数”选项卡。 IaeO0\
4E
•在那里，添加和编辑一个全局参数： 9 wR D=a
- Boolean ShowLight = false（false，true）：用户定义的参数，用于表示确定到达探测器的光（矢量场或光线）是否将作为探测器结果与光谱中波长最小值和最大值一起返回。。 !d()'N
•请注意，“全局参数”，“代码段帮助”和“高级设置”选项卡以及“代码段分段（Snippet Body）”在两种控制模式（等距采样场，光线和非等距采样场）共享和共用。 YxM\qy {Vr
^)9/Wz _x
提示：此处可以添加一些陈述文本以便其他使用者理解和使用该代码段。 Dh`&B
dQIF '== 6
zY\u"
'4
:Ob4WU
可编程探测器：代码段帮助（Snippet Help） 6ZI Pe~`
Hj K8y@j
d\ #yWY
•可选功能“Optional”：您可以使用“代码段帮助”选项卡编写指令，说明以及与代码段相关的一些元数据。 ouCh2Y/_
`
1+*-g^r
•此选项对于使用可编程元件跟踪进度非常有用。 W\Pd:t
N-2#-poDe
•当可编程元件被发送给其他用户处理时，它的作用发挥得尤为明显！ /rZk^/'
u;9iuc` *
PJZ ;wqTD_
0 8L;u7u
I?D=Q $s
5 b rM..
可编程探测器：编写代码（1） liYsUmjZ=
3Y#
H &ek"nP_
'G65 zz
可编程探测器：编写代码（2） !X7z y9
=* 'yGB[x)
4 Vi*Qa_,y
\{<ml n
可编程探测器：比较代码段 )*}\fmOv{
EC$F|T0f
&]a(5
(QIU 3EN
1 0zM8<bl
•变量需要在两个代码段中分别独立声明。 7a9">:~
•甚至可以使用不同的命名法！ 9K}DmS
•程序员有责任确保代码在两个代码段中以相同的方式运行。 vVtkB$]L
•在所有全局参数（包括用户定义的参数）中，只有一个与代码段相关：与光表示相对应的参数（InputField RayTracingResult） KLM6#6`
kq=Htbv7
可编程探测器：使用您的代码段（Snippet） 4'D^ >z!c
5( #z)T
!jl^__
.DR
3q/"4D
将自定义探测器保存到目录 O=U,x-Wl
]u|FcwWc3
sB: e:PK
\68bXY.
可编程探测器的输出 M#2<|VUW,
P}AwE,&Q
H8"RdKwg?
测试代码! 2 Ax(q&`9
w$$pTk|&n
Vfd_nD^8oZ
SLP $|E ;
测试代码! Z]LP18m9kl
c%G~HOE=B
