NAME	scatter arrows

SYNOPSIS: Draw Vector Arrows from irregular 1D (scatter) fields

Author: Ian Curington, AVS Inc, Staines, UK  < ianc@avs.com >
        (Updated 10/2/93 Steve Larkin, CGU, MCC, UK <s.larkin@uk.ac.mcc>)

Type	Mapper

Input	Field 1D 3-space irregular 3-vector float
        Colormap (optional)

Output	Geometry

Parameters:
	Name		  Type		Choices

	Scale		  float		1.0, unbounded
        Normalise Vector  boolean       off, on

Source	scatter_arrows.c


DESCRIPTION:
  
   This  module draws vectors with arrow heads from scatter input
   showing vector data at the specified positions.
  
   The module will draw both 2D and 3D vectors, as required.

   The Scale dial is simply a length multiplier.
  
   If the ``Normalise Vector'' is toggled on then the vectors
   are all drawn the same length.  If an optional colormap
   is supplied via the input port then the arrows are colored
   according to their magnitude using the colormap.

Example Network: 
----------------

1. see scatter_arrows.net

   A data file is included to test the module.
   data.fld and data.dat

2. see scatter_arrows2.net

   This network uses a combination of field math modules
   to calculate the vector magnitude of the field data
   which is then used to alter the range of the colormap.

   A data file testdata.dat and testdata.fld are
   included to test the module.