AVS Modules							genloadmd

NAME
	genloadmd - read velocity and coordinate information for N point
		    objects and represent them as spheres color coded by
                    velocity


SUMMARY
	Name	   genloadmd

	Type       Data Input

	Inputs	   "Input File " - string

	Outputs	   "Geom Output" - geom

	Parameters 	Name 		Type	Default	Min	Max
                        ----            ----    ------- ---     ---
			time step	int	0	unbound	unbound
			animate time	int 	0 	unbound	unbound
			sphere radii	float	0.20	0.02	unbound
			min speed	float	0.0	unbound	unbound
			max speed	float	0.0	unbound	unbound
			
DESCRIPTION
	
	This module is designed to read in position and velocity information
from the file specified as "Input File", for a group of point particles in three
 dimensions. The program represents each point with a sphere at the position
specifed and color coded by the magnitude of the velocity.  The colors 0-255 are
specified in the colors.h file and range from blue (slowest) to red (fastest).
Initially the module will compute the minimum and maximum speeds from the data
set read in and echo these back to the parameter widgets. The user can change
the size of the spheres and the min and max values used to determine the colors
of the sphere. Note that if the minimum speed is greater than or equal to the
maximum speed then a message is echoed back to standard output (the screen) and
no action is taken.  Sphere color is determined by a linear interpolation
between the minimum and maximum speeds of the particle velocity magnitude.If the
velocity magnitude of a particular sphere exceeds the maximum speed then it is
displayed as white while those less than the minimum are displayed as black
(note: change the background color if this also is black).


INPUTS
   Input File
	this is the name of the data file and should be in the following format:
	The first line is step number(integer), temperature(float), number of 
	particles(integer). Note that step number and temperture are dummy
	values that are not currently used. This is followed by one line per
	particle each of which starts with a dummy integer particle number and
	is followed by the three x,y,z coordinates (float) and then the three
	velocity components (float) in the x,y,and z directions. This pattern is
	then repeated for each time step, i.e. a header line followed by a data
	line for each particle.


PARAMETERS
   time step
	total number of time steps to read in
   animate time
	shows which step is being displayed
   sphere radii
	radius of the spheres displayed
   min speed
	the minimum speed used to determine what color the sphere will be
	displayed as
   max speed
	the maximum speed used to determine what color the sphere will be
	displayed as


OUTPUTS
   Geom Output
	geometry output to the geometry viewer module

EXAMPLE 1

                        ---------------------
                        |    file browser   |
                        ---------------------
                                 |
                                 |             ---------------------
                                 |             | animated integer  |
                                 |             ---------------------
                                 |                        |
                                 |                        |
                                 |      |-----------------|
                                 |      |                  
                         ---------------------         ---------------------
                         |     genloadmd     |         |       sphere      |
                         ---------------------         ---------------------    
                                 |                                |

                                 |                                |
                                 +--------------------------------|
                                 |                         
                                 |                         
                         ---------------------             
                         |  geometry viewer  |             
                         ---------------------             


RELATED MODULES
	sphere - available from anonymous ftp via the International
		 AVS Center

SEE ALSO
	sololoadmd
	md_params.h - include file
	colors.h - include file
	load_mdn

PORTED TO
	SGI Personal Iris
	IBM RS6000