VGP1_1, GRAPHICS, Vector Globe Projection tool

		THIS PROGRAM REQUIRES MOTIF OR LESSTIF!

What is vgp?

Vector Globe Projection is a tool for engineers, scientists, or anyone
that deals with series of R3 (3-dimensional) vectors.  (A vector of
vectors so to speak.)  The usual case is a set of these n x 3 matrices
with one representing time and the others representing other signals
like momentum or velocity, changing with time.  It could also
represent a partial attitude, by the vector representing e.g. the
Y-axis of the body with respect to an inertia frame.  Throughout this
document I will refer to the series as a time history which is most
usually the case.  vgp displays the entire time history of the vector
as the path it would follow on a sphere.  This time history can be
animated as a vector starting at the center of sphere and pointing
toward the current point.  The current row number of the data is
displayed in the top right corner.

What are the controls?

The left mouse button will rotate the sphere. The right button will
translate the sphere.  The middle mouse button will create a zoom
rectangle that should be dragged around the region of interest and a
zoom-in will occur.  To zoom-out either push the "full size" button or
shift-middle mouse button.  The "start" button will start the
animation.

Data Format:

The data format consists of three space delimited columns of ASCII
text floating point numbers.

Examples:

	vgp data/orbit.data data/earth.dat data/latlon.dat

I've included some example data files to demonstrate some of the
concepts.  The data is in the 'data' sub-directory.  The first is
named 'spiral.dat'.  This is a simple spiral which is good
demonstration of the animation.  The file 'earth.dat' is the outline
of all the major land masses.  This is only for show purposes and not
the point of the program.  The last two files were generated by the
SWAS spacecraft simulation.  The file 'cone.dat' demonstrates the
solar array axis of the spacecraft acquiring the sun and coning about
it.  The file 'map.dat' demonstrates the mapping mode of the
spacecraft along the instrument bore-sight.  This data must be zoomed
in on a lot!  Look for the busy part of the picture.  This can be
found be starting the animation and rotating the sphere until you find
the point were the vector spends the most time.  Zoom in on this area
repeatedly and you will notice the finer and finer details of the
motion.


What vgp is not:

Since I work with spacecraft many people urged me to make the
sphere the earth and animate a spacecraft going around it.  But this
program is meant to be more general than that.  This program will
work with any series of 3D vectors.  Also, from an engineering
perspective, I feel this program, the way it is, gives the important
information.


Send Bugs, suggestions, help to:

		Rick Niles
		niles@axp745.gsfc.nasa.gov

VGP port under OpenVMS         Nov 1995
======================

Exe and Objs provided:
---------------------

VAX : VMS 5.5-2, VAX C 3.2, Motif 1.1
Alpha: VMS 6.1-1H2, DEC C 5.0, Motif 1.2

Patrick Moreau
pmoreau@cena.dgac.fr
moreau_p@decus.fr


