LUCIFER Mask Software (LMS)
To install LMS Version 1.62 (lms_v162) on an Intel Mac running OS X 10.6 (it should also work for 10.5):
1. Download lms_v162 (lms_v162.tar.gz 10.7MB). By default it should show up in ~/Downloads unless you have changed this. The Mac should gunzip the package, leaving a .tar file. If not, double-click on the .gz file in the finder. Double-click the .tar file to unpack it to a folder (directory) called LMS_v162.
2. Edit the file LMS_v162/bin/lms.sh and make the following two changes:
- Near the top of the file, change the LMSROOT definition:
Old: LMSROOT=${LMSROOT:-$HOME/LMS_v162}; export LMSROOT; # where lms is installed
New: LMSROOT=${LMSROOT:-/Applications/LMS_v162}; export LMSROOT; # where lms is installed
- Near the end of the file change the command to start skycat to:
Old: $LMSROOT/bin/skycat $CLS $CLO $private
New: /Applications/Skycat.app/Contents/MacOs/skycat $CLS $CLO $private
3. Edit the file LMS_162/lib/liblmsPlugins.tcl/lms.tcl file and make the following change:
- Around line 163:
Old: #private variable lochost $env(HOSTNAME); # lms install dir
New: private variable lochost $env(HOST); # lms install dir
For some reason, although HOSTNAME is defined correctly, uncommenting the HOSTNAME line did not work (at least in my quick tests).
4. Move the LMS_162 directory from its current location to the /Applications folder. If you are not an administrative user, you will need to authenticate this operation with an admin username/password.
5. Download the latest Mac OS X binary for Skycat from ESO. The dowload manager (.dmg file) will open a finder with Skycat.app in it. Drag this icon to the /Applications folder as you did with lms_v162 and authenticate if necessary.
6. Check that your HOST environment variable is set correctly to allow LMS to properly display the overlays on Skycat.
In an X11 xterm type the command "set | grep HOST", you should see something like:
HOSTNAME=dhcp-179.lbt.as.arizona.edu
HOSTTYPE=i386
but the lms.sh script wants a real name for the computer (mine is "galileo"). The same should be true for laptops as well as workstations. I added this to my ~/.bashrc file:
export HOST=galileo.as.arizona.edu
Once you make this change, restart X11. Note that the capitalization on HOST is important as scisoft's iraf installation uses a lowercase "host" environment variable to locate the iraf installation:
host=/Applications/scisoft//all/packages/iraf/iraf/unix/
That should be it! To start up the LMS software and check that it runs, do the following:
- Start X11 and open an xterm if necessary
- At the command line type: /Applications/LMS_v162/bin/lms.sh
- In the Skycat window that opens:
- Click on Data-Servers -> Image Servers -> Digitized Sky at STScI (or your favorite server)
- Enter an Object Name in the popup and hit <CR>
- Close the FITS HDUs popup, it is not needed
- Click on LUCIFER1 -> Init Mask
You should see an outline of the LUCIFER field of view come up superimposed on whatever background image you loaded, along with some other markings as described in the lms manual. At this point you should be ready to go. Refer to the LMS manual for the details. It can be found in /Applications/LMS_v162/LMS_UserManual_v162.pdf or at this link.