This is a small tool to help users setting up DLL parameters in a more convenient way. This is mainly useful when we need to set up multiple objects and parameters.Here is a quick user guide about the tool.The cell "From Obj" should be a single integer for object number we want to load DLL parameter settings. The par# is a string only including integer, comma, dash, and spaces. Integers are separated by comma. Dash is used to represent a range of integers. By cliking the button Load Par#, all the parameter numbers from the object defined by "From Obj" will be written in Par# cell. Par Val is a string only including numbers, comma, and spaces. Numbers don't need to be integer and are separaterd by comma. By clicking the button Load Values, the value of parameter number defined by cell Par# in object defined by cell "From Obj" will be collected and written in cell Par Val. The To Objs is a string works similar to Par#. We can define one or multiple objects that the 3 buttons "Set MCE", "

 Hello,Just like Python Version, we also have Pythonnet which is bridge between Python and .NET. I have experienced many customer queries of having compatibility issue with Python 3.8. As 3.8 is recommended Python version for connecting with ZOS API Python but still the bridge (Pythonnet) needs to be compatible with Python version. Then only we can connect and run ZOS API properly. Now a days Python editors like PyCharm, Spyder, Jupyter etc. recommending Pythonnet 3.0.1 for Python 3.8.3 to Python 3.8.5. Pythonnet 3.0.1 is not fully compatible with Python Version 3.8.3 to Python 3.8.5. If you have installed this version uninstall Pythonnet 3.0.1 and reinstall pythonnet2.5.2 Version using the command in your console.pip install pythonnet==2.5.2If not, you will receive the error message “Failed to initialize pythonnet”.ThanksSahil

Hello fellow Zemax ZOS-API users! I’m getting my hands dirty with the ZOS-API, and I’m currently running a C# code to allow me to use batch ray trace. This reproduces my  input object onto my output image plane very nicely. However, I then tried to put this into a for loop over the range of thicknesses I want to conisder for one eleemnt in my system. I’m using directpol, and the addrays and readnextresults and ReadNextResultFull, and the method runs perfectly fine on the first lop iteration, but then fails for the concurrent lops. I tried to run the program by putting the loop inside the C# code and by calling it from an external program (MATLAB using system command) but in both cases, the success line fails after the first iteration, even though in MATLAB I am asking for a brand new instance of the C# code. to run. So I am stuck running it one parameter at a time, which is not what I want to do. Anyone else facing this problem? Here is a copy of the relevant part of my C# file:var z_o

Hi All,I’m trying to automate some Geometric Image Analysis tasks but am struggling to change the wavelength in geometric image analysis.python 3.10.9Optics Studio 23.1 I’ve set up the image analysis I want in the project (Cross X, Field size, image size, pixels etc). I’m trying now to loop over wavelengths and save the results. My problem is I can’t figure out how to change the wavelength number within ZOS-API. As far as I can tell the IMA keywords don’t have Wavelength. Thanks for any help!from the help of ModifySettings keywords  Geometric Image Analysis IMA_FIELD: The field size. IMA_IMAGESIZE: The image size. IMA_IMANAME: The image file name. IMA_KRAYS: The number of rays x 1000. IMA_NA: The numerical aperture. IMA_OUTNAME: The output file name. IMA_SURFACE: The surface number. IMA_PIXELS: The number of pixels.  example code:geo = TheSystem.Analyses.New_GeometricImageAnalysis()geo_set = geo.GetSettings()cfgfile = os.path.join(pth,'geo_an_sett.cfg')geo_s

This diffractive DLL make the face behave like a Paraxial Lens which can correctly consider phase.Note the Paraxial Lens correctly gives phase information only when the object/image distances are correctly given. Therefore, the parameter “Image Position” should be explicitly given. If the image is formed at infinity, the parameter “Image Position” is set to 0. For the other conjugations, the image position is the distance between the image plane and the diffractive object along the local axis.There are a few limitations when using this diffractive DLL.(1) The ray must be from -z side and propagate to +z side.(2) Only the transmit rays are considered, the reflect related parameters can be set the same way as the included sample files.(3) Only order 0 are considered.(4) Refractive index at two sides must be AIR (n=1.0).To obtain the same layout, please check the ‘Split NSC Rays’ option in NSC 3D Layout.Please pay attention to the detector size and the PSF Mode Wavenumber when you change

This DLL provides several different mode to handle the polarization with Jones matrix. When the ray is normally incident on to the surface, it returns same data as the built in object “Jones Matrix”. When the ray is obliquely incident on the surface, this DLL can handle the polarization in a way more like expected result. The DLL has a “mode” parameter that can switch how it calculates the polarization for output rays, but the mode 0 will probably be the most useful option. A document is attached with the DLL to explain the calculation details in each mode.  Click here to download Date Version OpticStudio Version Comment 2023/03/18 1.0 - Creation

