OpticalAberration
Plot various types of monochromatic aberration that arise when electromagnetic rays are focused by a system of lenses and mirrors.
The Optical Aberration plot is available with the Ray Optics Module.
Syntax
model.result(<pgtag>).create(<ftag>,"OpticalAberration");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"OpticalAberration") creates an optical aberration plot feature named <ftag> belonging to the plot group <pgtag>. The optical aberration plot is used to visualize various types of monochromatic aberration. Optical aberration plots can be added to 2D plot groups.
The following properties are available:
Table 7-68: Valid Property/Value Pairs for Optical Aberration Plots
Property
Value
Default
Description
additionallogical-
-expression
String
1
Additional logical expression that must be nonzero for rays to be included in the plot.
additionallogical-
-expressionactive
on | off
off
If on, activates an additional logical expression for including rays in the Zernike coefficient calculation.
bottomcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
black
The bottom color to use for a color gradient. Active when coloring is gradient.
color
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
red
The uniform color to use. Active when coloring is uniform.
coloring
colortable | uniform | gradient
colortable
How to color the plot: using a color table, a uniform color, or a color gradient.
colorlegend
on | off
on
Whether to show color legend, when coloring is set to colortable.
colortable
color table name
Rainbow
The color table to use when coloring is set to colortable. See Color Tables for a list of color tables.
colortablerev
on | off
off
Whether to reverse to color table or color gradient when coloring is set to colortable or gradient.
colortablesym
on | off
off
Whether to symmetrize the color range around 0 when coloring is set to colortable or gradient.
custombottomcolor
RGB-triplet
{1,0,0} or last used color.
The uniform color to use. Active when bottomcolor is set to custom.
customcolor
RGB-triplet
{1,0,0} or last used color.
The uniform color to use. Active when color is set to custom.
customtopcolor
RGB-triplet
{1,0,0} or last used color.
The uniform color to use. Active when topcolor is set to custom.
data
none | parent | dataset name
parent
The dataset this feature refers to, which must be an Intersection Point 3D dataset. This Intersection Point 3D dataset should describe the intersection points of rays with a Gaussian reference hemisphere centered at the focus.
filterrelease
Positive integer
1
Index of the release feature of rays to include if filterreleaseactive is on.
filterreleaseactive
on | off
off
If on, filter rays by release feature to determine which rays are included in the Zernike coefficient calculation.
filterwavelength
String
632.8[nm]
Wavelength of rays to include if filterwavelengthactive is on.
filterwavelengthactive
on | off
off
If on, filter rays by wavelength to determine which rays are included in the Zernike coefficient calculation.
filterwavelengthtol
String
1[nm]
Numerical tolerance for filtering rays by wavelength if filterwavelengthactive is on.
hemisphereradius
String
50[mm]
Radius of the Gaussian reference hemisphere. This is copied to an Intersection Point 3D dataset when automatically computing the focus.
inheritcolor
Boolean
true
If inheritplot is not none: Determines if the color is inherited.
inheritplot
none | plot name
none
The plot that color and color range are inherited from.
inheritrange
Boolean
true
If inheritplot is not none: Determines if the color and data ranges are inherited.
lunit
Any length unit
\u00b5m (micron)
Length unit for plotting combinations of Zernike polynomials.
maxorder
2, 3, 4, or 5
5
Maximum polynomial order for the Zernike coefficients calculation,
ngrid
int
1000
The number of grid points to plot on the unit circle when rendering the optical aberration plot. Use an integer value between 100 and 1,000,000.
normal
directionbased | positionbased | userdefined
direction--based
Determines how the normal direction to the focal plane is calculated.
normalexpr
String array of length 3
{0,0,1}
Expression for the normal direction to the focal plane, active if normal is userdefined.
numberofreflections
Nonnegative integer
0
Rays that have reflected the specified number of times will be included in the plot. Used if numberofreflectionsactive is on.
numberofreflections-
-active
on | off
off
If on, activates the filtering of rays based on number of reflections.
posexpr
String array
("0","0")
Position of the center of the unit circle in which the Zernike polynomials are plotted. By specifying nonzero components for some instances of the Optical Aberration plot it is possible to display multiple such plots side-by-side in the Graphics window.
terms
all | higherorder | selectindividual
all
Terms in Zernike polynomial to include: all, higher-order terms, or individually selected terms.
title
String
The auto-title.
The title to use when titletype is manual.
titletype
auto | custom | manual | none
auto
auto if the title contribution should be computed automatically, possibly using the group’s customization. custom if the title contribution should be computed automatically, but customized. manual if the manual title contribution should be used (the title property). none if no title contribution should be used.
topcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
white
The top color to use for a color gradient. Active when coloring is gradient.
z00
Boolean
false
Include the z(0,0), piston term (if terms is set to selectindividual).
z1m1
Boolean
false
Include the z(1,-1), vertical tilt term (if terms is set to selectindividual).
z11
Boolean
false
Include the z(1,1), horizontal tilt term (if terms is set to selectindividual).
z2m2
Boolean
false
Include the z(2,-2), oblique astigmatism term (if terms is set to selectindividual).
z20
Boolean
false
Include the z(2,0), defocus term (if terms is set to selectindividual).
z22
Boolean
false
Include the z(2,2), astigmatism term (if terms is set to selectindividual).
z3m3
Boolean
false
Include the z(3,-3), oblique trefoil term (if terms is set to selectindividual).
z3m1
Boolean
false
Include the z(3,-1), vertical coma term (if terms is set to selectindividual).
z31
Boolean
false
Include the z(3,1), horizontal coma term (if terms is set to selectindividual).
z33
Boolean
false
Include the z(3,3), horizontal trefoil term (if terms is set to selectindividual).
z4m4
Boolean
false
Include the z(4,-4), oblique quatrefoil term (if terms is set to selectindividual).
z4m2
Boolean
false
Include the z(4,-2), oblique secondary astigmatism term (if terms is set to selectindividual).
z40
Boolean
false
Include the z(4,0), spherical aberration term (if terms is set to selectindividual).
z42
Boolean
false
Include the z(4,2), secondary astigmatism term (if terms is set to selectindividual).
z44
Boolean
false
Include the z(4,4), horizontal quatrefoil term (if terms is set to selectindividual).
z5m5
Boolean
false
Include the z(5,-5) term (if terms is set to selectindividual).
z5m3
Boolean
false
Include the z(5,-3) term (if terms is set to selectindividual).
z5m1
Boolean
false
Include the z(5,-1) term (if terms is set to selectindividual).
z51
Boolean
false
Include the z(5,1) term (if terms is set to selectindividual).
z53
Boolean
false
Include the z(5,3) term (if terms is set to selectindividual).
z55
Boolean
false
Include the z(5,5) term (if terms is set to selectindividual).
Attribute
Height, AberrationHeight, HistogramHeight, TableHeight