optika
A Python library for simulating optical systems, similar to Zemax.
optika computes the spectral response and resolution of an arbitrary optical system, and can optimize it using scipy.optimize.
Surfaces carry their own sag profile, aperture, material, and rulings, and are placed in global coordinates, so a system is an ordinary Python object that can be built, modified, and swept over programmatically.
Because every parameter can be an array from named-arrays, a whole configuration space of designs propagates through the raytrace at once, and an uncertain parameter carries its uncertainty through to the performance of the system.
More information is available in the documentation.
Installation
Optika can be installed using pip:
pip install optika
Features
- Sequential raytrace modeling of an optical system
- Stratified random sampling of input rays for faster convergence
- Image simulation of a given scene using an optical system
- A fast linear forward model approximating a raytraced system, for imaging many scenes without raytracing each one
- Spherical, conical, and toroidal surface sag profiles
- Circular, rectangular, and polygonal apertures
- Mirrors and arbitrary multilayer coatings
- Refractive glass materials with Sellmeier dispersion (e.g. N-BK7, F2)
- Diffraction gratings, with constant, polynomial, and holographic ruling spacing, and sinusoidal, square, rectangular, sawtooth, and triangular ruling profiles
- CCD/CMOS sensor simulation, including quantum efficiency, noise, and charge diffusion
- n-dimensional configurations of the optical system using named-arrays
- Uncertainty propagation using named-arrays
Key concepts
Surfaces are placed in global coordinates.
Unlike Zemax, where each surface is positioned relative to the one before it, an optika surface carries a transformation giving its position and orientation in the coordinate system of the whole instrument.
Moving one surface therefore does not move everything downstream of it.
The field of view and entrance pupil are computed, not specified.
The apertures of the surfaces determine them, so marking a surface with is_pupil_stop or is_field_stop is enough.
Rulings are a property of a surface.
A diffraction grating is an ordinary surface with a rulings field, so switching between ruling designs does not mean switching to a different type of surface.
Any parameter can be an array.
Giving a parameter an extra named axis sweeps the system over that axis, and every ray traced through it carries that axis along, which is how optika explores a configuration space without a loop.
An UncertainScalarArray parameter propagates its uncertainty through the raytrace by the Monte Carlo method.
Example Gallery
Simulate a Newtonian telescope
using optika
Compute the reflectivity of a multilayer mirror by specifying the materials and thicknesses of the layers.
Model the quantum efficiency of a backilluminated CCD
Compute the transmissivity of a thin filter, such as the aluminum filters used to reject visible light on solar instruments.
import matplotlib.pyplot as plt
import astropy.units as u
import named_arrays as na
import optika
# Define the wavelengths at which to compute the transmissivity
wavelength = na.geomspace(100, 800, axis="wavelength", num=201) * u.AA
# Compute the efficiency of a 100 nm layer of aluminum
reflectivity, transmissivity = optika.materials.multilayer_efficiency(
wavelength=wavelength,
layers=optika.materials.Layer(
chemical="Al",
thickness=1000 * u.AA,
),
)
# Plot the transmissivity, which drops sharply at the aluminum L edge
fig, ax = plt.subplots(constrained_layout=True)
na.plt.plot(wavelength, transmissivity.average, ax=ax, axis="wavelength");
ax.set_xscale("log");
ax.set_xlabel(f"wavelength ({wavelength.unit:latex_inline})");
ax.set_ylabel("transmissivity");
Citation
If you use optika in your research, please cite it.
The citation metadata is kept in CITATION.cff,
which the "Cite this repository" button on GitHub can export as BibTeX or APA.
Every release of optika is archived on Zenodo with its own DOI.
The concept DOI, 10.5281/zenodo.23074621,
always resolves to the latest version,
and the Zenodo page lists the DOI of every version.
Please include the version of optika that you used,
which is given by importlib.metadata.version("optika").
The BibTeX entry below uses the concept DOI.
To cite a specific version instead,
replace doi with the DOI of that version.
@software{optika,
author = {Smart, Roy T. and Parker, Jacob D. and Kankelborg, Charles C.},
title = {optika},
version = {X.Y.Z},
doi = {10.5281/zenodo.23074621},
url = {https://github.com/sun-data/optika},
}
Development
Install the package in editable mode along with its test dependencies, and run the test suite using pytest:
pip install -e .[test]
pytest
This project is formatted using black, linted using ruff, and type-checked using mypy, all of which are checked by continuous integration:
black .
ruff check .
mypy optika
To build the documentation locally:
pip install -e .[doc]
sphinx-build docs docs/_build/html
1 maintainer
Metadata
1 maintainer
Release files for optika 3.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| optika-3.5.0.tar.gz | 4.4 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| optika-3.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.4 MB
Release files / optika-3.5.0.tar.gz
| Download URL | optika-3.5.0.tar.gz |
|---|---|
| Size | 4.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c74ea9a24fc31214c9b26c04892da5669b62d6dc5069a3d9603cee3b597e4f9
|
|
BLAKE2b-256 checksum How to use checksums |
7bf4d6622f1600f9504b11cdda4020f7e534e54d1c6dec61000f03b22df314e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / optika-3.5.0-py3-none-any.whl
| Download URL | optika-3.5.0-py3-none-any.whl |
|---|---|
| Size | 5.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a2b6bb89b2df5be149aa887289fc279b0b872adbeb8870e3794e774a85af8cf8
|
|
BLAKE2b-256 checksum How to use checksums |
7c4507961b64e1f7280d52e15a08cfb364cb3a29aaf5414cf930e9697502c90b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logSecurity for optika 3.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for optika-3.5.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
