About
-----

This software package contains the multiple fibre autoguider/acquisition tool for fibre instruments.
Initially this is for use with the AF2 instrument.


Dependencies
------------

Build-time dependencies
None.


Run-time dependencies
This package requires the following ICS packages to be installed:

IDL			CORBA stubs for software with CORBA interfaces
AF2			The AF2 software package
OCSCORBADRAMAINTERFACE	The interface between CORBA and the TCS DRAMA interface
XPA			The interface to the ds9 display tool (for libxpa.so)
SDSUAUTOGUIDER		The SDSU autoguider package (for libauto_centroid.so)


The following Python packages are also required to be installed:

omniORB			The Python CORBA ORB.
numpy			Scientific computing package for Python.
scipy			Scientific computing package for Python.
pg			The Python postgresql package.
pyserial		The serial interface package.
pyfits			The interface to FITS formatted files. (Release >= 3.1.1)
python-imaging-tk	The Python image processing library (for Fedora 11)
python-pillow		The Python image processing library (for Fedora 19)
ttk			Tk themed widget set.

For Ubuntu 14.04 LTS 64-bit, the required Python packages can be installed from the apt repositories using the apt-get install command:

apt-get install python-tk python-numpy python-scipy python-serial python-pyfits python-pil python-pil.imagetk


Build Instructions
------------------

1. Execute make from the top level directory.


Install Instructions
--------------------

1. cd to the dist directory.
2. Get a package release number from OSCAR for the FIBREGUIDER software package.
3. Perform an OSCAR packageRelease using the following command:

   packageRelease -package FIBREGUIDER -copydirectory -releaseno <your release number>

4. Copy the fibreguider configuration file to the /wht/etc directory. From the top level project directory:

   cp -p src/fibreguider.cfg /wht/etc


Richard Bassom

[02-Mar-2015]

