Spitzer Contributed Software: SMART

SMART is an IDL-based software tool, developed by the Infrared Spectrograph (IRS) Instrument Team at Cornell University, that allows users to perform real-time processing and analysis of IRS data. SMART was delivered to the SSC on 07 Feb 04; an update was delivered 20 Nov 06. Please see the Release Notes and the SMART FAQ.
We encourage users to read the available documentation and report any bugs they may encounter to the SSC Helpdesk (help@spitzer.caltech.edu). The SSC has staff that can answer most questions on SMART and forwards bug reports to the IRS team. (The SMART software is Contributed Software.)

Acknowledging SMART

In addition to the standard acknowledgments , we request that authors using data from the IRS and/or the SMART software include the following acknowledgements and citations in their papers :

The IRS was a collaborative venture between Cornell University and Ball Aerospace Corporation funded by NASA through the Jet Propulsion Laboratory and Ames Research Center.
IRS "seminal paper": Houck et al., Ap.J. Supp. 154, 18-24, 2004. "The Infrared Spectrograph on the Spitzer Space Telescope"
SMART was developed by the IRS Team at Cornell University and is available through the Spitzer Science Center at Caltech.
SMART "seminal paper": Higdon et al., PASP 116, 975-984, 2004. "The SMART Data Analysis Package for the Infrared Spectrograph on the Spitzer Space Telescope"

Previous users of SMART

If you have a previous version of SMART installed in $home/smart, do the following:

cd to $home
rm -rf smart (the -rf option does not prompt and removes subdirectories as well)
Remove smart_bin directory whereever it exists (typically it will be under your home directory)
Remove old IRS calibration files which are under the directory $home/IRS_Calibration
Then proceed with the steps below.

SMART Download

Please see the Release Notes.

Version 6.2.6. A gzipped tar-file that contains IDL code as well as sample images.

SMART Calibration Files Download

Please see the Release Notes.

Version 1.4.9 (released Oct 2007). A gzipped tar-file that contains the most recent set of SMART Calibration files.

SMART and SMART Calibration Files Installation and Environment Variable Setup

Download the tar packages to the "home" directory.

Unpack the tar file by running these commands :

 gzip -dc smart-[version number].tar.gz | tar xvf -

 gzip -dc IRS_Calibration-[version number].tar.gz | tar xvf -

Now you should have two directories: $home/smart and $home/IRS_Calibration. (Hereafter we assume that $home is /home/john)
Change your IDLPATH environment variable to have these two directories as the first two items e.g.
```
setenv IDL_PATH +/home/john/smart:+/home/john/IRS_Calibration:+/usr/local/lib 
```
Do this in your .cshrc and at the Unix prompt do a
```
source .cshrc 
```
Enter the smart subdirectory by doing
```
cd smart 
```
Make the shell script writable and executable:
```
chmod 755 smart
```
Open the file "smart" in your preferred editor and edit the relevant environment variables between the #### : see figure

Warning!! SMART on laptops

Installing SMART in a laptop with a screen size of 15 inches or less can cause problems with the IDEA (ISAP) widgets. They are bigger than the screen and cannot be resized so the widget's buttons cannot be accessed, rendering the software unusable.

SMART and IDL

SMART needs at least IDL 5.5 or greater.

If you have IDL 6.x, there is a small additional complication. IDL 6.x has a new Path Cache feature that is supposed to dramatically speed up searches for procedures in an IDL project. Unfortunately, SMART with its dynamic path changes, is not compatible with this, so you need to disable the Path Cache in order for it to work. You can disable this new feature in a couple of ways, but the way that one user did it was to insert the line

setenv IDL_PATH_CACHE_DISABLE

in the SMART script file, just under the first row of ######.

SMART and Astrolib

SMART includes certain publicly available IDL routines taken from Astrolib, The IDL Astronomy User's Library maintained at the NASA Goddard Space Flight Center. (All relevant acknowledgments are here made.) Please ensure that Astrolib is installed on your system before attempting to use SMART.

VERY IMPORTANT - Access paths on your system must be set so that SMART is accessed BEFORE Astrolib. Failure to do this will result in unpredictable results.

SMART and PERL

SMART includes scripts written in PERL. (Programmable Extensible Report Language.) If you wish to use these you must have PERL installed on your system.

Once PERL is installed you must add to it the "CFITSIO" file subroutine library, (which allows PERL to handle FITS files) and the "CFITSIO.pm" interface (which allows PERL to use CFITSIO). Information about both CFITSIO and CFITSIO.pm can be found at CFITSIO - A FITS File Subroutine Library (This is maintained by the NASA Goddard Spaceflight Center.)

Due to the very large number of possible system configurations, sources for and ways of installing PERL we cannot advise on how to install PERL, CFITSIO or CFITSIO.pm on any particular system. Please see your local system administrator for advice about how best to do this.

NOTE : PERL, CFITSIO and CFITSIO.pm are not necessary for basic running of SMART. They are only needed to use SMART scripting.

SMART and ATV

SMART includes a specially modified version of ATV. The SMART modified version of ATV requires an additional routine : cmps_form.pro. Please dowload this and place it in your default IDL directory. This allows it to be used by other routines.

SMART Version Number

Once SMART is installed the version number can be checked by viewing the read-only file "smart/smart_version.txt".