I'm currently working with wavefront and psf.I'm trying to convert a wavefront map extracted from opticstudio to a psf using a rather complicated but accurate numerical method, not a linear approximation method, but I'm not getting the right results. I am attaching the matlab code I am currently using.Please let me know if there are any fixes.Thanks. CODE:function psf_out=wavefront2psf(wvf, center_wvf, data_space_wvf, lambda, film_Dist, rect, data_space_psf)    % wvf: wavefront map of n x n size from opticsutdio% center_wvf: center coordinate of the wavefront map% data_space_wvf: data space of the wavefront map% lambda: the wavelength% film_Dist: distance between film and the last lens% rect : point spread are estimated within the rectangle% data_space_psf: data space of the point spread function    dr=1;    min_dA=2;    cx=center_wvf(1);    cy=center_wvf(2);        rr=[];    th=[];    RR=0;    TH=0;    AA=pi;    [h_wf, ~]=size(wvf);            for p=1:dr:((h_wf/2)-3)        r=p;     

I’m using a grin 5 surface using a material from an edited SGRIN.dat file and getting errors upon loading it in a Python standalone.If I open the file in a regular OpticStudio window, there is no error message and it works perfectly. However, if I try to load it in Python, the grin 5 surface is causing some issues. In Python, I will get the status "Can't find glass *CAF2* in catalog!" (CAF2 is the first glass after the GRIN 5 surface). If I save the file in Python and open it in OpticStudio, then it will throw the error “Can’t find GRIN 5 glass *customglassname* in SGRIN.DAT!”. This can be resolved if I change the GRIN 5 material to air, which then triggers a glass not found error for every glass in the rest of the system. This is because in the material catalogues, all of the catalogues I had been using have somehow been removed from “Catalogues to use”. After fixing that up, if I change the GRIN 5 material back to what it was originally, there is no error and it works as it did befor

Hello ! I am making a comparison of surface overlaps for surfaces that repeat in more than one configuration using a ZPL macro. This task would be much easier if I know a command to specify the active surfaces in every configuration. I searched the Zemax help  in zpl macro programming . I could not find a solution. Any suggestion from your end would be valuable.  Kind Regards,Santhoshi

I'm running tolerance analysis using ZOS-API-Matlab. How do I pull the tolerance data such as histogram, yield, etc? And how can I run my own tolerance script using Matlab?

hello,I want to compile DLLhttps://support.zemax.com/hc/en-us/articles/1500005577602-How-to-compile-a-User-Defined-DLLbut, I couldn’t download and install window SDK 7.1.https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=8279There is a message that"this feature is disabled because required .net 4 framework is not installed"as the result ".NET Development" cannot be selected. when i proceed without selecting it, "Installation Failed" will be appeared. Have you ever solved a problem like this?

I have many projects using the same DLL (non-sequential object). The DLL is general. The DLL retrieves a unique data file for each project.How does the DLL find or look up the name of the project or the file path for the project (each project is in its own path)?Yes, I can keep this straight manually, renaming, and moving stuff around when changing projects. But why? This is what we have computers for!thanks, 

Hi all,I want to save data and images of detectors automatically with ZPL.  So I made the ZPL code as below. For n = 2, 6, 1    ####### get Detector viewer in img.    winnum = n+1    OpenAnalysisWindow "Dvr", cfgpath$    ExportJPG winnum, imgfile$        ####### get Detector viewer in dat.    #ModifySettings cfgtxt$, DVW_SHOW, 1 # extraction middle row data from 2d data    GetTextFile datfile$, "Dvr", cfgtxt$ , 1    ConvertFileFormat datfile$, 1   #Unicode to ANSINext Once I open all detector viewer windows, I tried to save images and data in detector number order. However, I couldn’t save each detector data/image because it cannot recognize the number of detector in this code. What should I do? Or, are there better method to do it? Please help me. Thanks in advance. 

Hello, Since I updated to 23.1, I have an issue with FftMtf analysis settings, which has no “Wavelength” attribute. You can see the error on the screenshot. The test script I am showing is a modified MTF ZOS-API example (PythonStandalone_04_pull_data_from_FFTMTF.py). This sample works ok by itself but fails if I try to add line 189 in the screenshot.Error message when trying to access FftMtf analysis settings.WavelengthI tried to revert to 22.3 but it did not help. I am not 100% sure it is linked to the update.Any ideas?

When getting a text file with Zemax-generated data (e.g. a wavefront map) using a ZPL macro, one could specify certain settings such as sampling resolution. While OpticStudio User Manual gives these settings for wavefront map, surface sag, Huygens PSF, etc. in the MODIFYSETTINGS section, it does not have anything given for Interferograms. If I have a multi-configuration file, how am I supposed to specify to obtain interferogram between, say, configuration 2 and 3? How should I specify the sampling resolution? Is there a way to specify these settings at all?

