Copyright 1992 by David A. Curry

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting documentation.  The
author makes no representations about the suitability of this software for
any purpose.  It is provided "as is" without express or implied warranty.

------------------------------------------------------------------------------
							February, 1996

This is Version 1.4 of N9MSW XSAT, an X Window System based satellite
tracking program, by David Curry, as modified by Terry R. Friedrichsen.
XSAT provides the following features:

	- On-screen or PostScript display of maps of each continent, the
	  United States, or the world.

	- On-screen or PostScript display of "ground track" information
	  placed over the maps, showing the path of the satellite.

	- On-screen or PostScript display of satellite visibility and
	  location centered on a particular city.

	- Interactive selection of the city from which to compute satellite
	  visibility information.

	- Interactive selection of the satellite to be tracked.

	- Interactive adjustment of simulation parameters such as start and
	  stop times, step time, and minimum satellite elevation.

The orbital calculations are done using the code written by Robert Berger
(N3EMO), and posted to comp.sources some time ago as "n3emo-orbit".

Modifications for color displays and a few bug fixes and minor enhancements
made by Terry R. Friedrichsen (N7XJO), terry@venus.sunquest.com.  These mod-
ifications are not specifically identified in the source, but they fall under
David Curry's original copyright terms and conditions.

The file xsat-1.2-solaris.patches contains context diffs of patches provided
by Mike Porter (mike@strauss.udel.edu) for Solaris 2.3.  These patches were
to the original 1.0 version of xsat; I (Terry) have updated them to apply to
the version 1.2 sources, but they have not been tested.  It's entirely pos-
sible that some of my changes broke Mike's Solaris patches; if so, the fault
is mine and not Mike's.  Please note that these patches have *not* been up-
dated to the version 1.4 sources.

The getElementSets script originated in Manfred Bester's SatTrack software
distribution, and has been modified somewhat for application to XSAT.

XSAT 1.4 has been compiled and tested on a DECstation 5000/200 running Ultrix
4.3 and MIT X11R5.  It hasn't been tested on anything else, but if changes
need to be made on other systems, they should be minor.  Please send any
patches in "diff -c" output to the author at the address given below.

To install XSAT, do the following:

1. Edit the Imakefile and set the value of XSATLIBDIR to be the path of the
   directory in which to store XSAT's data files.  The data files require
   about 4MB of disk space.

2. Edit the Imakefile and set the value of TIMEDEFINES correctly for your
   operating system, based on whether "struct tm" in /usr/include/time.h
   has the members "tm_gmtoff" and "tm_zone".

3. Edit the "xsat.h" file and change any of the defaults you don't like.
   The defaults are fairly reasonable, and can be changed as X11 resources,
   so you probably won't need to change anything.

4. Build the Makefile and build the program:

	% xmkmf
	% make

5. Install the program and data files:

	% make install

6. Install the manual page:

	% make install.man

Notes on some of the data files:

lib/cities.info
	This file contains the names of cities the program knows about, and
	their latitude, longitude, and elevation.  There are about 350
	cities listed, but elevations are listed only for the cities in the
	United States.  I do not have a source for elevation information
	for international cities.  The latitude/longitude information for
	the non-US cities is also not as accurate as it could be; it came
	from the UUCP map database.

	Make sure your city is listed in this file; if not, you will have to
	select a nearby city.

	If you have elevation information for any of the cities listed, or
	better latitude/longitude information, or new cities not in the file,
	please send them to me and I will add them.  Please tell me your
	source for the information when you send it.

lib/map.*
	These are files of line segments (x1,y1) (x2,y2) for drawing the
	maps.  The files in the XSAT distribution are a massaged and
	combined version of the ones distributed by James Peterson of MCC.
	The original source for the data is the CIA World Data Bank, circa
	late 1980's.

lib/satellites.doc
	A description of the NORAD two-line orbital element set format used
	by XSAT.

lib/satellites.info
	The NORAD two-line element sets for just about all the satellites up
	there.  This file is posted to the net in sci.space (or sci.space.news)
	every week or so; it is also available via anonymous FTP from the host
	archive.afit.af.mil (129.92.1.66) in /pub/space/tle.new, or can be ob-
	tained from the Celestial BBS, (513) 427-0674.  getElementSets is a
	script which will update this file from the .mil site after you edit
	it a bit to include your username and hostname.

If you have comments, questions, or modifications for XSAT, please direct them
to the current maintainer, Terry R. Friedrichsen, or to the original author,
David A. Curry.

Enjoy.

David A. Curry, N9MSW
Purdue University
Engineering Computer Network
1285 Electrical Engineering Building
West Lafayette, IN 47907
davy@ecn.purdue.edu

Terry R. Friedrichsen, N7XJO
terry@venus.sunquest.com
