Go to Common Results Node Settings for links to information about these sections: Data, Title, and Inherit Style.
|
The Spot Diagram plot is available with the Ray Optics Module.
|
•
|
Select the Filter by wavelength check box to hide all rays except those of a specified vacuum wavelength. If this check box is selected, enter a Wavelength (default: 632.8 nm) and a Tolerance (default: 1 nm). If the difference between the specified wavelength and the vacuum wavelength of a ray exceeds this tolerance, then the ray will not be plotted.
|
•
|
Select the Filter by release feature index check box to hide all rays except those released by a specific physics feature. Then enter an integer value for the index; the default is 1. This field is 1-indexed, meaning that 1 corresponds to the first ray release feature, 2 is the second ray release feature, and so on.
|
•
|
Select the Filter by number of reflections check box to show rays only if they have reflected a specified number of times. Then enter an integer for the number of reflections; the default is 0. For this option to work correctly, it is necessary to select the Count reflections check box in the settings for the Geometrical Optics interface before running the study.
|
•
|
Select the Filter by additional logical expression check box to show rays if they satisfy another user-defined expression. The expression is considered to be true if it returns a nonzero value. The default expression is 1, which would cause all rays to be shown.
|
•
|
For Direction based, the normal to the focal plane is the average ray direction. This average is taken over all rays that satisfy the filter criteria given by the Filters section above.
|
•
|
For Position based, the normal to the focal plane is determined such that the ray positions are as close to the plane as possible. If the rays are stopped at a curved surface, the normal computed in this way may differ significantly from the surface normal.
|
•
|
For User defined, enter values or expressions for the normal vector components directly. By default, the z-axis is used.
|
•
|
For Automatic, a set of two transverse directions are arbitrarily chosen, such that they are orthogonal to each other and to the normal direction.
|
•
|
For User defined, enter the components of one of the transverse directions directly. By default, the x-axis is used. If necessary, this transverse direction is projected onto the plane perpendicular to the normal direction. Then the other transverse direction is the cross product of the normal with the first transverse direction. The Transverse direction should never be parallel to the Normal to focal plane.
|
The button commands to create or update an Intersection Point 3D dataset indicating the reference hemisphere can also be accessed from the physics API. In a model method or in a model Java® file, you can use commands such as
|
•
|
For Sort by release feature, one spot will be shown for each ray release feature for which solution data exists.
|
•
|
For Sort by wavelength, one spot will be shown for each wavelength. Select an option from the Sorting method list: Limits, Number of intervals, or Tolerance (the default).
|
-
|
For Limits, enter a list of Limits (SI unit: m). Rays having a vacuum wavelength within any one of the specified intervals will be grouped in the same spot.
|
-
|
For Number of intervals, enter an integer value for the Number of intervals. The default is 10. The rays will be organized into the specified number of subintervals based on wavelength, with each interval creating a spot. Also select an option from the Distribution list. If Equal number of rays (the default) is selected, then the rays are divided among the specified number of bins so that each bin contains the same number of rays, while trying to keep rays of the same wavelength in the same group. If Equal interval width is selected, the rays are distributed among the specified number of intervals so that each interval is the same size.
|
-
|
For Tolerance, enter a value for the Tolerance (SI unit: m). The default is 1 nm. Rays will be grouped into the same spot if the difference between their vacuum wavelengths is less than the specified tolerance.
|
•
|
For Single spot, the relative displacement of rays in the plot will be proportional to their relative displacement in the image plane; the rays will not be moved relative to each other for visualization purposes.
|
•
|
For Average over rays, the coordinates of the center of each spot are defined as the arithmetic mean over the coordinates of rays in that spot.
|
•
|
For Average over area, the coordinates of the center of each spot are defined as the average of the maximum and minimum coordinates of rays in that spot.
|
•
|
Select the Show wavelength check box to display the vacuum wavelength of each spot.
|
•
|
Select the Show spot coordinates check box to display the position of each spot.
|
•
|
For an example of the use of Spot Diagram plots: Double Gauss Lens: Application Library path Ray_Optics_Module/Lenses_Cameras_and_Telescopes/double_gauss_lens.
|