Hi,I’m trying to obtain data from the ‘Flux vs Wavelength’ analysis tool while interacting through the ZOS-API (MATLAB). Setting a desired detector and wavelength bins then saving text output of flux by wavelength bin on that detector is my goal. There doesn't seem to be any direct way to modify these settings through the ZOS API, I have checked with the ‘HasAnalysisSpecificSettingsTool’. So I am trying to use the ‘ModifySettings’ route to change the configuration file (string code FVW). However, I cannot find the type codes for Flux vs Wavelength in the OpticStudio Manual or on any other help or discussion areas! I can do everything I required through the GUI, but  not through ZOS API, which I am using to automate analysis. This is proving to be a large roadblock for our work.Could someone please let me know if what I am wanting to perform is possible and what the type codes for the Flux vs Wavelength analysis are?Or even better if there is a direct method to modify the settings throu

This Zemax user analysis performs a path-analysis on an input ZRD file. The specified ZRD file will be read, and the ray paths sorted by total power in each path. This ray path analysis includes the hit-face data, meaning a ray which ghosts within a single object will be differentiated with the ray path which doesn’t ghost. This makes the analysis more robust than the native Path Analysis feature, but produces a more complex data output. As it is also slower than the native Path Analysis feature, it is recommended for use only when this level of detail is required in path analysis data. Some options are included to limit the depth of analysis to improve speed.Author: @Zach Derocher   Click here to download Date Version OpticStudio Version Comment 2020/01/01 1.0 19.4 Creation

This example is a Python script to convert Zemax BSDF to Speos BSDF. The script is available here. It is not yet in the main branch as we are still running some tests but do feel free to use it and leave a comment.https://github.com/ansys/optical-automation/blob/BSDF-converter/ansys_optical_automation/application/BSDF_converter_example.pyThe user inputs are:BSDF_inputFilepath: the Zemax BSDF. A window will appear to select the BSDF. precisionTheta: the precision between theta values for the Speos BSDF. The default value is 1 degree. precisionPhi: the precision between phi values for the Speos BSDF. The default value is 1 degree.The script will create a Speos BSDF file in the same folder as the Zemax BSDF file. For more information about Ansys optical_automation, click here.

This macro traces a single ray through the system. The Jones matrix is calculated at each surface. The Jones matrix is based on a plan normal to the traced ray. The electric field value after each surface can be calculated by multiplying the electric field before the surface by the Jones matrix. In the macro, the result from Polarization Ray Trace (POLTRACE) is also shown for comparison.Language: ZPL  Click here to download Date Version OpticStudio Version Comment 2019/10/18 1.0 19.4SP2 Creation  

How do I simulate a rectangular amplitude grating using the RCWA DLL. I used srg_trapezoid_RCWA.dll for the simulation. I set Index Grate to 1, Index Env to 0.7-7.0i to simulate transmissive and opaque slits, and both substrate and outside refractive index are set to 1. However, I found that the diffraction efficiency calculated by it is quite different from that calculated by using scalar theory in the paraxial region. Also, when I change Index Env (e.g., 0.7-20i) and Depth, the diffraction efficiency changes more significantly. How can I simulate a rectangular amplitude grating that is consistent with scalar theory? 

Hello! I am new to ZPL Programming. I currently have the task to extract clear aperture values from Zemax (not according to surface number but the surface names ) using a ZPL macro. I am currently struggling to find the right command.  It would be great if someone could help. Kind Regards,Santhoshi

In otpicstudion I am using, there are two way to get edge spread function. One is gemetric ESF, and the other is FFT ESF. I guess that FFT ESF are based on FFT, but don't know how the geometric ESF is calculated. Is it based on raytrace method rather than wave property of light?

Hello community,I am looking for an example of OPEN / READ / WRITE a binary file in ZPL.Many Thanks!Hans-Jürgen 

Hey everyone. I have a NSC model that contains two sets of CPC’s and a Mersenne relay. My source is an array of conical wavefronts to mimic Cerenkov radiation. I need to trace a lot of rays through the system to the detector to look at the temporal dispersion of rays vs. time (or more correctly, Power vs. Time). So I’m writing my ray trace to a ZDR file. But when I convert it to text, I can’t get all the rays because the file is too large.So I want to try using the ZRD2MAT function that writes the ZRD data to a Matlab.m file.I have no idea how to do this. Currently, I’ve been creating a lot of text files with the ZRD info in them and reading and summing all the Optical Path data to get the total OP from source to detector. then, catching the last Intensity value for that ray and storing the info in a 2D array in Mathematica. It’s a PITA! I’d rather do it in Matlab.What path do I use if Matlab is in one folder and the lens is in another folder?anyone who can help me will get 100 Atta-Bo

I notice these are “Reload Surface” and “Reload All Surfaces” tools on the top of the LDE window. Does anyone know how do we access this tool in Matlab API? I did not find such a function in ZOS-API. One similar function is  “Reload Object” but it doesn’t work for “Reload Surface”.The reason why I need this function is I am simulating gradient index lenses whose property is read from an external file named “GRADIENT_9.DAT”. After I change the material property in this external “.DAT” file, I need to Reload All Surfaces to update the material.If anyone has suggestions on how to do this, I would appreciate it a lot.