waffle - 3D cellular surface diagram, with averaged statistics on side shadow panels, and annotation. A transparent theshold sheet is superimposed on waffle grid.

Name

     waffle - 3D cellular surface diagram, with averaged statistics
              on side shadow panels, and annotation. A transparent
              theshold sheet is superimposed on waffle grid.

Author

Ian Curington, Advanced Visual Systems, Staines, UK

Summary

     Name	   waffle

Type

  mapper

Inputs

   field 2D scalar float uniform
		   colormap 

Outputs

   geometry

Parameters

   Name		   Type		  Default	 Min	   Max
		   Z scale	   float	  1.0		 none	   none
                   width           float          .6             0.        1.
                   offset          float          .1             0.        1.
                   threshold       float          1.             none      none
                   tic scale       float          1.             none      none
                   show X-cells    boolean        on             off       on
                   show Y-cells    boolean        on             off       on
                   show shadows    boolean        on             off       on
                   show threshold  boolean        on             off       on
                   show annotation boolean        on             off       on

Description

     The waffle module converts a two-dimensional floating point
     field into group of 3D cross section planes,
     represented as a GEOM-format mesh, with the base at zero.
     Each X or Y line  of the field is mapped to a "fence".
     The height of each fence post above each point
     is proportional to the scalar
     value of the field. This is my attempt at "Business Graphics",
     for a multi-dimensional telecommunications statistics data
     application, while allowing 3D interaction.
     Side panels show the Min, Max and Average along each row and column
     in the 2D data.
     A threshold transparent sheet can be moved through the mesh to
     highlight specific values, where only values above the threshold
     will stick up beyond the sheet.
     Line tic marks and text labels show the row and column numbers,
     and the vertical scale
     The waffle cells don't have bottoms, so you can look inside!
     This module does no normalization of the Z-height, while the
     x-y plane is approx 0.0 to 1.0 on each side.
     Use the dials to get your data range under control.
     The dials are unbounded to allow any data range.
     but will be over-sensitive for small numbers.
     Try flying over the waffle in perspective to see the hole pattern.
     It makes a lot more polygons than field_to_mesh, be carefull!
INPUTS
     Data Field (required; field 2D scalar uniform float)
     The input data must be a 2D field with a scalar data value at
     each element.
     Colormap 
     Colors each vertex in the waffle section sheet a specific color,
     according to the data value at that point.
PARAMETERS
     Z scale    height scale for whole waffle mesh
     width      relative width of each side panel
     offset     how far away the average shadow planes are from mesh
     threshold  height of threshold sheet in mesh 
     tic scale  vertical scale tic mark pitch control
     show toggles, enable or dissable parts of the display
OUTPUTS
     Geometry
	  The output is	an AVS geometry.

Example

     see the waffle.net in this directory.