------------------------------------------------------------------------------- See the COPYRIGHT file, which is required to be in this directory ------------------------------------------------------------------------------- This file contains a brief description on installing HAMSCATT. In the very near future, we will provide a cl script to run all steps and hopefully a script to install the entire package. The steps for installing and running are as follows: install steps: 1) build apmap package 2) build libslatec.a, move it to the code directory and "touch" it 3) enter IRAF - define apmap package (here we assume the data live in data$ and the HAMSCATT code lives in hamscatt$) 4) build HAMSCATT run steps: 1) run apmap task to obtain ASCII file of aperture tracings; this step requires an input image that has been processed through apextract wth a created database of aperture locations and tracings; redirect the output to a file; this file is referred to as the "xmaxfile" 2) create HAMSCATT input file; see the directions and required contents of this file below; this file contains I/O directions and HAMSCATT option flags; example files are avialable in the examples/ directory 3) execute HAMSCATT; output is a background illumination image; the pixel image will live in the same directory as the ".imh" file; an imrename will move it to the pixel directory ------------------------------------------------------------------------------- Below is an commented script, detailing the steps to install HAMSCATT INSTALL Script started on Thu Oct 13 12:22:58 1994 ################################################ INSTALL ################################################ ################################# # STEP 1 ###### build apmap package ###### # the warning messages may be # ignored ################################# ./hamscatt :> cd apmap ./hamscatt/apmap :> mkpkg Warning, hlib$mkpkg.inc line 5: macro `IRAFARCH' not found xc -c -/libmil t_apmap.x t_apmap.x: sys_runtask: t_apmap: ap_dbread: ap_alloc: ap_free: t_apmap.f: sysruk: tapmap: "t_apmap.f", line 142: Warning: local variable "order" never used apdbrd: apallc: apfree: xc -/Bstatic t_apmap.o -lxtools -lcurfit -lgsurfit -o x_apmap.e ############################### # STEP 2 ###### build libslatec.a ###### # move the library to the # hamscatt code directory # and "touch" it ############################### ./hamscatt/apmap :> cd ../slatec ./hamscatt/slatec :> make ... ./hamscatt/slatec :> mv libslatec.a ../hamscatt/libslatec.a ./hamscatt/slatec :> cd ../hamscatt ./hamscatt/hamscatt :> ranlib -t libslatec.a ################################################################## # STEP 3 ###### enter IRAF to define apmap package ######################## # it is assumed that your data live in data$ # and that HAMSCATT lives in hamscatt$ ################################################################## /u/cwc :> cd IRAF /u/cwc/IRAF :> cl setting terminal type to xtermjh... NOAO SUN/IRAF Revision 2.10.2EXPORT Tue Nov 17 19:44:29 MST 1992 This is the EXPORT version of Sun/IRAF V2.10.2 for SunOS-4.1. Welcome to IRAF. To list the available commands, type ? or ??. To get detailed information about a command, type `help command'. To run a command or load a package, type its name. Type `bye' to exit a package, or `logout' to get out of the CL. Type `news' to find out what is new in the version of the system you are using. The following commands or packages are currently defined: aprops focas. lists. obsolete. spptools. ctio. ftools. local. plot. stsdas. dataio. images. mtools. proto. system. dbms. language. newimcombine rvsao. tables. demos lick. noao. softools. utilities. cl> # define apmap, it would be nice to place this in your loginuser.cl cl> task apmap = hamscatt$apmap/x_apmap.e # show that apmap is now a defined task (package) cl> ? apmap focas. local. proto. tables. aprops ftools. mtools. rvsao. utilities. ctio. images. newimcombine softools. dataio. language. noao. spptools. dbms. lick. obsolete. stsdas. demos lists. plot. system. ############################ # STEP 4 ###### build HAMSCATT ###### # compile and link hamscatt ############################ cl> cd hamscatt$ cl> fc hamscatt.f -limfort libslatec.a hamscatt.f: MAIN hamscatt: initsol: fcn: poly: gridim: inputdeck: ordermap: inform: output: inputimag: outputimag: alarm: linlsf: lsfsolve: lsffunc: mask: checks: scatsurf: fitstats: link: ############################## ###### we are now built ###### ############################## ################################################ RUNNING ################################################ ###### go to the data directory cl> cd mydata$ ###### run apmap, redirect output to the "xmaxfile" ###### see the example directory for a typical xmaxfile cl> apmap image=myimage step=1. databas=database > myimage.map ###### contsruct an input file for HAMSCATT ###### see the example directory for a default setting ###### outline of input file follows with data type given: myinmage.inp data types -------------------- ------------------ myimage myimage.bk string string xmaxfile norders string integer xorder yorder gamma integer integer real readnoise gain real real reject toler real real minflag corrflag logical logical parameter = meaning default* inimage = IRAF image to be background corrected myimage outimage = IRAF background surface myimage.bk xmaxfile = the file containing the output of APMAP myimage.map norders = the number of orders in inimage 89 xorder = the polynomial order of the x terms (XD) 8 yorder = the polynomial order of the y terms 3 gamma = the profile power law scaling 1 rdnoise = the system read noise [e-] your dewar gain = the system gain [DN/e-] your dewar reject = the sigma rejection factor 3 toler = the convergence tolerence for the fit 1.e-8 minflag = (logical) flag for grid optimization .true. corrflag = (logical) flag for local term correction .true. minflag turns on/off the interorder fitting for x_min and partial pixel weighting of F(xmax), F(xmin) corrflag turns on/off the local term in the output background surface it is automatically turned off for gamma=0, which is global only fit * defaults for a hot star windowed to 1600 rows file is list direct read; for details see comments in hamscatt.f routine inputdeck (io.f) ###### ###### run HAMSCATT ###### see the example directory for output message example cl> !hamscatt.e HAMSCATT: Enter Input Deck Filename : myimage.inp <...HAMSCATT output follows...> ###### ###### on successful completion, you will have a background image ###### script done on Thu Oct 13 12:48:39 1994 ------------------------------------------------------------------------------- Contact: Christopher W. Churchill Board of Astronomy and Astrophysics University of California, Santa Cruz email: cwc@lick.ucsc.edu -------------------------------------------------------------------------------