Knowledgebase
Ansys Zemax Support FAQs
User Groups

Community
Programming OpticStudio
ZPL

ZPL

Find out how you can save time and energy using the Zemax Programming Language!

193 Topics
513 Replies

When you subscribe we will email you when there is a new topic in this category

193 Topics

DevorseInfrared

Rounding numeric values when creating a ZPL macro

Good afternoon.I have a question about working with numeric variables when writing an ZPL macro. Is it possible to round the values assigned to variables with the required accuracy? I'm looking for functions similar to (FLOOR.MATH) and (CEILING.MATH) in Microsoft Excel. I understand that i can create a loop that allows me to sequentially compare the value of interest with i and i+1 value. I would like to create an ZPLM operand using rounding, so it seems to me that this way will slow down the optimization, especially with a high degree of rounding accuracy.As an example, we can discuss the case where the value 24.432 needs to be rounded up to 24.0 or 24.5.

6282

2 years ago

Giulia PanusaVisible

asked in ZPL

Get TiltX or Y using ZPL Macro

Hi! I just started using the ZPL and what I would like to do is to create a solve based on a very simple geometrical relation. But, for doing this, I need to get the Tilt Y of a rectangular object (I am in NS mode).The only think I found is the numeric function NPAR, which it seems to me it only acquires parameters.What would be the right way to do it?Thank you!!!

2942

2 years ago

DevorseInfrared

asked in ZPL

Optimization operand name in ZPL code

Good afternoon! I am studying the ZPL macro language in order to simplify the analysis of data in the optimization process. In the macro being developed, I would like to implement the function of sorting optimization operands by their contribution. I know that such information is in the "" section, but I'm interested in the implementation in the ZPL language. There are no problems with the sort itself, I use the IF-THEN conditions in sequence, however, I cannot find a way to display the name of the operand by its ID code. Initially, I thought that the numerical function OPER(…,1) could give me the name of the operand in the string, however, as it turns out, this numeric function returns the ID code of the operand. Could you help me? Thanks

5656

2 years ago

yuan.chenZemax Staff

posted in ZPL

How to modify the POPD beam setting using ZPL macro

I had a post in Chinese but maybe this helps more people who wants to simulate the tolerance of their systems using ZPL. 如何使用ZPL改变POP中的beam和fiber数据 | Zemax CommunityThe MODIFYSETTING can be applied on the .CFG which has the same name of your design file and locates under the same directory of your file. This is the file that the POPD reads. You have to manually click the SAVE button to generate this file first. If we modify the POP.CFG, it does not work.Here is the sample ZPL code.popCFG$ = "C:\Users\Desktop\Fiber Coupling.CFG"MODIFYSETTINGS popCFG$, POP_FPARAM1, 0.005MODIFYSETTINGS popCFG$, POP_FPARAM2, 0.005OPENANALYSISWINDOW POP, popCFG$PRINT MFCN()The OPENANALYSISWINDOW may not be necessary for certain users. When I run the test, I need this line to activate the modification on this CFG file.

3960

2 years ago

Lieu-Kim.DangInfrared

asked in ZPL

Print array

Hello OS-community,how to write a ZPL-code printing elements of a single or multi-dimensioned array (ie. Array(i), Arrax(i,j)) in one line in the output of the text viewer?Thanks

8489

2 years ago

Ralf.KesslerMonochrome

asked in ZPL

Reding data from .dat-file into ZPL macro

Hi,I would like to read several numeric data as well as text data from a .dat-file into a zpl macro to use some of them for further use.For example, the .dat file has 5 rows and 3 lines, divided by Tabs, e.g.:Pos1 3.7 4.2 6.2 8.7Pos2 9.0 7.5 2.8 5.6Pos3 0.5 1.8 4.6 4.3Is it possible to use the READ command for reading the complete .dat-file and to select afterwards some special data for further optimization?Or would it be possible to read only some special data from the .dat-file for further use, e.g. (Row2, Line 2 = 9.0) and (Row3, Line 3 =1.8)? Best regardsRalf

ZPL Macro for Ray Trace in Mixed mode

Hi,I am facing an issue when I try to extract ray trace data for a non sequential component in mixed mode of Zemax. In the above data, I want to get the direction cosines of normal and incident ray for NSC object 7 and 2 using a ZPL macro (as I am tracing a 10000 rays). Since for RANX(surface) (Surface number in the sequential editor has to be given) I don’t know which surface number has to given for this case. I also tried to save the ray trace data every time I trace the ray, but When I run RAYTRACE hx,hy,px,py,wav, (for different px and py), somehow the data in the Raytrace text is not getting update. Can you please provide me a solution for this.

4332

2 years ago

Ralf.KesslerMonochrome

asked in ZPL

Using target values from Merit function in ZPL Macro

