NAME	  ucd profile - draw vector arrows along surface profile

SYNOPSIS: Draw Vector Arrows from Cell Surface Boundary Nodes
          for Finite Volume UCD data showing surface cross-section
          profiles.

Author:   Ian Curington
          Advanced Visual Systems, Inc,
          Thames Mews, Portsmouth Road
          Esher, Surrey
          +44-372-471161
          ianc@avs.com


Type	Mapper

Input	UCD
        Colormap
        struct upstream transform  Interactive Transformations
        struct upstream geom       Picking Mode info

Output	Geometry (arrow representation and control surface)
        Field 1D 3-space irregular (scatter)

Parameters:
	Name		Type		Notes

	Scale		float		Arrow Length Scale
        Method          choice          Profile or Node based arrows
        Color Arrows    toggle          color on-off
        Arrow Heads     toggle          heads on-off
        Arrow Base      toggle          arrow stem on-off
        Flip Sign       toggle          reverse arrow direction
        Distance        float           move profile normal to current
        N per cell      int             samples per cell face
        Normalize       toggle          makes arrows unit length *scale
        Absolute Value  toggle          make all arrows same direction
        Show Intersect  toggle          draw line on surface on-off
        Node Data       choice          which property scalar to show
        Pick Info       text block      picking status info block

Source	ucd_profile.c, Makefile, ucd_profile.txt, ucd_profile.net


DESCRIPTION:

   This module draws Vector Arrows from UCD Cell Surface Boundary data
   as intersected by a surface cross-section profile. Airflow Lift-Drag
   analysis plots from surface pressure can be manipulated or animated
   dynamically, by dragging the profile plane through a large model.
   The profile sampled data can be sent to the graph viewer, or
   other field modules.
   This mapper module computes the exterior boundary surface of the UCD
   from node connectivity and material regions, then cuts these faces
   with an interactive slicing profile plane. It works with 2D shell
   elements or 3D elements. The profile plane uses interactive 3D
   feedback control from the geometry viewer window. The arrows
   can be picked with the left mouse button,
   and model data is shown in an information panel
   for the selected point. All data sampled by the cutting plane
   is available on a scatter field output port for further analysis.
   The distance dial can be controlled by animated float
   to create a swept path of profile surface.
   Any number of scalars or vector components on the UCD can be
   viewed, for vector data item the vector subcomponents are available
   in a choice list.

Notes:
   If you have CELL based
   values, you should also consider the ucd_cell_to_node module.
   The Scale dial is simply a length multiplier.
   Positioning is performed with direct geometry viewer interaction.
  
   The scatter output field can be used by scatter dots, or other
   the graph viewer, and contains 
     suface scalar samples,
     x, y, z sample positions,
     surface normal vector, projected onto profile plane,
     cell_id for each sample,
     material id for each sample.

Restrictions: This relies on AVS version 4.0 or later.

Related Modules: ucd_to_geom, ucd_contour, ucd_cell_geom

Example Network: ( see ucd_profile.net )

                    READ_UCD 
           ------------|
           |           |
       UCD PROFILE     |
           |           |
           |     UCD TO GEOM (edge mode)
           |          |
           |----|     |
              GEOMETRY Viewer