Ray Trajectories

Create a ray trajectories plot.

Syntax

model.result(<pgtag>).create(<ftag>,"RayTrajectories");

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

model.result(<pgtag>).feature(<ftag>).run();

Description

model.result(<pgtag>).create(<ftag>,"RayTrajectories") creates a ray trajectories plot feature named <ftag> belonging to plot group <pgtag>.

A ray data set is required to plot ray trajectories. The ray data set identifies the geometry in which the ray data is stored and the degrees of freedom which determine the position of each ray.

The following properties are available:

Table 7-78: Valid Property/Value Pairs for Ray Trajectories Plots

Name	Value	Default	Description
arrowbase	heat|tail| center	head	Whether the head, tail, or center of the arrow is located at the ray position.
arrowexpr	string array		Active when pointtype is set to arrow. Determines the direction in which the arrow points.
arrowlength	logarithmic| normalized| proportional	proportional	The arrow scaling: Proportional uses the actual arrow length, normalized a unit length, and logarithmic a length proportional to the logarithm of the arrow length.
arrowscale	positive double	1	If arrowscalefactor is true: the length scale factor.
arrowscaleactive	boolean	false	If true, arrowscale is used, otherwise the scale factor is computed automatically.
arrowtype	Arrow|cone	Arrow	The type of arrow to draw
comettailexpr	String array	inverse of velocity vector of the first available ray tracing interface	Active when pointtype is set to comettail. Determines the direction in which the comet tail points and the relative sizes of the tails of different rays.
data	none | parent | data set name	parent	The data set this feature refers to
inheritarrowscale	Boolean	true	If inheritplot is not none: Determines if the arrow scale is inherited.
inheritcolor	Boolean	true	If inheritplot is not none: Determines if the color is inherited.
inheritdeformscale	Boolean	true	If inheritplot is not none: Determines if the deformation scale is inherited.
inheritellipsecale	Boolean	true	If inheritplot is not none: Determines if the ellipse scale factor is inherited.
inheritplot	none | plot name	none	The plot that color, color range, and deformation scale are inherited from.
inheritrange	Boolean	true	If inheritplot is not none: Determines if the color and data ranges are inherited.
inheritspherescale	Boolean	true	If inheritplot is not none: Determines if the radius scale factor is inherited.
inherittailscale	Boolean	true	If inheritplot is not none: Determines if the tail scale factor is inherited.
inherittubescale	Boolean	true	If inheritplot is not none: Determines if the tube radius scale factor is inherited.
interpolation	none | uniform	none	The type of interpolation used to plot lines when linetype is line or tube.
linecolor	custom | black | blue | cyan | green | magenta | red | white | yellow	black (2D), red (3D)	The uniform color to use for lines
linetype	none | line | tube	line	Plot ray traces as lines or tubes, or not at all
logrange	double > 1	100	If arrowlength is logarithmic: The ratio between the maximum arrow length and the arrow length below which no arrow is drawn.
pointautoscale	on | off	on	If enabled, the point radii are scaled based on the size of the geometry.
pointcolor	custom | black | blue | cyan | green | magenta | red | white | yellow	red	The uniform color to use for points.
pointlineanim	on | off	off	When animating ray trajectories plots with points, this property indicates whether the points at the current time should appear on top of the lines.
pointradiusexpr	String	0.001	The point radius expression
pointtype	none | point | comettail	none	Plot rays as points or with comet tails, or not at all.
radiusexpr	String	1	The tube radius expression
sphereradiusscale	positive double		The scale factor applied to the point radii if sphereradiusscaleactive is on.
sphereradiusscaleactive	on | off	off	If on, sphereradiusscale is used; otherwise the scale factor is computed automatically.
tailscale	positive double	1	Active when pointtype is set to comettail and tailscaleactive is on. Specifies the manual scale factor with which the comet tail expression is multiplied.
tailscaleactive	on | off	off	Active when pointtype is set to comettail. Specifies whether manual tail scaling is enabled.
title	String		Active when title is set to manual. Specifies the plot title.
titletype	automatic | manual | none	automatic	Determines how the plot title is specified
tuberadiusscale	String	1	The scale factor applied to the tube radii if tuberadiusscaleactive is on.
tuberadiusscaleactive	on | off	off	If on, tuberadiusscale is used, otherwise the scale factor is computed automatically

See Also

Ray (1D Plot), Ray (Evaluation)