Hi all - As the title states, I’m attempting to perform a Standard Zernike Analysis across multiple files simultaneously using the Zemax Python API and Multiprocessing (running 4 instances of Zemax). My attempt is shown below. Failures I’ve encountered include: *** FRU__delta_init(): Attempt to start when running! and UnboundLocalError: local variable 'zos' referenced before assignment I’m not sure if my approach is flawed or if I’m just attempting something that’s not allowed with Zemax or something else. Any insight you can provide would be greatly appreciated. Thanks! Also, thank you to David Nguyen for his example code on performing a Zernike Standard Analysis here. if __name__ == '__main__': import multiprocessing as mp import os import glob from ShortZernMonolith import ShortZernMonolith documents_path = os.path.join(os.path.expanduser("~"), "Documents") directory_path = documents_path + "\\SenseCheck" # Create list of TSAV*.zmx files found in folder TSAV_Files = [] for files in

I am unable to set the source sampling in NSC; here is my code: led_source = TheNCE.GetObjectAt(1)led_source_type = led_source.GetObjectTypeSettings(ZOSAPI.Editors.NCE.ObjectType.SourceRadial)led_source.ChangeType(led_source_type) led_source.SourcesData.PrePropagation = -1print("Preprop: ", led_source.SourcesData.PrePropagation)print("Sampling: ", led_source.SourcesData.SamplingMethod)led_source.SourcesData.SamplingMethod = "Sobol"print("Sampling: ", led_source.SourcesData.SamplingMethod) Note Pre-propagation can be [set, get] through SourceData, whereas SamplingMethod can only be [get]. When I execute this code I get the following: Preprop: -1.0Sampling: SobolTraceback (most recent call last): File "C:\Users\matthew.haines\Documents\Zemax\ZOS-API Projects\PythonStandaloneApplication4\PythonStandaloneApplication4\PythonStandaloneApplication4.py", line 226, in <module> led_source.SourcesData.SamplingMethod = "Sobol"TypeError: since Python.NET 3.0 int can not be converted to Enum implici

My codes (that were working with the 2024 version) do not work anymore with the 2025 release.this is the error I get in the function “InitConnection()”: Message: Could not load file or assembly 'ZemaxEngine.dll' or one of its dependencies. The dynamic link library (DLL) initialization routine failed. (Exception from HRESULT: 0x8007045A)Source: mscorlibHelpLink: None

