Appendix D: Installing and configuring the PHT Interactive Analysis System
The purpose of this chapter is to explain the details of the installation
of the PHT Interactive Analysis software on UNIX and to give guidelines
for individual configuration.
The PHT Interactive Analysis requires from PIAV8.0 at least IDL version
5.0 (works also under IDL 5.1 and 5.2). The IDL Astronomy Library has not
necessarily to be installed on your system, since the routines used by
PIA are ALL compiled together under the distributed savefile. The PHT Interactive
Analysis is fully supported under the operating systems: Sun Solaris Version
2.X and DEC Unix (VMS is not further supported). As PIA does only use pure
IDL code it is also possible to run it under other UNIX versions (Linux,
[Users with an IDL runtime license can use PIA as a standalone package
(without the IDL environment). The installation has to be performed in
the same manner, but an extra package has to be installed. Please see the
for details. ]
The distributed tarfile contains the full PIA installation file system,
composed of a central directory and several subdirectories. The installation
can be done on an individual account or also systemwide. In the latter
case the individual users should copy two files from the installation to
their own file systems and change them as specified below.
The central directory contains the following files:
PIA: A UNIX shell script defining the main PIA location and all
environment variables (UNIX) needed for setting all the necessary paths,
and for starting the PIA package. The environment variables / logical names
are divided into a system wide part (localization of the executable file,
calibration files directories, etc), and an individual user part (data,
print and save directories) which can be redefined by each user (s. pia_envi
/ pia_logdef.com). Some of these last directories require write
Please NOTE that VMS is not further supported. The distribution
of a VMS command file PIA.COM does not imply that PIA has been tested under
VMS but is only to give the possibility of using it at the user's own (high)
pia_envi (UNIX) and pia_logdef.com (VMS): example for user
PIA environment variables / logicals setting.
ia_init_sysv.pro: it contains the main IDL initialisation of system
variables according to PIA(.com).
pia_start.scr: the IDL startfile for running PIA. Only the default
printer definition given here should be changed individually by users.
pia_export.sav (or pia_export_IDL5.1.sav in the IDL5.1/5.2 version):
the PIA executable file. No need to be copied to individual users.
and following subdirectories:
calg: all the official PHT-Cal G files containing the calibration parameters
used by the data reduction.
calg_not_off: alternative PHT-Cal G files, which are not officially approved.
calu: all the official PHT-Cal U files used for uplinking commands derivation.
Not used by the data reduction.
html: the central directory for the html structure, containing all the
hypertext help files, images, etc.
help: the IDL help directories containing information on every PIA routine,
accessible under the IDL "old" help system ('widget_olh').
incl: all the include files containing common block definitions as used
in PIA. They allow direct access from IDL to all the internal PIA buffers.
support: several routines from the IDL astronomical library as used by
We divide the installation into a system wide and an individual configuration.
It has to be understood that for a 'purely' individual configuration both
installation steps have to be followed (while a couple of actions in the
second one can be avoided)
System wide installation
uncompress (if necessary) pia_fexp.tar.gz
untar ('tar xvf pia_fexp.tar') the tarfile from a filesystem created for
if the ISO products (FITS files) have to be accessed by several users,
create a directory for them.
changing the line giving the main PIA directory in the file PIA
IS NOT necessary anymore from V8.0 on.
(optional) define an alias systemwide / logical PIA
Individual configuration (optional)
After the system-wide installation, PIA is prepared to be used by every
user without his/her intervention. After starting, it is possible via
an interactive menu
to define locations for datafiles, savefiles, printfiles,
However, if you want to have user-defined places for data, save and
printfiles from the very beginning of your session, you can create a PIA
directory to place a file giving all the addresses you might redefine for
running PIA. The general command file will run this cshell script / command
file if it is found. The default places in which it will look for it are
under your start directory
under your root directory/pia (root directory:[.pia] for VMS).
By defining an environment variable / logical PIA_LOC_IND you can place
a special directory to be looked for wherever you want. Follow the next
steps if you want to start PIA with your own definitions (for every definition
you can make the default place is included, according to the system wide
create a 'PIA directory' (default your root/pia), a 'print directory' and
a 'save' directory -
copy from the general installation to the your individual PIA directory
the file pia_envi (UNIX)/ pia_logdef.com (VMS)
change the file setting the variables PIA_PRINT, PIA_SAVE to the print
and save directories. If you are going to manage yourself FITS files containing
products, change the variable FITDIR to the directory you are going to
Default: the place from which you send the command PIA for all three
is used for PIA_PRINT.
put under the printer variable PIA_PRINTER your favourite printer (should
be at least black/white Postscript capable).
Default: $PRINTER (UNIX), SYS$PRINT (VMS).
change the environment variable / logical W3NET to your favourite html
History of this Section: