Installation of the ICE ccdacq package -------------------------------------- The IRAF Control Environment (ICE) ccdacq package supports CCD data acquisition from within the IRAF environment. Note that unlike most IRAF software ICE by its nature must contain significant system and hardware dependent code to talk to the CCD controller and the instrument and telescope control software. The precise means that ICE uses to communicate with these systems is very configurable within a client-server framework. In general, ICE is developmental software that has greater external dependencies than normal IRAF packages. The method you use to copy the file (or remotely access the tar file) is OS dependent and is not discussed in this document. A separate tar file contains precompiled SunOS 4.1.3 binaries. Steward observatory uses ccdacq on the Sparc Solaris platform and precompiled binaries may be available from Steward for Solaris. Note that the ice.tar.Z file contains the KPNO obsinit utility in the startup directory in addition to the ccdacq package itself. Obsinit is responsible for deleting the previous observer's data at the start of each observing run as well as for restoring the configuration files for the KPNO Sun/X windows observing environment. If you wish to use this utility, you will need to define the parameters of your own observing environment and then modify the obsinit script and the contents of the startup directory tree to match these parameters. If you have any questions, please contact the IRAF group at iraf@noao.edu or 602-323-4160. [1] The package is distributed as a compressed tar archive; IRAF is distributed with a tar reader. The tar archive may be obtained by magnetic tape or anonymous ftp. For magnetic tape go to step [2] and when reading the tar archive simply mount the tape and use the tape device name for the archive name in step [4]. To obtain the package via ftp (assuming a UNIX computer): % ftp 140.252.1.1 login: anonymous password: [your last name] ftp> cd iraf/extern ftp> get ice.readme ftp> binary ftp> get ice.tar.Z ftp> get ice-bin.sparc.Z ftp> quit % ls -l *ice* -rw-r--r-- 1 seaman 741073 Jul 26 14:55 ice-bin.sparc.Z -rw-r--r-- 1 seaman 5614 Jul 26 15:12 ice.readme -rw-r--r-- 1 seaman 624949 Jul 26 14:55 ice.tar.Z % uncompress ice.tar.Z % uncompress ice-bin.sparc.Z The readme.ice file contains these instructions. [2] Create a directory to contain the ICE external package files. This directory should be outside the IRAF directory tree and must be owned by the IRAF account. In the following examples, this root directory is named /usr/iraf/extern/ice/. Make the appropriate file name substitutions for your site. [3] Log in as IRAF and edit the extern.pkg file in the hlib directory to define the package to the CL. From the IRAF account, outside the CL, you can move to this directory with the commands: % cd $hlib Define the environment variable ccdacq to be the pathname to the ccdacq root directory. UNIX pathnames must be terminated with a '/'. Edit extern.pkg to include: reset ccdacq = /usr/iraf/extern/ice/ccdacq/ task ccdacq.pkg = ccdacq$ccdacq.cl Near the end of the hlib$extern.pkg file, update the definition of helpdb so it includes the ice help database, copying the syntax already used in the string. Add this line before the line containing a closing quote: ,ccdacq$lib/helpdb.mip\ [4] Log into the CL from the IRAF account and unpack the archive file. Change directories to the ICE root directory created above and use 'rtar': cl> cd /usr/iraf/extern/ice cl> softools so> rtar -xrf where is the host name of the archive file or the IRAF tape device for tape distributions. UNIX sites should leave the symbolic link 'bin' in the ICE root directory pointing to 'bin.generic' but can delete any of the bin.`mach' directories that won't be used. The archive file can be deleted once the package has been successfully installed. [5] When the archive has been unpacked, unpack or build the ICE package executable. To unpack the SunOS sparc executables: cl> cd ccdacq$bin.sparc cl> softools so> rtar -xrf where is the host name of the ice-bin.sparc archive file or the IRAF tape device for tape distributions. Alternatively, the compilation and linking of the ICE package is done using the following commands: cl> cd ccdacq cl> mkpkg arch system is configured for generic cl> mkpkg sparc delete any dreg .e files left lying about in the source directories archive and delete generic objects restore archived sparc objects cl> mkpkg -p ccdacq >& ccdacq.spool & % mkpkg generic delete any dreg .e files left lying about in the source directories archive and delete sparc objects compress bin.sparc/OBJS.arc [1] 5560 NOTE: On systems that concurrently support different architectures (e.g., Suns, Convex), you must configure the system for the desired architecture before issuing the above command. SUN/IRAF sites must execute 'mkpkg arch' commands for each supported architecture type. The Unix environment variable IRAFARCH must be set as well before compiling. For example: % setenv IRAFARCH sparc The spool file should be reviewed upon completion to make sure there were no errors.