From johng Fri Jan 28 17:58:59 2000
Received: from puako.keck.hawaii.edu (puako.keck.hawaii.edu [128.171.96.132])
	by keck.hawaii.edu (8.8.8+Sun/8.8.8) with ESMTP id RAA27237;
	Fri, 28 Jan 2000 17:58:58 -1000 (HST)
Received: by puako.keck.hawaii.edu (8.8.8+Sun/SMI-4.1)
	id RAA22559; Fri, 28 Jan 2000 17:58:57 -1000 (HST)
Date: Fri, 28 Jan 2000 17:58:57 -1000 (HST)
From: johng (John Gathright)
Message-Id: <200001290358.RAA22559@puako.keck.hawaii.edu>
To: ahoney, echock, lai@cfht.hawaii.edu, larkin@astro.ucla.edu,
        weiss@astro.ucla.edu
Subject: NIRSPEC's multiconfiguration quicklook tool in CVS
Cc: aconrad, johng, tbida
Content-Length: 4044
X-Lines: 107
Status: RO


Lady and Gentlemen,

I have rounded-up the IDL code that Jason Weiss, Olivier Lai,
and I have been working with for the past few months and put
it under CVS control.  This is the version being modified for
"multiconfiguration use", with integrated AO support, as imple-
mented so far.  As we discussed, if at all possible, we are
planning to test this version in the upcoming AO-NIRSPEC run
in mid-February.  Here are a few comments on the CVSed sources.


1) I added 2 directories to the headquaters Repository

  /usr/local/cvsroot/kroot/kss/nirspec/ui

"qlook_multiconfig" and "idllib".  The "idllib" directory
I copied as is from waimea:/kroot/kss/nirspec/ui/idllib; this
is operational code, from a summit machine, but it has not
been previously placed under CVS control.

[N.B.  Jason, the tar file that Olivier and I have been working
with included an "idllib" directory whose CVS entries were included.
These indicated that this directory actually came from the nirc2
source tree.  The only file from idllib that I could tell was
required was "kidl.pro".  In any case, as mentioned above, I have
taken the idllib from the nirspec operational code, for inclusion
in this nirspec CVS repository -- just so you are aware of this.]


2) For convenience, I have defined a CVS module "ns_qlook" which
refers to "/usr/local/cvsroot/kroot/kss/nirspec/ui".  This means,
for example, you can use the following cvs command

  cvs checkout ns_qlook

to get the "qlook_multiconfig" and "idllib" directories and their
contents reproduced in you current directory.


3) I have added these comments to ".../qlook_multiconfig/startup.pro"
;
; Before running the NIRSPEC QuickLook tool, an appropriate
; IDL_PATH environment variable must be defined.  As currently
; set up, this path MUST include the location of
;
;    the ASTRO package's "fits" and "misc" directories
;    the main QuickLook directory
;    QuickLook's "reduce" and "strehl" directories
;    NIRSPEC's idllib directory
;
; The following illustrates the settings, but are unlikely to
; work for any particular user
;
;    setenv IDL_DIR        /sol/apps/idl_52/idl_5.2
;    setenv NS_QLOOK_DIR   /kroot/kss/nirspec/ui/qlook_multiconfig
;    setenv NIRSPEC_IDLDIR /kroot/kss/nirspec/ui/idllib
;    setenv ASTRO_IDLDIR   /kroot/idl/astro/pro
;    setenv IDL_PATH       \+$IDL_DIR/lib:\+$ASTRO_IDLDIR/misc:\+$ASTRO_IDLDIR/f
its:\$NS_QLOOK_DIR/:\+$NS_QLOOK_DIR/reduce:\+$NS_QLOOK_DIR/strehl:\+$NIRSPEC_IDL
DIR
;

There is a README file in the same directory that probably needs
to be updated, and you may wish to include this kind of initiali-
zation information.


4) There are some sample FITS files -- images and calibrations --
included with this release, to allow a new user to quickly determine
if the software is working properly.  If the intention is to dis-
tribute this to "outsiders," then some documentation will be
necessary.

Concerning the included images and calibrations, we ought to put to-
gether a set of such (and they may not be the same ones appropriate
for a "new user demo") that we could use internally for validation
of new software.


5) I will make a "tarball" with everything (including the ASTRO
package) required to actually run the Quicklook tool, to make it
easier for the masses -- those poor souls lacking a kroot tree --
to take a look at the product.  See 4) above.


6) I included Olivier's "flat.pro" in the ".../qlook_multiconfig/reduce"
directory, even though it is not (yet) actually used anywhere.


7) Finally, Jason, could I you to verify that Olivier's files (the
ones he mailed out Wednesday afternoon) are really the same as the
ones you have from before.  I don't have an independent version
against which to make this comparison.  The files were

  calc_strehl_keck.pro
  pupil_circ.pro
  pupil_keck.pro

That's enough for now.  Sorry it took so long to get this in hand,
but we really should try and work off of the CVSed version from now
on.  Please let me know if you any difficulties accessing the the
tree.

Regards,
John Gathright