OpticalAberration

	The Optical Aberration plot is available with the Ray Optics Module.

model.result(<pgtag>).feature(<ftag>).set(property, <value>);

model.result(<pgtag>).feature(<ftag>).runCommand("createReferenceHemisphereDataset");

model.result(<pgtag>).feature(<ftag>).runCommand("recomputeReferenceHemisphereDataset");

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.

Table 7-87: 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.
colorscalemode	linear \| linearsymmetric \| logarithmic	linear	Scaling of the color table: linear, linear symmetric around 0, or logarithmic, when coloring is set to colortable or gradient.
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.
colortabletrans	none \| reverse \| nonlinear \| nonlinearsymmetric	none	Transformation of the color table, 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.
nonlinearcolortablerev	on \| off	off	Whether to reverse to color table or gradient when coloring is set to colortable or gradient and colortabletrans is set to nonlinear or nonlinearsymmetric.
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 \| manual \| none	auto	auto, if the title contribution should be computed automatically, possibly using the group’s customization. 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).

Table 7-87: Valid Property/Value Pairs for Optical Aberration Plots

additionallogical-
-expression

String

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.