README for SaVi distribution
============================

SaVi by: Robert Thurman (thurman@geom.umn.edu)
         Patrick Worfolk (worfolk@alum.mit.edu)

Copyright (c) 1995-1997 by The Geometry Center, University of Minnesota.

SaVi is software written to facilitate the visualization and analysis
of satellite constellations.  This software is freely and publicly
available from the authors.  We request that any images produced by
the software credit SaVi and The Geometry Center.  See the file
COPYRIGHT for full details.

If you have not already contacted the authors and wish to be added to
our mailing list, please contact us at: savi@geom.umn.edu

See the SaVi webpages: http://www.geom.umn.edu/locate/SaVi


REQUIREMENTS
============

SaVi can be run as a stand-alone program or as an "external module"
for the Geomview program.  The latter mode allows for 3-dimensional
visualization of the satellite constellations, but then, of course,
you need the Geomview program.

 - Geomview (Available from the Geometry Center;
		http://www.geom.umn.edu/software/download/geomview.html)

        For SaVi to work best with Geomview, you'll need to get some 
	variant of Geomview version 1.6.
	If you have an earlier release of Geomview, most SaVi
	features should work, but take care not to select the
	"Texture mapping available" option.

We have executables available for the following machines and operating
systems:

 - SGI / Irix5
 - Sun SPARC / Solaris 2.4
 - Intel x86 / Linux



RUNNING THE SOFTWARE
====================

We shall refer to the directory containing this file as $SAVI.

1.) To run as a module within Geomview, in the $SAVI directory
    start up Geomview:

	geomview

    and then select "SaVi" from Geomview's scrollable list of external
    modules.  Or invoke directly:

	geomview -run ./savi

    Or from any directory where you can start Geomview, try

	geomview -run $SAVI/savi

2.) To run without 3-dimensional visualization, in the $SAVI directory
    type:

	savi

    Or from any other directory,

	$SAVI/savi

3.) To make SaVi accessible to other users, you can copy the "savi"
    script in $SAVI to some directory in other users' search 
    paths such as /usr/local/bin, so they needn't add SaVi's own 
    directory to their own path.  If you do, edit the "savi" script, 
    inserting the full path name of $SAVI as indicated in 
    the script itself:

# If you move this script away from the SaVi installation then
# you should uncomment the following line
#SAVI=/usr/local/savi
# and replace /usr/local/savi with the location of the SaVi installation.

    Also, you can make SaVi accessible from Geomview's scrollable list of
    external modules.  Assuming Geomview is installed in 
    /usr/local/Geomview, say:

   	cd /usr/local/Geomview/modules/sgi

    Create a file here called ".geomview-savi" containing:

        (emodule-define  "SaVi"  "/usr/local/savi1.0/savi")

    where the right-hand side is the absolute path name for the savi 
    script.


ACKNOWLEDGEMENTS
================

Thanks to Martin Lo, Polly Estabrook and David Bell of NASA's Jet
Propulsion Lab for inspiring this project.

Thanks to Lloyd Wood for his enthusiasm and for supplying us with the
details of many satellite constellations.

Thanks to the Geometry Center technical staff, especially Stuart Levy,
Lori Thomson, and Nicolas Vera.

