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.
-------------------------------------------------------------------------------