Python interface for Zemax OpticStudio COM API (ZOS-API)
Project description
Python Zemax OpticStudio API
Current revision
0.0.8 (Last significant update on 02/26/2016)
Philosophy / Design Goals
Problems
The ZOS-API is an excellent interface for OpticStudio. However, using the ZOS COM API in Python directly through PyWin32 is not conducive and feels very unpythonic for the following reasons:
the large set of property attributes of the ZOS objects are not introspectable,
several interface objects require appropriate type casting before use,
the interface is quite complex (albeit flexible) requiring a significant amount of coding,
the ZOS-API only works in standalone (headless) mode. This prevents users from interacting with a running OpticStudio user-interface and observing changes made to the design instantly.
Solutions
The philosophy behind PyZOS is to make ZOS-API easier to use in Python by:
enabling interactivity with a running OpticStudio user-interface (see demo)
providing better introspection of objects’ properties and methods
reducing complexity by
providing a set of custom helper-methods that accomplishes common tasks in single or fewest possible steps
providing a framework for easily adding custom methods that seamlessly couple with existing ZOS objects
managing appropriate type casting of ZOS objects so that we can concentrate on solving optical design problem
do all the above without limiting or obscuring the ZOS-API in any way
do all the above with as minimum coding as possible (i.e. do a lot by doing very little)
These enhancements to ZOS-API using PyZOS library are documented in this (work in progress) Jupyter notebook.
Example usage
import pyzos.zos as zos
osys = zos.OpticalSystem(sync_ui=True) # enable interactivity with a running UI
sdata = osys.pSystemData
sdata.pAperture.pApertureValue = 40
sdata.pFields.AddField(0, 2.0, 1.0)
wave = zos.Const.WavelengthPreset_d_0p587
sdata.pWavelengths.SelectWavelengthPreset(wave)
...
osys.zPushLens(1) # copy lens from ZOS COM server to the visible UI app
...
osys.zGetRefresh() # copy changes from the visible UI app to the ZOS COM server
...
See more example use of PyZOS used within Jupyter notebooks here.
Install PyZOS from PyPI
Use the following command from the command line to install PyZOS from PyPI:
pip install pyzos
Interested in contributing?
You can contribute in may ways:
using the library and giving feedback, suggestions and reporting bugs
adding custom functions you wrote for your project that others can use
helping to write the unit-test, adding test cases
letting others know about PyZOS (if you found it useful)
Dependencies
The core PyZOS library only depends on the standard Python Library.
Python 3.3 and above / Python 2.7; 32/64 bit version
All the dependencies can be installed by using the Anaconda Python distribution.
License
The code is under the MIT License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.