Hi all, I'm using the ZOS-API in Python (OpticStudio 2024 R1) with IBatchRayTrace to trace manually defined NSC rays. I'm creating the interface using teh batch tool and adding rays using nscData.AddRay(...). The trace completes successfully (batchTool.Succeeded is True, and RunAndWaitForCompletion() doesn't crash ). However, when I read the results using nscData.ReadNextResult(), the numSegments output parameter is consistently 0 for all rays. This happens even when: The system is minimal (new file, 1 wavelength, 1 Standard Lens, 1 Detector Rectangle). Rays are defined with various trace options (None, UsePolarization, UseSplitting, UseScattering, and combinations). The ray path clearly interacts with objects (e.g., passes through the lens and hits the detector). It also doesnt show any errors... Is it expected that IRayTraceNSCData.ReadNextResult will return numSegments = 0 for simple interactions like refraction or absorption when rays are launched via AddRay? If so, what is the int

This Zemax User Analysis calculates a longitudinal PSF, a PSF through focus. Author: @Michael.Humphreys Click here to download Date Version OpticStudio Version Comment 2022/03/09 1.0 - Creation

Hello, We are urgently looking for an alternative to ZPL-GETZERNIKE using ZOS-API. The point is that we cannot tell “TheSystem.MFE.GetOperandValue(MeritOperandType_ZERN, “ the maximum term of Zernike. “TheSystem.MFE.GetOperandValue(MeritOperandType_ZERN, “ always develops only up to the given coefficient :-( MAny Thanks Hans-Jürgen

The current Through Focus Spot Diagram (TFSD) merges all wavelengths in the same plot, however it provides separation between fields. Right now I’m cloning windows and set the wavelength separate in each window. Is it possible to have a “simple” script to have them separate by wavelengths for a single field? What could be a command for the TFSD plot then? In principle it gives a different view to a Focal Shift.

Hi, I would like to use the ZRDPLAYBACK function, but it doesn't seem to work, I think it doesn't take filters string into account. I have similar problem iy I use a function like NSTR 1, 1, 0, 0, 1, 1, 1, 1, A$ ,”W1”,2 Marc.

It appears that there is a known ZOS-API initialization error when using OpticStudio 2025 R1. Here’s what is stated in the 2025 R1 release notes: I’m currently using OpticStudio 2025 R1.01 and encountering this problem with Matlab R2021a (which previously worked fine with OpticStudio versions prior to 2025). Does anyone know if updating to the latest Matlab release will solve the problem? If not, I wonder how/when this bug will be resolved? Thanks, Jeff

Can you confirm that neither setting the paramters of a dispersion diagram or reading the results is possible through the API ? I couldn’t find any settings neither extract some dataseries results

I’m using the ZOS-API (ver. 2024 R1) with C# and creating an Open3DViewerExport (I3DViewerExport) bitmap of the Ray Trace. The bitmap gets generated to a file but includes the axis (X,Y,Z) in the lower left corner of the image. The application allows to turn this access off but I don’t see the option within the API. Is there anyway that the API can turn this off as well? Thanks. B.

In the last few weeks, I have received questions regarding how we can use the ZOS-API to pull single ray trace information. For convenience, I will post my answers here in a single post. I pulled together three different methods for extracting single ray trace data. Below I will list the methods with sample code in Python and Mathematica. I’m happy to provide samples in other languages if needed! If you have other methods you use for this kind of analysis, feel free to add them as a reply! Method 1 - Use the Single Ray Trace analysis This method can be used to pull the results of the Single Ray Trace analysis window. The benefit of this method is that the results are pulled for all surfaces at once. The drawback of this method is that the data is provided in text form. The output is a TXT file which must be parsed back into the program you are using. This is discussed in a bit more detail here: How to set RayInfo.Vignetted in ZOS-API_Python Python ########### Define the constants acros

Hi everyone, is there a way to select several cells of interest at once using ZOSAPI? Commands like GetObjectAt() and GetCellAt() allow you to select a certain object and certain cell, but - for instance - I want to select the Ref Object column in the NCE specifically for rows 2-5 and set a common value for them. Is there a command to select these cells at once (without having to loop through each object and set them individually) and then set a common value?

My codes (that were working with the 2024 version) do not work anymore with the 2025 release.This is the error I get: Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly 'ZemaxEngine.dll' or one of its dependencies. A dynamic link library (DLL) initialization routine failed. (Exception from HRESULT: 0x8007045A).

Hello,I have a question about a glass for the thermal infrared region, specifically IRG26 glass, present in the SCHOTT_IRG catalog.The Tolerance Wizard is not able to insert the tolerance on the Abbe number of this glass. Why? If the Abbe number is not clearly defined, can we trust the raytrace and therefore the evaluation of the chromatic aberrations? Thanks!

Good day everyone, since ZPL is based on BASIC, I thought some of it generic functions could be used for converting variable types such as VAL(), INT() etc. Only $STR works, the other conversions are not recognized by ZPL. In particular, I want to define a single variable in my script (a particular detector number) and use it for both console output (with PRINT), non-sequential raytrace (with NSTR) and changing Detector Viewer settings (with MODIFYSETTINGS). I could define either a numerical variable and change it to string, but doing so outputs a floating point number (such as 5.000 for instance). Unfortunately, NSTR is having trouble with "h5.000” filter string. Then I thought I can define a string variable "5” and change it to numerical but no commands that I know seem to work. Is there a solution to my issue that would allow me to stay within ZPL script, not switching to ZOS-API?

Hi all, I’ve been modifying .zmx files using Python for a few years now and have been using my own module and PyZOS for a majority of it now. However, my current project has a bit of a road block I’m not sure how to get around. What I would like to do is take a surface from a file I’ve already created and have it be the exact same surface in a different file. I could have the code insert the surface, but if possible I’d like to avoid inserting and deleting surfaces as it may effect other parameters in the system (i.e. Merit Functions operands and whatnot). What I’m hoping to code is something like the following import zospy as zp zos = zp.ZOS() oss = zos.connect() oss.load(‘file1’) oss2 = zos.create_new_system() oss2.load(‘file2’) first_surface_file1 = oss.LDE.GetSurfaceAt(1) first_surface_file2 = oss2.LDE.GetSurfaceAt(1) #Modify somehow first_surface_file1 == first_surface_file2 #would like to be True I was thinking of somehow looping through the surface params but that’s proving diff

Dear Zemax community, I am building upon your 'How to design a Gaussian to Top Hat beam shaper' tutorial. Instaed of TOP HAT, my goal is to create a Uuniform Radial Distribution at distance of 1M from the beam shaper. i.e my goal is to create a uniform distribution on a sagment from a rolled screen. But the ZPL calculates the desired distribuion up on a flat wall, so what should be the distribution up on a “Flat screen” , so it generates a unifrom radial on a rolled sceen ? Any suggestions are welcome and appreciated. Thank you very much, Tali

when i use ZPL output to a text file , The output always stops halfway, and Zemax prompts "cannot open text file". Does anyone know why? For example, I plan to output 40,000 lines of data, but it stops at 10,000.

In the IAS_ZernikeStandardCoefficients settings, there is a setting called : ReferenceOBDToVertex (not sure what OBD means) while in the GUI it is called: Reference OPD to vertex which makes more sense

Dear all, in progress of fully automating my data export for my customized documentation, I am trying to access the data generated by the Zemax analysis windows by a standalone API application in python. While this works for most of the analysis, I am having trouble to get data from the vignetting window for further processing by using the GetResults() function. There is not data retrieved. Debugging shows, that there is indeed no data listed in the respective item. I double checked by exporting the data to a text file - this is also empty with respect to data. My Code therefore (simple example based on the available python api example 1) works as follows: vig = TheSystem.Analyses.New_Analysis(ZOSAPI.Analysis.AnalysisIDM.VignettingDiagramSettings) vig.WaitForCompletion() vig.ToFile(sampleDir + '\\API\\Python\\TextResults.txt') However, when I save the lens file, and reopen with a Zemax Instance, the vignetting window is displayed correctly and the text-form thereof shows data as it sho

This Matlab function imports a raw Zemax ray database stored in ZRD file, groups the rays into distinct paths based on i) the exact same sequence of objects hit AND ii) ray events (such as reflection, splitting etc.), and outputs this information in a form of graphs, human-readable variables and, most importantly, a summary table storing each path in descending total power, object sequence, total ray events and so on, which can be further processed either using Matlab's native capabilities, or exported and processed using Excel or a simple text editor. It DOES NOT need Zemax to be installed onto your system and does not use any API to connect to it. It is a completely standalone function. The need for this custom function came clear during one project at work as the native Zemax ray paths tool was insufficient. As per official documentation, it now groups it based on the sequence of FACES the rays hit.In contrast, this function retains a full low-level list of objects and events. It al

I have a question about Zemax Macro. My macro outputs the results from 1 previous macro setting, even though I edit and save the new setting in the macro every time. I put the screenshot that explain this problem. I have no idea why it happens, so I would like to have any suggestion and comments.

Hey, I’m very naïve to Zemax and ZOS-API. I just tried to find the setting and run the code, but I couldn’t see the results from the image simulation. I used the standalone application and here is my code. # load local variables ZOSAPI = zos.ZOSAPI TheApplication = zos.TheApplication TheSystem = zos.TheSystem # Insert Code Here file = "C:/2021/Zemax_Image_Simulation/test.zmx" cfg = "C:/2021/Zemax_Image_Simulation/test.CFG" TheSystem.LoadFile(file, False) TheImageSimulation = TheSystem.Analyses.New_ImageSimulation() analysisSettings = TheImageSimulation.GetSettings() analysisSettings.ModifySettings(cfg, 'ISM_INPUTFILE', "Text_100p_3x3_2_g1196x1279_dist.png") analysisSettings.ModifySettings(cfg, 'ISM_FIELDHEIGHT', '15') analysisSettings.ModifySettings(cfg, 'ISM_FLIPIMAGE', '3') analysisSettings.ModifySettings(cfg, 'ISM_OUTPUTFILE', 'Test1.png') analysisSettings.LoadFrom(cfg) a = TheImageSimulation.ApplyAndWaitForCompletion() b = TheImageSimulation.GetResults() after running the code, the

I have run both the “phases” macro to locate where the steps are for a binary 2 on an aspheric surface and the “DoeSag” macro. However, I get different results as the radius increases. Sometimes, the number of zones ends up different. Which one is correct? I’ve used the “phases” macro for a long time without much issue. Recently, we have had requests for the sag tables on a binary, but I’m not sure I can trust the DoeSag results as the number of zones and zone locations do not match.