##README (June 20, 2011)
# Infrared Processing and Analysis Center (IPAC)
# RELEASE 3.8 of Skyview

This file accompanies the IPAC Skyview Software distribution.  It describes
how to install the Skyview program.

IPAC Skyview is an image display and analysis program originally
created to aid in work on IRAS (Infrared Astronomy Satellite) image
products (Skyflux and the newer IRAS Sky Survey Atlas), which have
already been position and flux calibrated, although any FITS or IRAF
format images can be used without having to convert from one format to
another.

To be able to use the complete version of the software, you need:
	- A Sun4 CPU  using Solaris (we use SunOS 5.8 (Solaris 2.8))
	  or
	- A Sun4 CPU  using SunOS 4. (SunOS)
	  or
	- A DECstation running Ultrix 4.4
	  or
	- An IBM PC compatible CPU using Linux (either a.out, elf, or
	      glibc-2.1.2 binaries)
	  or
	- A MAC running OS X

	- MIT X-Windows display server (X11R5 or X11R4 or X11R3) 
	  (X11R6 not tested).
	  Note that by the distributed nature of X-Windows, 
	  the X display server can be running on a remote 
          (even non-Sun) hardware. 

	- 8-bit monitor (i.e., not a black and white monitor).
	    or
	- 16-bit monitor
	    or
	- 24-bit monitor

	- Disk Space: approximately 10 Mbytes.


FOR THE INSTALLATION of BINARIES:

We assume you have already received the appropriate Skyview tar file,
(e.g. Skyview_3.6_solaris2.8.binaries.tar.gz).
Copy Skyview_3.6_solaris2.8.binaries.tar.gz to the directory where Skyview 
will be installed (if you haven't already done so):

	cp Skyview_3.6_solaris2.8.binaries.tar.gz /usr/home/joe   (for example)

Then, move to that directory:

	cd /usr/home/joe   

Uncompress and extract the files:

	gunzip Skyview_3.6_solaris2.8.binaries.tar.gz
	tar -xf Skyview_3.6_solaris2.8.binaries.tar

You will now have a directory under /usr/home/joe named "Skyview_3.6". 
Move into it:

	     	cd Skyview_3.6


Now type the Install command using the full pathname to avoid any other Install:

	     	./Install


and answer the questions (hit a carriage return for the default
responses to the questions).

Now edit your .cshrc file to make sure that /usr/home/joe/Skyview_3.6/bin 
(or whatever you decided to call it above) is in your path so you can
access the executables.

Now type the command:

		rehash

(Or you could logout and then log back into the machine.)


DOCUMENTATION:
PostScript versions of The Skyview Users Guide and Skyview Reference
Manual are found in the file Skyview_3.4_DOC.tar.gz, in the same place in
the publicftp area where you retrieved the Skyview software. After you
retrieve it, use the same gunzip and tar commands as with the software to
unpack the documentation.  

The Skyview Users Guide is made up of 5 of the files that come out of this
process: sug1.ps, sug2.ps, sug3.ps, sug4.ps, and sug5.ps.
You will want to print all 5 files to get the entire document.

The Skyview Reference Manual is two files, "refman_cover.ps" and
"refman.ps".  It contains a help page for every function within
Skyview. These help pages are also online within Skyview, and
obtainable by typing the command:

		help name

where "name" is either the name or interactive abbreviation of a 
Skyview function.


A PostScript version of The Skyview Quick Reference comes with the
software.  The Quick Reference is found in the /doc/Qref subdirectory
of the documentation release.  The quick reference is designed to be
printed on 8.5" x 14" paper.  Print the file "side_a.ps" on one side,
then "side_b.ps" on the other.

Once both sides are printed on one sheet of paper, hold the paper so
that the panel with the title, "Hints for skyview Users" in your right
hand (and facing you).  Fold the page in half, inward, even with the
left edge.  Now, the front title panel is on the inside.  Next, fold
each half in half, like wings, so that the title panel is facing
outward on the front  and the panel entitled "MISCELLANEOUS" is on the
back.


IF YOU'D LIKE A DEMONSTRATION:
There is a demo script which will give you an idea of some of the
capabilities of the Skyview image display and analysis functions.  This
is by no means meant to be a complete list, but rather, some of the
most widely used features.  Try it! First, start Skyview simply by typing
in its name.  Then,

		cd Skyview_3.6/demo
		ta grdd.tak

Read along and follow the directions you see on the screen. You will be
running the script, so you will be prompted to hit the Carriage Return
key to continue.  When the demo is over, you can continue using
Skyview, if you wish, or give the command:

		exit

to get out of the program.



TO BUILD SKYVIEW FROM SOURCES:

This procedure is almost identical to the binary installation, but it
is all repeated here for completeness.

We assume you have already received the source Skyview tar file,
(Skyview_3.8_src.tar.gz).
Copy Skyview_3.8_src.tar.gz to the directory where Skyview 
will be installed (if you haven't already done so):

	cp Skyview_3.8_src.tar.gz /usr/home/joe   (for example)

Then, move to that directory:

	cd /usr/home/joe   

Uncompress and extract the files:

	gunzip Skyview_3.8_src.tar.gz
	tar -xf Skyview_3.8_src.tar

You will now have a directory under /usr/home/joe named "Skyview_3.8". 
Move into it:

	cd Skyview_3.8

Now build the executables (this may take a while):

	make dec
(Note:  the Makefiles are tested for solaris, sunos, dec (ultrix), linux,
and mac.
For other operating systems, I suggest using the dec Makefiles, since they
are the most "vanilla", and modifying them to suit your system.)

Now type the command:

	./Install


and answer the questions (hit a carriage return for the default
responses to the questions).

Now edit your .cshrc file to make sure that /usr/home/joe/Skyview_3.6/bin 
(or whatever you decided to call it above) is in your path so you can
access the executables.

Now type the command:

		rehash

(Or you could logout and then log back into the machine.)



If you have any problems, contact us at:
		skyview-help@ipac.caltech.edu
		or
		(626)395-8673