Is it possilbe to use target values from a merit function in a zpl macro.For example, there are some defined constraints in the optical path length (OPTH) for e.g. 5 different ray deflections (different Hx or Hy) of an imaging system. Can I use these fixed values in the ZPL macro for further optimization?

4942

2 years ago

Oliver SchwankeSingle Emitter

asked in ZPL

Reading in Detector Data to e.g. python

I use Detectorviewers in text mode to export the results of my simulations to disk.Futher processing is done via python, where the plain textfile gets parsed.I prefer to not using the ZOS API as this limits me in the python verison i use. Problem is: The Detector Viewer numbers are really error-prone as sometimes i close a window and open another one and the numbers i have to put into SAVEWINDOW keyword are just wrong by then.I would prefer using the detector number instead using SAVEDETECTOR keyword. But this saves in some binary format i did not find any specs upon for reading that in. Is there any description on the DDR/DDx file format?Is there any way to obtaining the detector data into python? Best regardsOlli

10713

2 years ago

Vincent (En Hung).LinMonochrome

asked in ZPL

How to optimize POP by use merit function in ZPL?

I would like to write the Macro script of ZPL about how to optimize the POP by merit function like as “POPD” optimized operand1.Set the one surface of Thickness or parameter 1,2,3… as the value of 0.5mm, 0.6mm , 0.7mm to run a loop2.Set the someone surface “Thickness or parameter 1,2,3…..” as variable factor. 3.Execute to optimize the MF as POPD to run 10,15 circles as you want 4.In the end, shows the final optimized value to 1st step different cases you setEx. Surface 3 thickness as 0.5mm, 0.6mm, 0.7mmOptimized the surface 7 of thickness as variable factor by using POPD MFto get value under surface 3 as 0.5mm, 0.6mm, 0.7mm respectively.

5761

2 years ago

Harel.ShfaramSingle Emitter

asked in ZPL

Change solve NSQ parameter from pickup to fixed(off) using Macro

I am looking for ZPL command which change NSQ parameter solve from pickup to fixed(off).There is command SOLVETYPE and code PF_p to remove pickup for sequential but this option not available for NSQ parameter pick up. Any suggestion how to do so?

3442

2 years ago

Daoming.DongInfrared

asked in ZPL

How to create 'Chief ray solve' using ZPLM solve

Hi all,I’m facing a problem of applying ‘Chief ray solve’ for multiple configurations inside the multi-configuration editor. I was trying to use ‘Chief ray solve’ for Decenter and Tilt to one configuration and let other configurations ‘pick up’ the value of the first one. However, the ‘Chief ray solve’ for Decenter and Tilt in multi-configuration is grayed out. So I was wondering whether it is possible to create a ZPLM solve that is identical to the ‘Chief ray solve’ used in the lens data editor and applies it into the multi-configruaton editor? If this is possible, can anyone shares the logic behind the implementation of ‘Chief ray solve’ for decenter and tilt? ThanksBest wishes and Happy new year! Daoming

7721

3 years ago

lei.songMonochrome

asked in ZPL

how to make great use of CPU efficiency when use ZPLM to do tolerance analysis

Question1: I use ZPLM+MACRO to calculation edge spread size, and tolerance script to get tolerance result for edge spread size variation. But CPU only use 10%, so the computation time is very long. Even I choose the max core in tolerance analysis. Is there any setting I miss for macro operation to make better use of CPU? Question2: When I open Zemax file, it become very slow and need to waiting a long time to see it full open already. Why this issue happen? It was open fast before, and I use the same Zemax file on same computer.

3111

3 years ago

lei.songMonochrome

posted in ZPL

How to modify tolerance script in macro

I want to use macro do automatic tolerance analysis, could i modify the tolerance script code in macro code. how to do it if could. thanks!

7274

3 years ago

Nicolò.BassoliMonochrome

asked in ZPL

Quick adjust in ZPL MACRO

Hi!When using a ZPL macro, is there the possibility of using a keyword that function like quickadjust? There is the keyword QUICKFOCUS but it works only on the last surface thickness

5693

3 years ago

Hans.MartinssonSingle Emitter

asked in ZPL

How to get the column number calling a ZPL macro?

Hi,In a ZPL macro one can get the object number that’s calling the macro as solve with SOSO(1), but how do I get which column that’s calling the ZPL macro?I want to use the same macro for solving both the Z and the Y position of an object so I don’t need maintain two separate macros.Regards,Hans

EFNO gives different result to that calclated in relative illumination analysis

Hello,I have a system with a non-circular aperture and therefore try to calculate its effective f number using the operand EFNO(effective f number). However, I get different results when using the operand EFNO, in comparison to the result given in the relative illumination analysis, despite the same setting is applied on both calculation. (wavelength 3 is 0.555µm, and field 1 corresponds to 0 y field) As can be seen above, one gives a value of 4.13(EFNO), while the other gives a value of 3.85. I think the latter one should be correct, but the question is why does one get different results here, do these two use different algorithms for calculation? How can I calculate this value in a Zemax macro conveniently if the result provided by EFNO is not trustworthy…. Thanks a lot in advance!

