NAME	ucd cell geometry

SYNOPSIS: Map Colors on UCD cells from CELL values, or Material Id

Type	Mapper

Input	UCD
        Colormap

Output	Geometry

Parameters:
	Name		Type		Choices

	Method		choice		Cell Number, Cell Data, Material Id

	Wire Frame	toggle		On, Off

	Variable	integer		

Source	ucd_cell_geom.c

Author: Ian Curington, AVS Inc, Staines, UK  < ianc@avs.com >
	Modified to select a variable to display (rather than defaulting
	to the first) by Penny Rheingans, Martin Marietta, US EPA
	Visualization Center < rheingan@ralph.rtpnc.epa.gov >

DESCRIPTION
  
   This  module draws geometric representation of UCD input
   showing CELL data, CELL Material ID, or Cell Number Sequence.
  
   This is a special ucd mapper module designed to make
   representations based on CELL based values rather than
   the more typical NODE based values. If you have CELL based
   values, you should consider the ucd_cell_to_node module.
  
   This module colours each cell ONE color, without color interpolation,
   showing a single scalar quantity. If your cell data is n-vector,
   this module will select a component based on the value of the 
   Variable parameter. It will color the cells based on
   [1] the linear cell number, or cell_id tag. It maps this range onto the
       color input map.
   [2] cell scalar data. Use the "upper" and "lower" colormap dials
       to set the color to value mapping.
   [3] material id numbers. It maps the max material id to cover the 
       input color map range.
  
   This module also has a direct SHADED/WIRE_FRAME toggle control,
   just to save time going to the viewer panel.
  
   This module is not like the standard ucd_to_geom,
   in that it:
   - does not cache information about the ucd structure
     in between invocations,
   - does not have a color array input from ucd_legend,
     rather it colors directly with a colormap input,
   - does not have "external faces" mode
   - does not have "explode materials" mode
   - does not have "shrink" function
   - containes no calls to internal unsupported utilities
   - does not cache geometry for fast animation
   - does not process node data at all.
  
This module is intended as a source example for other UCD module
developers.

Related Modules: ucd_to_geom, ucd_contour

Example Network: ( see ucd_cell_geom.net )

   GENERATE COLORMAP                   READ_UCD
      |                                  |
      ------------         --------------
                 |         |
              UCD CELL GEOMETRY
                     |
              RENDER GEOMETRY
                     |
              DISPLAY PIXMAP