SMART Download and Installation

Important Notes

For those users who already have SMART installed and are upgrading to a new version :

• When first used SMART makes an extra directory called "smart_bin". This resides in the same directory as SMART (if not otherwise specified in the startup script, see here), parallel to it.
• When installing a SMART upgrade this "smart_bin" directory must be deleted BEFORE the new version of SMART is installed. Failure to delete it can result in significant version incompatibility problems.

SMART Download

The SMART download? consists of two tarballs:

• smart-x.tar.gz (where x is the version number)
  This is a gzipped tar-file that contains the IDL source code for SMART.

• IRS_Calibration-y.tar.gz (where y is the version number)
  This is a gzipped tar-file that contains the most recent set of SMART Calibration files.

SMART Installation

To install SMART :

• Download the tar package to any directory.
• Unpack the tar file by running this command at the prompt:

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

• The package will unpack under the "smart" directory.
• Add the path to the "smart" directory to the IDL path settings. - This path should be the first one after the default IDL path.
• Remember to check the path to the main "smart" directory in the Startup script

SMART Calibration Files Installation

To install SMART Calibration Files :

• Download the tar package to any directory. (NOTE: This tar package unpacks to a directory tree with top directory "IRS_Calibration". The "smart" and "IRS_Calibration" version numbers are not necessarily the same.)
• Unpack the tar file by running this command at the prompt:

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

  
  The package will unpack under the "IRS_Calibration-[version number]" directory. It is advised to rename this directory to IRS_Calibration:

mv IRS_Calibration-[version number] IRS_Calibration

• Add the path to the "IRS_Calibration" directory to the IDL path settings. - This path should be the second one after the default IDL path.
• Remember to check the path to the the "IRS_Calibration" directory in the Startup script

SMART Variable Set Up

The Startup srcript needs to be changed to set environment variables before beginning to use SMART.

SMART Version Number

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

Requirements

Operating system

• Smart is compatible with all recent Linux systems and with Darwin systems (Mac OS) as well.

IDL

• Smart has been successfully tested until IDL 7.0

• IDL Version 6.2: Add an additional "Personal Environment" variable the "smart" shell script in the "smart" directory.
  Make this the first "Personal Environment" variable , listed between the two sets of four hashes "####" (see Startup Files).

   #Set IDL Path Cache Disable
   setenv IDL_PATH_CACHE_DISABLE 1 
   

Astrolib (partly included)

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 acknowledgements are here made.)

Please ensure that Astrolib is installed on your system before attempting to use SMART. link: http://idlastro.gsfc.nasa.gov/

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

Astrolib does not maintain strict version numbers. It is possible that SMART may not be compatible with all variants of Astrolib.

If a SMART/Astrolib incompatibility is found please notify the SMART developers.

PATH

Recommended use of the IDL PATH:

• create a startup IDL file in the home directory, and call it for instance startup.idl or .idl_startup
• create an environment variable in the startup shell script:

  • setenv IDL_STARTUP /home/me/startup.idl

    in CSH

  • export IDL_STARTUP=/home/me/startup.idl

    in BASH
• in the IDL startup file, put the location of Smart, IRS_Calibration, and Astrolib in this order, for instance:

  • !PATH=':/home/me/Smart/'+':/home/me/IRS_Calibration/'+':/home/me/Astrolib/pro:'+!PATH
    device,true_color=24
    device,decomposed=0
    device,retain=2

  • note the last 3 line to avoid color problems with many IDL applications...

Other components

SMART includes a specially modified version of ATV called SMTV.

The name was changed to SMTV at the request of Aaron Barth, the original devleoper of ATV, to prevent confusion between versions.