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-59: Valid Property/Value Pairs for Optical Aberration Plots
Property
Value
Default
Description
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
colortable
How to color this surface.
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 colormethod is set to colortable. See Color Tables for a list of color tables.
colortablerev
on | off
off
Whether to reverse to color table when colormethod is set to colortable.
colortablesym
on | off
off
Whether to symmetrize the color range around 0 when colormethod is set to colortable.
customcolor
RGB-triplet
{1,0,0} or last used color.
The uniform color to use. Active when color is set to custom.
data
none | parent | data set name
parent
The data set this feature refers to, which must be an Intersection Point 3D data set. This Intersection Point 3D data set should describe the intersection points of rays with a Gaussian reference hemisphere centered at 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.
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.
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.
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)