SSC Home
Page

Spitzer Contributed Software: SMART

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.

I. Documentation

For more information on SMART, please consult the following resources:
  1. The SMART User Guide
  2. The SMART Cookbook
  3. The SMART FAQ.
  4. The "seminal paper" on SMART: The SMART Data Analysis Package for the Infrared Spectrograph on the Spitzer Space Telescope (Higdon et al., PASP 116, 975-984, 2004).
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 can forward bug reports to the IRS team. (The SMART software is Contributed Software.)

II. Installation Requirements

IDL

SMART is written in IDL, and requires a licensed copy of IDL (version 5.5 or greater) to run. To download IDL and purchase a license, visit the ITT website. SMART does not currently run under the IDL Virtual Machine.

If you have IDL 6.x, there is a small additional complication. IDL 6.x has a 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. One way to do this is to insert the line

setenv IDL_PATH_CACHE_DISABLE

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

SMART includes certain publicly available IDL routines taken from Astrolib, The IDL Astronomy User's Library maintained at the NASA Goddard Space Flight Center. 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.

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, 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.

ATV

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

Laptops

Installing SMART on 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.

III. Download SMART

The current version of SMART is v6.4.0. The major change in SMART v6.4.0 is a new LH spectral extraction algorithm that matches the algorithm adopted by the SSC in IRS pipeline version S17.2. This allows the use of SSC S17.2 calibration files for LH data within SMART. For more information on additional improvements, see the current release notes.

Note that there is residual order mismatch in the two reddest LH orders in some datasets. This is inherent in the BCDs and is not produced by SMART. We are currently investigating the problem.

You will find gzipped tarfiles of both SMART and the most recent set of SMART calibration files here.

IV. Installation Instructions

Here we outline the steps required to install and run SMART:
  1. If you have a previous version of SMART installed in $home/smart, do the following. Otherwise skip this step.

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

  2. Download the tar packages to the "home" directory.

  3. Unpack the tar files by running these commands:
     gzip -dc smart-[version number].tar.gz | tar xvf -
     gzip -dc IRS_Calibration-[version number].tar.gz | tar xvf -
  4. Now you should have two directories: $home/smart and $home/IRS_Calibration. (Hereafter we assume that $home is /home/john).

  5. In your .cshrc file, 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 
  6. To invoke your newly modified .cshrc file, type the following at your Unix prompt:
    source .cshrc 
  7. Enter the smart subdirectory by doing
    cd smart 
  8. Make the shell script writable and executable:
    chmod 755 smart
  9. Open the file "smart" in your preferred editor and edit the relevant environment variables between the #### : see figure

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

V. Acknowledging SMART

In addition to the standard Spitzer 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"


Go to the Advanced Data Products Software page.

View other contributed software.


This page was last modified on 14 November 2008.