SAOimage 1.29.3, an image display utility SAOimage (pronounced S-A-0-image) displays astronomical images in the X11 window environment. It was written by Mike Van Hilst at the Smithsonian Astrophysical Observatory (SAO) in 1990 and is now maintained by Doug Mink, also at the SAO. Source code is available in this directory. Compiled executables for Linux, SunOS 4.3.*, Sparc Solaris 2.*, Decstation Ultrix, and Digital Unix on Alpha have been compiled using the compilers distributed with each operating system. The program has been developed on a Sparcstation running Solaris 2.7. The SGI and HP executables are courtesy of Louis Giglio at NASA/Goddard. Most of this code is copyrighted by the Smithsonian Astrophysical Observatory You may do anything you like with these files except remove this copyright. The Smithsonian Astrophysical Observatory makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. Image files can be read directly, or image data may be passed through a named pipe (Unix) or a mailbox (VMS) from IRAF display tasks. SAOimage provides a large selection of options for zooming, panning, scaling, coloring, pixel readback, display blinking, and region specification. User interactions are generally performed with the mouse, but keyboard alternatives are often available. The SAOimage desktop includes, a main image display window, a button menu panel, a display magnifier, a pan and zoom reference image, and a color bar. A color table graph window can be brought up by clicking on the color bar. ONLINE The current version of SAOimage is always available via anonymous ftp from cfa-ftp.harvard.edu in the pub/gsc/SAOimage directory. Online help is available at http://tdc-www.harvard.edu/software/saoimage.html The WCSTools package, which provides additional programs for dealing with image world coordinate systems, is at http://tdc-www.harvard.edu/software/wcstools/ Bugs or problems should be reported to Doug Mink at dmink@cfa.harvard.edu. INSTALLATION To build SAOimage, type make, followed by the name of the architecture/OS which you are using, as chosen from the following table: % make aix # IBM RS/6000 running AIX % make alliant # Alliant FX series % make alpha # DEC Alpha AXP Digital Unix % make apollo # Any Apollo, software floating point % make apollo_68882 # Apollo for MC68882 fp % make apollo_fpa # Apollo for FPA1 % make apollo_prism # Apollo for PRISM architecture (a88k) % make hp # HP-UX % make linux # Intel PC running Linux % make mips # MIPStation running RISCOS % make sgi # SGI Personal Iris running Irix * % make solaris # Sun Sparcstation, Solaris + X11 * % make sun # Sun Sparcstation, SunOS + X11 % make ultrix # DECstation and VAXstation * Switch makefile.sunow and makefile.solow if using Sun OpenWindows. The full "make install" both installs SAOimage in Unix and sets up for communications with IRAF: % make install (or, % make install SAOBINDIR = "/ourown/local/bindir") Partial installs may also be used: % make install_saobin # just install binary (can add SAOBINDIR) % make install_saoman # just install manual page % make install_fifo # just install iraf fifo's % make install_imtoolrc # just install iraf imtoolrc file NOTICE: You can't run the installation targets from the umbrella makefile. You must run the correct makefile. for the workstation you are installing on. For instance, % make -f makefile.dec install Other options: % make manual # make manual.dvi file in doc subdirectory % make clean # clean up object & miscellaneous other files % make tar # make saoimage.tar in CWD % make -s pipe # create tarfile on stdout for piping % make tape # create tarfile on /dev/nrxt8 Make macros (parameters) that can be specified on command line: SAOBINDIR # Destination directory for SAOimage program SAOMANDIR # Destination directory for on-line manpage ARCFILE # Disk archive file name (used with make tar) TAPEDEV # Tape archive device name (used with make tape) RECENT CHANGES March 20, 2001 - Release 1.29.3 (Doug Mink, SAO) Fix minor bugs in WCS subroutines March 8, 2001 - Release 1.29.2 (Doug Mink, SAO) Change WCS selection separator in filenames from : to % February 28, 2001 - Release 1.29.1 (Doug Mink, SAO) Support multiple WCS's ------------------------ September 29, 2000 - Releae 1.28.5 (Doug Mink, SAO) Fix bug which caused Segmentation Faults at some zoom levels with large images. Set FITS WCS if any CD matrix terms are in header; set rest to zero. Read fITS keyword values even if no equal sign is present August 1, 2000 - Release 1.28.3 (Doug Mink, SAO) Improve handling of 1-D WCS data. Fix numerous warning-generating bugs. June 13, 2000 - Release 1.28.2 (Doug Mink, SAO) If imh pixel file has no directory, *always* use same as header file June 9, 2000 - Release 1.28.1 (Doug Mink, SAO) Read keyword values in hget.c even if no equal sign is present. June 2, 2000 - Release 1.28.0 (Doug Mink, SAO) Only a few minor changes due to running lint on everything ------------------------ May 10, 2000 - Release 1.27.4 (Doug Mink, SAO) In wcstype(), default to WCS_LIN, not error (after Bill Joye) May 1, 2000 - Release 1.27.3 (Doug Mink, SAO) Pixel files whcih are in subdirectories of files where IRAF .imh header files reside are now dealt with correctly. All dates in the old FITS format (dd/mm/yy) where the year ranges from 0 to 999 have 1900 added to them: 01/05/100 becomes 2000-05-01. March 27, 2000 - Release 1.27.2 (Doug Mink, SAO) Fix bug reading IRAF .imh files with pathnames longer than 67 characters. Fix bug precessing coordinates which were at equinoxes other than J2000 or B1950. February 3, 2000 - Release 1.27.0 (Doug Mink, SAO) Upgrade WCS code to Mark Calabretta's WCSLIB 2.5 Add support for modified Julian date to dateutil.c