RayTrajectories
Create a ray trajectories plot in 2D and 3D
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 dataset is required to plot ray trajectories. The ray dataset 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:
heat | tail | center
Active when pointtype is set to arrow. Determines the direction in which the arrow points.
logarithmic | normalized | 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.
If arrowscaleactive is true: the length scale factor.
If true, arrowscale is used, otherwise the scale factor is computed automatically.
arrow | arrowhead | cone
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.
none | parent | dataset name
head | tail
arrow | cone | none
The ellipse arrow scale factor, if ellipsearrowscaleactive is set to true.
Maximum number of ellipses, when ellipseentrymethod is numberofellipses.
numberofellipses | listoftimes
The ellipse entry type when pointtype is ellipse: number of ellipses or a list of times.
Collection of times for polarization ellipses when ellipseentrymethod is listoftimes.
none | specifiedtimes | proportional
If inheritplot is not none: Determines if the arrow scale is inherited.
If inheritplot is not none: Determines if the color is inherited.
If inheritplot is not none: Determines if the deformation scale is inherited.
If inheritplot is not none: Determines if the ellipse scale factor is inherited.
none | plot name
If inheritplot is not none: Determines if the color and data ranges are inherited.
If inheritplot is not none: Determines if the radius scale factor is inherited.
If inheritplot is not none: Determines if the tail scale factor is inherited.
If inheritplot is not none: Determines if the transparency settings are inherited.
If inheritplot is not none: Determines if the tube radius scale factor is inherited.
Number of interpolated time, when interpolation is set to uniform.
none | uniform
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
black (2D), red (3D)
none | line | ribbon | tube
If arrowlength is logarithmic: The ratio between the maximum arrow length and the arrow length below which no arrow is drawn.
If extrasteps is specifiedtimes, controls the maximum number of extra time steps to render in the plot.
on | off
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
on | off
none | point | comettail | arrow | ellipse
If extrasteps is proportional, controls the maximum number of extra time steps to render in the plot. The maximum number of extra steps is the product of this proportionality factor with the number of solution times.
on | off
If on, sphereradiusscale is used; otherwise the scale factor is computed automatically.
manual | parent
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
Active when pointtype is set to comettail and tailscaleactive is on. Specifies the manual scale factor with which the comet tail expression is multiplied.
on | off
Active when pointtype is set to comettail. Specifies whether manual tail scaling is enabled.
Active when title is set to manual. Specifies the plot title.
automatic | manual | none
on | off
If on, tuberadiusscale is used; otherwise, the scale factor is computed automatically.
Attributes
Color, Deform, Export, Filter (Particle Tracing, Point Trajectories, Ray Tracing), MaterialAppearance, Translation, Transparency (3D only)
See Also
ParticleTrajectories, PointTrajectories, Ray (Dataset), Ray (1D Plot), Ray (Evaluation)