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