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

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