------------------------------------------------------------------------------- See the COPYRIGHT file, which is required to be in this directory ------------------------------------------------------------------------------- This file contains a brief description on installing HAMSCATT. Overview of installations and running: 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 'mydata$' 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 ################################################ # INSTALLATION INSTRUCTIONS ################################################ # STEP 1: # (a) 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: # (a) build the 'libslatec.a' object library # (b) move the library to the hamscatt code directory # (c) "touch" the file 'libslatec.a' ./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 # (a) enter IRAF to define 'apmap' package # for the following: it is assumed that the hamscatt # codes live 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 # (a) build HAMSCATT # (b) 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 INSTRUCTIONS ################################################ # STEP 1 # (a) go to the data directory # for the following: it is assumed that your data live in # 'mydata$' cl> cd mydata$ # STEP 2 # (a) 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 # STEP 3 # (a) contsruct an input file for HAMSCATT # see the example directory for default settings # for the input file 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) # STEP 4 # (a) 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 ------------------------------------------------------------------------------- HAMSCATT written at the University of California, Santa Cruz under the auspices of the Board of Astronomy and Astrophysics while Churchill was a graduate student. His current Contact Information is: Chris Churchill Department of Astronomy New Mexico State University email: cwc[at]nmsu[dot]edu -------------------------------------------------------------------------------