]&9=f#k% 简介：
FRED作为COM组件可以实现与Excel、VB、
Matlab等调用来完成庞大的计算任务或画图，本文的目的是通过运行一个案例来实现与Matlab的相互调用，在此我们需要借助脚本来完成，此脚本为视为通用型脚本。
_+H $Pa }? L C$M_Cpw 配置：在执行调用之前，我们需要在Matlab命令行窗口输入如下命令：
`^
a:1^ enableservice('AutomationServer', true)
2aX$7E? enableservice('AutomationServer')
rixVIfVF 
BPm" )DMo 结果输出为1，这种操作方式保证了当前的Matlab实体可以用于
通信。
B-$zi oZ E9Dy)f]#W 在winwrp界面，为增加和使用Matlab类型的目录库，我们需要如下步骤：
E1dhj3+3 1. 在FRED脚本编辑界面找到参考.
:RwURv+ kT 2. 找到Matlab Automation Server Type Library
2|]
<U[ 3. 将名字改为MLAPP
@&%/<|4P5 w'XSkI_ay ~)[ pL(4 在Matlab里面有两种常用的数据发送选项PutWorkspaceData 及PutFullMatrix，PutWorkspaceData适用于存储一般的数据在工作区，并赋予其为变量，PutFullMatrix试用于复数数据。
y>#kT 图 编辑/参考
4\k{E-x $ _HjB'XNr( Sw$/Z)1K& 现在将脚本代码公布如下，此脚本执行如下几个步骤：
EyA(W;r. 1. 创建Matlab服务器。
;' |CSjco 2. 移动探测面对于前一聚焦面的位置。
MgN;[4|[h 3. 在探测面追迹
光线 @F*z/E}e 4. 在探测面计算
照度 V~Z )^.6 5. 使用PutWorkspaceData发送照度数据到Matlab
' o*\ N% 6. 使用PutFullMatrix发送标量场数据到Matlab中
Cbl>eKw 7. 用Matlab画出照度数据
bv7xh*/ 8. 在Matlab计算照度平均值
'tcve2Tt 9. 返回数据到FRED中
m-+>h:1b|9 V S_\bIC 代码分享：
.Cs'@[Ciy A$n.'*gK Option Explicit
O '`|(L vu}U2 0@ Sub Main
Aq7`A^1t$ mwN "Cu 4t Dim ana As T_ANALYSIS
L{l}G,j< Dim move As T_OPERATION
\2#K { Dim Matlab As MLApp.MLApp
G#@#j]8 Dim detNode As Long, detSurfNode As Long, anaSurfNode As Long
[eBt Dc*w Dim raysUsed As Long, nXpx As Long, nYpx As Long
W( ?J,8> Dim irrad() As Double, imagData() As Double, reals() As Double, imags() As Double
u,}>I%21 Dim z As Double, xMin As Double, xMax As Double, yMin As Double, yMax As Double
2PUB@B'
+ Dim meanVal As Variant
rj4Mq:pJ dM19;R@4 Set Matlab = CreateObject("Matlab.Application")
+lZ-xU1 c* ~0R? ClearOutputWindow
$: 1/`m19 l w?C:-m 'Find the node numbers for the entities being used.
HZS.%+2 detNode = FindFullName("Geometry.Screen")
$G9E=wn detSurfNode = FindFullName("Geometry.Screen.Surf 1")
k>8OxpaWv? anaSurfNode = FindFullName("Analysis Surface(s).Analysis 1")
+
65<|0 ,KF>@3f 'Load the properties of the analysis surface being used.
2 n2,MB LoadAnalysis anaSurfNode, ana
ZCb@!V}= r2PN[cL u| 'Move the detector custom element to the desired z position.
H@ty'z ? z = 50
RdL5V AD GetOperation detNode,1,move
&e#pL`N move.Type = "Shift"
+u t%C.1
move.val3 = z
g2*}XS 3 SetOperation detNode,1,move
3-n&&< Print "New screen position, z = " &z
\IzZJGi Z=%u: K}[ 'Update the model and trace rays.
v&%W*M0q@ EnableTextPrinting (False)
s >WqVuXmn Update
b NtO qhi DeleteRays
.L^;aL TraceCreateDraw
QJ>=a./ EnableTextPrinting (True)
Wf%)::G*uR +9' )G-`qj 'Calculate the irradiance for rays on the detector surface.
D62'bFB^ raysUsed = Irradiance( detSurfNode, -1, ana, irrad )
a8%T*mk( Print raysUsed & " rays were included in the irradiance calculation.
K@!hrye 5GPAt 'When using real number data to send to MATLAB, it is simplest to use PutWorkspaceData.
E%stFyr9`/ Matlab.PutWorkspaceData("irradiance_pwd","base",irrad)
@y0kX<M 8JW0 ;H< 'PutFullMatrix is more useful when actually having complex data such as with
7)Tix7:9S; 'scalar wavefield, for example. Note that the scalarfield array in MATLAB
d~QJ}a 'is a complex valued array.
wLt0Fq6QG raysUsed = ScalarField ( detSurfNode, -1, ana, reals, imags )
Et}% sdS Matlab.PutFullMatrix("scalarfield","base", reals, imags )
=&qfmq Print raysUsed & " rays were included in the scalar field calculation."
L=s8em]7l /w2IL7} 'Calculate plot characteristics from the T_ANALYSIS structure. This information is used
dr(e)eD(R> 'to customize the plot figure.
W&Xi &[Ux xMin = ana.posX+ana.AcellX*(ana.Amin-0.5)
^r]-v++ xMax = ana.posX+ana.AcellX*(ana.Amax+0.5)
,5K&f\ yMin = ana.posY+ana.BcellY*(ana.Bmin-0.5)
]#q$i[Y yMax = ana.posY+ana.BcellY*(ana.Bmax+0.5)
b+V lq7Bc nXpx = ana.Amax-ana.Amin+1
4xFAFK~lx nYpx = ana.Bmax-ana.Bmin+1
c] z^(:_> wJvk 'Plot the data in Matlab with some parameters calculated from the T_ANALYSIS
@ e7_&EGR? 'structure. Set the axes labels, title, colorbar and plot view.
R\$6_ Matlab.Execute( "figure; surf(linspace("&xMin &","&xMax &","&nXpx &"),linspace("& yMin &"," & yMax & "," & nYpx & "),irradiance_pwd, 'EdgeColor', 'None');" )
HJ!)&xT Matlab.Execute( "xlabel('X Position (" & GetUnits() & ")')" ) : Matlab.Execute( "ylabel('Y Position (" & GetUnits() & ")')" ) : Matlab.Execute( "zLabel( 'Irradiance' )" )
X\<a|/{V A Matlab.Execute( "title('Detector Irradiance')" )
~wGjr7Wt Matlab.Execute( "colorbar" )
2Y=Q % Matlab.Execute( "view(2)" )
HDu|KW$o1 Print ""
lb"T'} q Print "Matlab figure plotted..."
.Dr7YquW )_kEy>YscZ 'Have Matlab calculate and return the mean value.
*t={9 h Matlab.Execute( "irrad = mean(mean(irradiance_pwd));" )
H-X5A\\5 Matlab.GetWorkspaceData( "irrad", "base", meanVal )
xu;^F Print "The mean irradiance value calculated by Matlab is: " & meanVal
R~ N%sn (ijO|%? 'Release resources
y92<(ziaX) Set Matlab = Nothing
u/\Ipk/ g)MLgjj End Sub
/`O'eH j{zVVT 最后在Matlab画图如下：
^4saB+q m I& x69 并在工作区保存了数据：
^1--7#H 
2"Y=*s 并返回平均值：
({!*&DVu 0XL[4[LdA 与FRED中计算的照度图对比：
\ }Pr!tk! ,l\D@<F 例：
.3
^*_ >rh< %55P` 此例
系统数据，可按照此数据建立
模型 o` }8ZtD 7G_lGV_ 系统数据
D ,uT#P %';DBozZ s: MJ{r(s 光源数据：
H{Na'_sL Type: Laser Beam(Gaussian 00 mode)
!|Y&h0e Beam size: 5；
81wmKqDEs Grid size: 12；
IRI<no Sample pts: 100；
m( WVxVB 相干光；
B#4 J
