Ray (Dataset)
Create a ray dataset.
Syntax
model.result().dataset().create(<dtag>,"Ray");
model.result().dataset(<dtag>).set(property,<value>);
Description
model.result().dataset().create(<dtag>,"Ray") creates a ray dataset.
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:
Table 7-120: Valid Property/Value Pairs for Ray Datasets.
Name
Value
Default
Description
solution
String
first available solution
The solution this dataset refers to.
pgeomspec
manual | fromphysics
fromphysics if an applicable physics interface is available, otherwise manual
The method of specifying the ray geometry and the names of the ray position degrees of freedom.
physicsinterface
none or the tag of a valid physics interface
none or first applicable physics interface
The physics interface from which the ray geometry and the names of the ray position degrees of freedom are defined.
rgeom
String
rgeom or pgeom_ followed by the tag of a Geometrical Optics or Ray Acoustics interface
The geometry in which the ray degrees of freedom are defined. The correct name of this ray geometry is pgeom_<name>, where <name> is the name for the Geometrical Optics or Ray Acoustics interface node.
posdof
String array
Position vector components in an applicable physics interface
The position degrees of freedom of the rays.