AVS Modules                                                      scat bub
copyright  1992   Michael J. Rangitsch                         5 Mar 1992

NAME
      scat bub  - visualize a scatter data set (field 1D real 3-space) by
                  drawing spheres at the coordinate locations of the field
                  and optionally coloring the spheres based on the field
                  values and optionally dropping vertical lines in each
                  coordinate plane

SUMMARY
      Name        scat bub

      Type        mapper

      Inputs      field 1D real 3-space (a scatter field)
                  colormap  (optional)

      Outputs     geometry

      Parameters  NAME                 TYPE
                  Sphere scaling       real slider
                  Drop X               toggle
                  Drop Y               toggle
                  Drop Z               toggle

DESCRIPTION
      This module generates spheres at the mapping locations of a scatter
      (1D irregular) field.  It allows coloring of the spheres based on the
      data values (of the first element of the data vector) and an input 
      color map.  The size of the spheres is controlled with a scale factor 
      (based on only the geometry, no data values are used).  To allow 
      easier 3 dimensional viewing it is possible to drop lines to the zero 
      level planes in each of the coordinate directions.  These drop lines 
      are colored by the same color map of the spheres.   

 WARNING!!!!!	         It is easy to create data sets which are very 
      large and slow to draw.  For an unknown data set, use the downsize
      module to reduce the amount of data to be processed.

INPUT
      The input data must be an AVS 1D real irregular 3-space field (a
      scatter field).  A colormap is optional.

OUTPUT
      The output is a geometry object consisting spheres and optional drop
      lines.

PARAMETERS
      Sphere scaling - the size of the spheres drawn

      Drop X         - a toggle to draw drop lines to the zero x plane

      Drop Y         - a toggle to draw drop lines to the zero y plane

      Drop Z         - a toggle to draw drop lines to the zero z plane

EXAMPLES
      The following network shows a typical usage of scat_bub


                             read field
                                  |               
                            field to float        
                                  |
                 ------------ downsize
                |                 |
          volume bounds     field to scatter (also available)
                |                 |
                |             scat bubb
                |                 |
                 ---------- render geometry
                                  |
                           display pixmap


Another example to create a scatter field in a different way

                             read field
                                  |               
                            field to float        
                                  |
                 ------------ downsize
                |                 |
          volume bounds    orthogonal slicer
                |                 |
                |          orthogonal slicer
                |                 |
                |             scat bubb
                |                 |
                 ---------- render geometry
                                  |
                           display pixmap

RELATED MODULES
      scatter dots, field to scatter, bubbleviz

AVS Module						        scat_bubb
Michael J. Rangitsch          				       5 Mar 1992
