IRIS Explorer Module: Glyphs

Control Panels:

Help File:

NAME Glyphs DESCRIPTION The Glyphs module generates colored, transparent, scaled, and oriented geometric primitives (spheres, cubes, octahedra, cones, etc.) at each grid point of a 1..3-D lattice similarly to the Ball module. It is usually used to visualize multivariate data. If one Glyphs module is not sufficient to visualize all data channels or to create the appropriated geometry, several Glyphs modules combined might be able to do the job. INPUTS Input -- Lattice (1..3-D, 1..-vector, float). Input lattice of points to be used for primitive generation. Unrestricted Input -- Lattice (Opt.) (1..3-D, 1..-vector, float). Optional lattice which should include all the points of the Input lattice. If supplied it is used to determine the range of data values which is used to determine the final sizes of the glyphs. This is most useful when the Input lattice is a restricted version of a larger lattice. Colormap -- Lattice (Opt.) (1..2-D, 4-vector, float, uniform). Colormap to be used to color primitives. Textual Data -- Parameter (Opt.) A text parameter which lines are interepreted as textual entries. WIDGETS Online -- Radio Box (Offline (No Output), Online (Send Primitives)). If Offline the module does not send any output. This is useful in order to avoid unnecessary renderings when several parameters have to be changed and intermediate results are of no interest. Primitive -- Option Menu (Sphere, Cube, Octahedron, Cylinder, Cone, Pyramid, Half Octahedron, Wedge (360/4=90), Wedge (360/6=60), Wedge (360/8=45), Wedge (360/10=36), Wedge (360/12=30), Text (Textual Data), Text (Number), Various (Text Channel)). Type of geometric primitive to be placed at every grid point. These primitives are defined in local coordinate systems with the origin at each grid point. All primitives fit into a unit box centered at the origin. The preferred symmetry axis is the z-axis. In detail the geometries are: - Sphere: Centered at the origin, diameter is 1. - Cube: Centered at the origin, edge length is 1. - Octahedron: Centered at the origin, all vertices are on the axes. - Cylinder: Centered at the origin, diameter is 1, length is 1, symmetry axis is the (positive) z-axis. - Cone: Center of the base is the origin, diameter of the base is 1, height is 0.5, symmetry axis is the z-axis. - Pyramid: The base is a square centered at the origin, height is 0.5, top is on the positive z-axis. - Half Octahedron: Upper (with respect to the positive z-axis) half of the octahedron. (Similar to the pyramid but rotated about the z-axis and slightly strechted in x and y direction.) - Wedges: The rectangular base is in the xy plane, height is 0.5, the top edge is parallel to the y-axis and intersects with the positive z-axis. The only difference between the wedges is the angle at the top edge. - Text (Textual Data): A text primitive. The text is determined by interpreting the numbers in "Text Channel" as line indices to the "Textual Data" parameter. Text size is controlled by the "Resolution". - Text (Number): A text primitive. The text is determined by printing the data in "Text Channel". Text size is controlled by the "Resolution". - Various (Text Channel): One of the first seven primitives. The primitive is determined by the data in "Text Channel": data mod 7 is the index of the primitive according to the list above. Text size is controlled by the "Resolution". Primitive Style -- Radio Box (Filled, Wire Frame). Whether faces of the primitives are filled or only edges are drawn. Resolution -- Slider Spheres, cylinders and cones allow to specifiy a resolution of the polygon approximation. For text primitives this value determines the size. Text Channel -- Slider For text primitives this channel specifies the channel the values of which are printed, or interpreted as line indices to the "Textual Data" parameter in order to determine the glyph text, or used to determine the primitive. Color Channel -- Slider Data Channel used to determine the color of the primitives. Trans. Channel -- Slider Data Channel used to determine the transparency of the primitives. X Size Channel -- Slider Data Channel used to scale the primitives in the x direction. Y Size Channel -- Slider Data Channel used to scale the primitives in the y direction. Z Size Channel -- Slider Data Channel used to scale the primitives in the z direction. Color Mode -- Option Menu (Fixed (Min.), Data, Data (0->Min.)). If "Color Mode" is "Fixed", "Color Min." determines the color via the "Colormap"; for "Data" the values in the "Color Data Channel" are mapped to the interval between "Color Min." and "Color Max." and the result determines the color of primitives; for "Data (0->Min.)" the values between 0 and the maximum value in "Color Channel" are mapped to the interval between "Color Min." and "Color Max.". Trans. Mode -- Option Menu (Fixed (Min.), Data, Data (0->Min.)). See "Color Mode" but for transparency. X Mode -- Option Menu (Fixed (Max.), Data, Data (0->Min.)). If "X Mode" is "Fixed", "X Size Max." is used to scale in x direction; for "Data" the values in the "X Size Channel" are mapped to the interval between "X Size Min." and "X Size Max." and the result determines the scaling in x direction; for "Data (0->Min.)" the values between 0 and the maximum value in "X Size Channel" are mapped to the interval between "X Size Min." and "X Size Max.". All sizes are specified as fractions of the size of the bounding box of the input lattice in x direction. Y Mode -- Option Menu (Fixed (Max.), Data, Data (0->Min.)). See "X Mode" but for the y direction. Z Mode -- Option Menu (Fixed (Max.), Data, Data (0->Min.)). See "X Mode" but for the z direction. Color Min. -- Dial See "Color Mode". Color Max. -- Dial See "Color Mode". Trans. Min. -- Dial See "Trans. Mode". Trans. Max. -- Dial See "Trans. Mode. X Size Min. -- Dial See "X Mode". X Size Max. -- Dial See "X Mode". Y Size Min. -- Dial See "Y Mode". Y Size Max. -- Dial See "Y Mode". Z Size Min. -- Dial See "Z Mode". Z Size Max. -- Dial See "Z Mode". Orientation Mode -- Option Menu (No Orientation, Orient Z Axis, Orient & Scale Z Axis). If "Orientation Mode" is set to "No Orientation" primitives are not oriented. If it is "Orient Z Axis" the z axis of each primitive is rotated to a new axis which is specified by the data in the "X Coordinate Channel", "Y Coordinate Channel", and "Z Coordinate Channel". This mechanism is usually used to visualize vector fields. If "Orientation Mode" is "Orient & Scale Z Axis" the primitive is also scaled (in all directions) by the length of the vector given by the data variables. (This orientation is done after translation, Euler rotation and scaling.) X Coordinate Channel -- Slider See "Orientation Mode". Y Coordinate Channel -- Slider See "Orientation Mode". Z Coordinate Channel -- Slider See "Orientation Mode". X Translation -- Dial Movement of the original primitive geometry in x direction. (This is the first transformation applied to the primitives.) Y Translation -- Dial Movement of the original primitive geometry in y direction. (This is the first transformation applied to the primitives.) Z Translation -- Dial Movement of the original primitive geometry in z direction. (This is the first transformation applied to the primitives.) Phi -- Dial One of the 3 angles specifying an Euler rotation of the primitives. (The Euler rotation is applied after the translation.) Theta -- Dial One of the 3 angles specifying an Euler rotation of the primitives. (The Euler rotation is applied after the translation.) Psi -- Dial One of the 3 angles specifying an Euler rotation of the primitives. (The Euler rotation is applied after the translation.) Restriction Mode -- Option Menu (None, Min-Max, Around Value). Glyphs can be suppressed by applying a restriction on the data values in the "Restriction Channel". If "Restriction Mode" is "Min-Max" a glyph in only created if the data value is between "Res. Min." and "Res. Max.", if "Restriction Mode" is "Around Value", a glyph is only created if the data value is between "Res. Value" - "Res. Width" / 2 and "Res. Value" + "Res. Width" / 2. Restriction Channel -- Slider See "Restriction Mode". Res. Min. -- Dial See "Restriction Mode". Res. Max. -- Dial See "Restriction Mode". Res. Value -- Dial See "Restriction Mode". Res. Width -- Dial See "Restriction Mode". OUTPUTS Glyphs -- Geometry Output geometry of primitives. KNOWN PROBLEMS None. SEE ALSO Ball, Particles, CullDataRows, AllAxis2, ShowClosestPoint - Martin Kraus (Martin.Kraus@informatik.uni-stuttgart.de) Visualization and Interactive Systems University of Stuttgart http://wwwvis.informatik.uni-stuttgart.de