INSTALLATION

Date of latest modification: Oct 26, 1998

The package can be retrieved via ftp in the form of a (Gnu-zipped) compressed tar-file wfc_full-105.108.tar.gz. The anonymous ftp site is: ftp.asdc.asi.it, directory /pub/sax/software/wfc. (Get the software by clicking here)

First installation

is done as follows - consult also the specific release note which comes with the distribution - :

1> mkdir /yourchoice_dir

2> cd /yourchoice_dir

3> ftp ftp.asdc.asi.it

ftp> username: anonymous
ftp> password: your_email_address
ftp> bin
ftp> cd pub/sax/software/wfc
ftp> get wfc_full-105.108.tar.gz
ftp> dir
ftp> (... get the other files ... )
ftp> quit

4> gzip -d wfc_full-105.108.tar.gz or gunzip wfc_full-105.108.tar.gz

5> tar xvf wfc_full-105.108.tar

6> Edit the configure file to reflect your system (location of libraries, compilers, switches, etc). It is done automatically for HP and DEC Alpha machines. For ULTRIX only Stage2 is supported. To use wopi, pgplot should be installed on the system.

7> ./configure

8> make (For ULTRIX: make stage2)

UPDATES

1> Get the gnuzipped tarfile
2> In the main directory (where this README is) do: ./update wfc_full-105.108
(However, read the release notes)
3> make clean, or make clean1, or make clean2
4> make [stage1|stage2|]
The software is developed on a HP9000/735 running HP-UX and is almost entirely written in standard ANSI-C. (Non-ANSI is, e.g., the use of float versions of math routines, like sqrtf and expf).
SRON tries to assure portability of the software to other systems (VMS, ULTRIX, OSF) but cannot guarantee full support for this version. Most productfiles (there are also some asci files) are in standard FITS format so they can be handled and displayed by many programs, e.g., SAOimage.
The user interface is modelled after a HEASARC ftools (rev2.7) distribution, emulating the IRAF parameter interface for standalone programs.
Each program comes with its own parameter file (progname.par), listing the required parameters and the attributes, like default values and limits on the range. These .par files must be writable for the user, so you will need a personal copy of the files. An environment variable $PFILES points to the directory containing these parameter files.

NOTE!!

This version assumes that the parameterfile is set, i.e., all parameters are assigned the correct values on beforehand. The user is NOT PROMPTED, nor does the version allow you to pass parameter values for a program on the commandline so that any arguments are silently ignored.

Alternatively, if the StageII programs are invoked with a switch '-p' as their first argument, all parameters are taken from the commandline.

During the installation, the files describing the WFC are automatically created in the directory set by the environment variable $WFC_CAL.

This directory now contains:

wfc.msk : a FITS file, containing the (16-bit int) image of the mask
and for each Wide Field Camera (example given for wfc1):
wfc1.det: contains a number of detector parameters in FITS keywords and extensions enumerating properties of the detector support structure, the calibration sources and the energy-channel boundaries
(this file was generated from /yourchoice_dir/cal/det_wfc1.asc by genFits in the make procedure.)
wfc1.ins: contains 3 FITS extensions, i.e.,
- WFCbinmask - a float (possibly binned) version of the mask
- WFCdftmask - the discrete Fourier transform of the mask
- WFCcf - effective area correction factors for the instrument

Response matrices

Response matrices can be retrieved by anonymous ftp from the directory /pub/sax/cal/responses/97_1/wfc. These matrices are supplied:

- for each camera, i.e. wfc1 and wfc2,

- for spectra derived from correlated or from uncorrelated images,

- in ascii and ogip format.

For the 104-107 software release two improved response matrices were supplied for spectra made with correlated images, e.g.,

wfc1_iros_dec97.rmf and wfc2_iros_dec97.rmf,

at the anonymous ftp site (ftp.asdc.asi.it in directory /pub/sax/cal/responses/97_9).