README25
>>> -------------------------------------------------------------------- <<<
>>>                    PROS 2.5 Installation				 <<<
>>>                                                                      <<<
>>>    NOTE:   Use the README.ftp directions to retrieve the             <<<
>>>            PROS 2.5 distribution, and then return here.              <<<
>>>                                                                      <<<
>>>    REQUIRED:   							 <<<
>>>	       IRAF 2.11 (2.10 non-SUN) 			         <<<
>>>	       TABLES 2.0 or higher					 <<<
>>>	       CTIO Feb 1994 version					 <<<
>>> -------------------------------------------------------------------- <<<

This version of PROS includes full support for Solaris platforms.
The binary executables are available for both SunOS aned Solaris.

(The usage of <...> indicates user-supplied variable)
    
I.  Define the XRAY package under IRAF

    First do the following to define the XRAY package under IRAF:
    (as user "iraf")

    edit  $iraf/unix/hlib/extern.pkg and add the following lines using the
    path to the XRAY parent directory in place of :

      reset xrayroot  = //
      reset xray      = //xray/
      task  xray.pkg  = xray$xray.cl

    To include XRAY in the help search path, add:

       ,xray$lib/helpdb.mip\

    to the list of helpdb locations at the bottom of the extern.pkg file. 

    Skip to Section III.

II. Remove the previous PROS version  

    Unix-family:
        > cd 
        > rm -rf xray

    VMS:
        > set def 
        > delete [.xray...]*.*;*
          (repeat above delete command until all files and subdirectories 
           under xray have been deleted)

** Note **
 If any of the rtar commands below give errors, please use instead:
 so> !tar -xf / 

III. Install the machine-independent source code

        > cl
        cl> softools 
        so> cd xrayroot$
	so> rtar -xf /xsrc_gen.tar

     VMS only:
        so> mkdir xray$bin

IV.  Install the machine-dependent executables and support files
     (do either part A OR part B)

    A.  Binary installation for sun4 or sun5:

        Install the executables:
          so> rtar -xf /xbin_sos4.tar  (for sun4)
          so> rtar -xf /xbin_ssol.tar  (for sun5)

        Install the support files: 
	  so> rtar -xf /xdata_sos_gen.tar		
          so> rtar -xf /edemo_sos_gen.tar

        Proceed to part V. 

    B.  Non-binary installation (non-sun):

	Untar support files:
          so> rtar -xf /proscal_gen.tar
          so> rtar -xf /rosfits_gen.tar
	  so> rtar -xf /einfits_gen.tar

        Compile executables:

          so> xray
	  xr> cd xray$

          Unix-family only:
          xr> mkpkg 	   (arch: i386, f68881, ffpa, fswitch, fsoft, 
				    pg, ddec, dmip, rs6000, mips, irix, f2c, 
			            sparc, ssun, alpha, linux, generic)
            (expected output:)
            delete any dreg .e files left lying about in the source directories
            archive and delete generic objects
            restore archived  objects
            no object archive found; full sysgen will be needed
            
          All:
          xr> mkpkg -p xray >& spool &

          Unix-family only:
          xr> mkpkg summary > spool.sum

        Check the spool.sum file for any compilation errors.

        Install calibration files:
          xr> xinstall

          xi> cd xrayroot$proscal 

          xi> fits2spat            # install new calibration files
            (** Please ignore "OPEX Warning: bad attribute name `time'" **)
          xi> fits2bin             # install new spectral calibration files
          xi> drep2cal             # install more spectral and spatial files
          xi> fits2ephem           # install new xtiming calibration files
          xi> fits2ein             # Einstein cdrom lookup tables
        
	Install optional sample data files used by xdemo:
          xi> cd xdata
          xi> unlearn strfits      # tables 2.0 has new parameters
          xi> fits2snr		   # install xdemo files

        Install optional sample RDF data files 
          xi> cd xdata
          xi> unlearn strfits      # tables 2.0 has new parameters
          xi> rp_fits2pros         # install PSPC RDF (v2.5) sample data
          xi> rh_fits2pros         # install HRI RDF (v2.5) sample data

        Install optional Einstein demo data files
        (if einfits_gen.tar loaded above):

          xr> xinstall
          xi> cd xrayroot$einfits
          xi> fits2edemo

        When this has been completed, the proscal, einfits and rosfits
        directories may be deleted.

 
V.  Install the optional Point Response Function (PRF) observation data files
    (Approx. 40 Mb after installation)

    (EITHER part A OR part B)

    A.	Binary installation for sos4 or ssol

          xr> cd xrayroot$
          xr> rtar -xf /xcalr_sos_gen.tar
          xr> rtar -xf /xcale_sos_gen.tar

    B.  Non-binary installation (non-sos4 and non-ssol):

 	  xr> cd xrayroot$
          xr> rtar -xf /xrcalfits_gen.tar
          xr> rtar -xf /xecalfits_gen.tar

          xr> xinstall
          xi> cd xrcal$
          xi> set in_rhcal = "/roscalfits/"
          xi> set in_rpcal = "/roscalfits/"
          xi> calr_fits2qp

          xi> cd xecal$
          xi> set in_ecal = "/eincalfits/"
          xi> cale_fits2qp
	    (** Please ignore "OPEX Warning: bad attribute name `time'" **)


	When this has been completed, the roscalfits and eincalfits
        directories may be deleted.


VI.  Configure for local system if Einstein CD-ROMS are present

          xr> cd xray$lib
          xr> ed zzsetenv.def

        Note there are several lines at the end of this file,  
        that define the variables needed to access the Einstein
        CD-ROM data automatically from the EINCDROM package.
        These lines need to be defined to point to the local device
        names for the available CD-ROMS.
        
          xr> bye
          cl> xray                      # reload X-RAY package to pick
                                        # new Einstein CDROM definitions

VII. Testing the XRAY Installation

    Once XRAY has been installed, some of the basic functions of XRAY 
    as well as a few of the device-dependent tasks (e.g. plotting) 
    should probably be exercised.  When testing device-dependent things 
    such as plotting and image display, be sure that the IRAF environment 
    variables that point to the device(s) are correct (e.g. stdgraph, 
    stdimage).

      cl> xray
      xr> cd 
      xr> xdemo

    You may type one of the xdemo menu options.  Spatialdemo, 
    spectraldemo, and timingdemo require an imtool display window,
    gspectral and gtiming do not. 


    ** We recommend sending /Release.Notes to your Users    **
    ** when announcing this release.                                **

-------------------------------------------------------------------------------
EINDATADEMO NOTE:

Optional: 1 screened and 1 unscreened IPC event list (~6 meg),
         have been included in this release to demonstrate the usage
         of data from the Einstein CD-ROMS.  This data need only be
         loaded if your site runs Einstein analysis packages in PROS
         and you're interested in seeing this demo.
-------------------------------------------------------------------------------