Studying into it further, it looks like the .PAF file needs to be saved as part of the ray trace operation. I’m already calling the ray trace from Matlab. 

The regular OpticStudio 22.1 documentation mentions that “Currently a PAF file can only be used in the Path Analysis tool.” The format of the PAF file is much, much preferred over the ZRD file, as all I really need is the sum total of the energy in the various paths. Are there computationally “light” ways to get this same information from processing a ZRD file? Is extended PAF file capability with ZOS-API perhaps in a Beta release? Thoughts? 

Hi Josh,

You can access the Path Analysis feature from the ZOS-API, then programmatically change its settings:

After running an update (assuming some of the settings have been modified), the results can be directly analyzed in Matlab:

For this simple example, let’s acquire the path sequence information:

% get path sequence results
np = PA.GetResults.PathAnalysisData.Paths.Length;  % number of paths
paths = cell(1,np);  % initialize paths cell array
for i = 1:np
    paths{i} = PA.GetResults.PathAnalysisData.Paths(i);
end

% load path sequence vectors into array
% initialize vector containing number of ojects hit along each path 
phits = zeros(1,np); 
% loop thru paths
for j = 1:np
    phits(j) = paths{j}.HitsInPath;
end
max_hits = max(phits);  % max hits = number of array columns
path_seq = NaN(np,max_hits);  % initialize array to NaN 
% acquire array of objects hit (each row = one path)
for j = 1:np
    for k = 1:phits(j)
        path_seq(j,k) = paths{j}.PathObjectList(k);
    end
end

then display the results,

Compare this to the Path Analysis window output:

Alternatively, the results can be saved to a file, which could then be loaded and parsed in Matlab (see Example 10: NSC ZRD Filter String):

Regards,

Jeff

Thanks @Jeff.Wilde,

that’s exactly what I was after!

@Jeff.Wilde,

I was finally able to find the other parameters for PA.GetResults.PathAnalysis.Paths(n), where n is the individual paths. This let me obtain the TotalPathFlux for each paths, which along with the path data, is what I really needed. 

Basically, I have an optical system defined in OpticStudio, for which desired tilts and positions for the objects are calculated and then updated from Matlab in Interactive Extension Mode. The Raytrace is then called from Matlab, and I’m trying to update and import the PathAnalysis data. The import part is working. However, I’m can’t seem to figure out yet how to update the PathAnalysis data from Matlab. I tried the same methods as for updating the NSC 3D layout, which OS did not like. 

OpticStudio has great functionality and features. The documentation could seriously use a couple orders of magnitude improvements in order to match the standards of industry leading engineering software.

Thanks again!

Did you look at the various Methods associated with the path analysis feature:

and try using  “ApplyAndWaitForCompletion” to update after making changes?

I just used a simple test model in which I tweaked the layout by changing configurations, re-ran a ray trace, and then updated the Path Analysis feature and see that indeed the results are different.

Sometimes, if an error occurs while you are writing/testing the code, some of the OpticStudio tools (e.g., the NSC Ray Trace) can stop working properly.  If you think your code is correct, but it’s not working, at least trying closing out OpticStudio and Matlab, and starting fresh before spending too much time debugging. 

Thanks @Jeff.Wilde, 

I was not aware of the Methods and that looks very useful. I’ll try that.

Thanks again!