home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / xfitsvew.zip / XFITSview / README < prev    next >
Text File  |  1996-01-15  |  4KB  |  75 lines
  1.                           XFITSview
  2. -----------------------------------------------------------------------
  3.   Copyright (C) 1996
  4.   Associated Universities, Inc. Washington DC, USA.
  5.   This program is free software; you can redistribute it and/or
  6.   modify it under the terms of the GNU General Public License as
  7.   published by the Free Software Foundation; either version 2 of
  8.   the License, or (at your option) any later version.
  9.  
  10.   This program is distributed in the hope that it will be useful,
  11.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13.   GNU General Public License for more details.
  14.  
  15.   Correspondence concerning XFITSview should be addressed as follows:
  16.          Internet email: bcotton@nrao.edu.
  17.          Postal address: William Cotton
  18.                          National Radio Astronomy Observatory
  19.                          520 Edgemont Road
  20.                          Charlottesville, VA 22903-2475 USA
  21. -----------------------------------------------------------------------*/
  22.  
  23.    XFITSview is a viewer for FITS format images for unix/X-Windows
  24. systems.  XFITSview will display images allowing zooming, scrolling,
  25. modifying the brightness, contrast and color and allow determination
  26. of celestial positions in the image.  Positions and brightnesses of
  27. selected pixels may be logged to a text file.  Specified positions in
  28. the image may be marked.  Images may be compared by "blinking" them
  29. and 3 dimensional images may be viewed in the form of a movie.  The
  30. program contains extensive online documentation.  Blanked pixels and
  31. all defined FITS image data types are supported.  Normal or gzip
  32. compressed files may be used.
  33.  
  34.  Installation
  35.  ------------
  36.    
  37.     Installation of XFITSview requires an ansi c compiler and the
  38. Motif package of software for the X-Windows system (not included in
  39. this distribution).  After expanding the tar archive change to
  40. directory XFITSview.  The make file "Makefile" may need to be modified
  41. to give the particulars of your system.  The name of the c compiler
  42. and the locations of the X-Windows and Motif include and library
  43. directories must be supplied.  In addition, the variable BYTSORD gives
  44. the byte order of the machines for which you are building the
  45. executable.  A value of "big" is appropriate for "big endian"
  46. machines, e.g. (Sun, IBM RS/6000, SGI, HP).  A value of "little" is
  47. appropriate for "little endian" byte ordering (Linux, Dec Alpha).
  48.  
  49.    After making any necessary modifications to the Makefile type make
  50. (or gmake) to build the executable.  When this procedure completes,
  51. copy the executable (XFITSview) to the directory in which it is to be
  52. installed. The XFITSview directory structure may be removed after
  53. successfully building and installing XFITSview.  XFITSview contains
  54. online documentation; a text version of this documentation is in the
  55. file XFITSview.hlp.
  56.  
  57. Trouble shooting notes:
  58. 1) If XFITSview appears to build and run except that the displayed
  59. image appears to be random noise, check that BYTEORD in the make file
  60. is set correctly.  To rebuild, first clear the old installation by
  61. % make clobber
  62. and then type "make" to rebuild.
  63.  
  64.      Questions and comments should be directed to Bill Cotton
  65. at the National Radio Astronomy Observatory (bcotton@nrao.edu).
  66.  
  67. Usage
  68. -----
  69.  
  70.    XFITSview may be started with the name of a FITS format file as a
  71. command line argument.  Either the initial or subsequent files may be
  72. selected using the "Open" item in the "File" menu.  Consult the "Help
  73. Me" item in the "Help" menu for further details.  Each menu column has
  74. a separate help item.
  75.