1552

3 years ago

Iari.MarinoInfrared

asked in ZPL

Change model glass index by ZPL in NS mode

In Non-Sequential mode, is there a way to change the refractive index value of a model glass whithin ZPL? It seems that SETNSCPROPERTY doesn’t allow this, but only to change a glass chosing from the library. Thank youIari

2351

3 years ago

Daoming.DongInfrared

asked in ZPL

Use SSAG operand in ZPL Marco

Hi all,I’m trying to use ssag operand to obtain the surface sag in sequential mode. I’m ok with using it in the merit function editor, however, as I have a lot of sampling points, manually inserting ssag function is a real pain. Is there any method to use SSAG in the ZPL Marco where I can write my own loop? Best wishesDaoming

2542

3 years ago

Renaud.LigotInfrared

asked in ZPL

using OPEV operand to calculate DSLP

HiI am trying to calculate the RMS slope of a surface with the DSLP operand in a macro.The surface is Zernike Standard Sag (generated from tolerance analysis) and the rms slope of this surface computed in the MF editor is like below I wrote the following to calculate the same value in a macro:> print OPEV(OCOD("DSLP"),1,1,2,0,0,1)but this is obviously not correct as the output is 3.4456 (I was excpecting 4.913e-5).I can’t find the error, can you? :-)Thank you

2406

3 years ago

Ryo.KajiuraSingle Emitter

asked in ZPL

ZPL macro: Where can I find the list of "NSC_" for all the object types?

Hello Community, I am working on making a macro and would like to know how I can set the object type, for example, Source Two Angle.There is only one example that Standard Lens to be described as “NSC_SLEN” in the ZEMAX Manual and I cannot find the information for other objects.Your support would be greatly appreciated.Thank you. Kind regards,Ryo

2604

3 years ago

joshdfreemanUltraviolet

asked in ZPL

Non-sequential ray tracing in ZPL?

How does one do a bulk raytrace in ZPL, similar to pressing the “Ray Trace” button in regular, non-sequential mode. From the help files, it looks like RAYTRACE and RAYTRACEX only traces one particular ray, which is not useful for determining the total illumination on a detector. Thanks!

9193

3 years ago

Jannis.GangelhoffSingle Emitter

asked in ZPL

Reading Centroid-X / Centroid-Y for Detectorviewer in ZPL

Hi All, how can I read the Centroid-X/Centroid-Y value from the Detectorviewer in ZPL?Thanks in advanceJannis

4131

3 years ago

Michael ChengZemax Staff

posted in ZPL

How to check relative illumination at 'object' surface (verify the relative illumination theory)

Sometimes, we may design the system starting from the 'image' back to the 'object'. For example, this is often the case for those systems that are designed to be viewed by eye, like AR/VR, HUD. In this case, normally, if we want to check the relative illumination, we need to reverse the system to check because the tool 'Relative Illumination' only calculates that on last surface in the system.Here we will provide another way to calculate it using a macro so that you don't need to reverse the system.Note here we at the same time is also demoing how you can verify the calculation theory of the RI. RI is actually much easier to calculate if the system is reversely designed! First, by reading the following forum post, we know that relative illumination at each field is exactly linearly dependent to the area of the beam in cosine space in image space.So, here is the plan. We want to write a macro to calculate the beam area in cosine space for each field, normalize it, and then get the the R

14018

3 years ago

John.HygelundFully Spectral

asked in ZPL

concatenate string and variable in ZPL

Regarding the SETVAR ZLP keyword, want to use a variable to define the ‘Pn for parameter n’. I need to concatenate “P” with my index variable i. How do I accomplish this?Thank you,John

5881

3 years ago

Page 5 / 8

Community Posting Guidelines Cookie settings

Sign up

Already have an account? Login

Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.

Enter your e-mail address

Back to overview

Scanning file for viruses.

Sorry, we're still checking this file's contents to make sure it's safe to download. Please try again in a few minutes.

This file cannot be downloaded

Sorry, our virus scanner detected that this file isn't safe to download.

Zemax Community

Manage email notification
Private Message Inbox
My Subscriptions
Posting guidelines

Need more help?

Ansys Zemax OpticStudio
Knowledgebase
Software Downloads
Consultants
Open a Case

To Chinese users:

Do not provide any information or data that is restricted by applicable law, including by the People’s Republic of China’s Cybersecurity and Data Security Laws ( e.g., Important Data, National Core Data, etc.).

不要提供任何受适用法律，包括中华人民共和国的网络安全和数据安全法限制的信息或数据（如重要数据、国家核心数据等）。