Contents
Top of Page
Overview
Support Schedule
What's New?
Current Status
Supported Operating Systems
Update Schedule
Release History
Available Software
Unsupported Software
Stand-alone Installation
User Survey Results
FAQ
Getting Started
IDL and Related Software
IRAF
APT from STScI
Graphics and Plotting
Image Display and Analysis
Miscellaneous


Science Applications (SciApps) Software at IPAC

Overview

This document contains information about the IPAC Science Applications (SciApps) software, which is a collection of third party software for scientific analysis that is maintained as a service to IPAC scientists to facilitate their research work.



Support Schedule

SciApps is normally supported during regular business hours (i.e., no support on Caltech holidays), at a level of 50% of a full-time IPAC (research scientist) employee. Temporary reductions to this level of support are sometimes necessitated; for example, due to the travel schedule of the SciApps Administrator. Upcoming periods of reduced support availability are listed here:


Dates SciApps
Support
Notes
21–27 May 2011 Best Effort reduced email contact (AAS-Boston)
9 Jun - 5 Jul 2011 Best Effort/No Support science trip/vacation
22 Jul 2011 No Support vacation
10–18 Sep 2011 No Support conference trip


What's New?

8 April 2011: Interim update of IRAF to v2.15.1a for macintel distributions (networked and stand-alone).


25 March 2011: Interim update of IDL to v8.0.1 for all distributions (except macosx).


4 March 2011: Interim update to macintel5 and macintel6 distributions (networked and stand-alone) to fix path definition issue that prevented some python tasks from working. Networked SciApps users do not need to take any action. Users who have already installed the basic and, optionally, pyraf patch tarballs should download and install the new python patch tarball and, optionally, updated pyraf patch tarball. All stand-alone SciApps users will need the basic (python) patch, but only users who want to use pyraf or IRAF 2.14.1 will need the pyraf patch. Users who have not yet installed the basic tarball can simply download and install the updated basic tarball, which includes the necessary patches.


3 March 2011: All tarballs for stand-alone installation of SciApps restored to the IPAC ftp site following resolution of disk space issues.


28 February 2011: New SciApps distribution for macintel (Doomsday Machine) released on the networked /SciApps partition and as tarballs for stand-alone installation. IDL libraries updated for all operating systems.


19 January 2011: Interim update to upgrade IDL to v8.0 on all platforms following deployment of new IPAC license manager (except macosx - as of v8.0, ITT VIS no longer supports IDL for PowerPC Macs. Affected users can still use IDL v7.1.1 and previous versions; the “idl” command will default to v7.1.1 on macosx computers). Also updated APT to version 19.0, required for HST Cycle 19 proposal preparation.


9 December 2010: Postponed start of next round of updates (mainly motivated by ongoing work on new IDL license server, evaluation of future support for macosx, volume of SciApps support requests, and confluence of non-SciApps constraints on available resources).


8 September 2010: New SciApps distribution for solaris (The Alchemist) released on the networked /SciApps partition. Interim update to macintel6, macintel6, macosx, and linux to roll back default version of SExtractor to v2.5.0. Version 2.8.6 is still available but should be considered unstable – see SExtractor entry in the Table of Available Software for more information.


8 July 2010: Added Support Schedule section at top of SciApps web page.


15 June 2010: Interim update to provide APT version 18.2, required for HST Cycle 18 Phase II preparation and submission (network and stand-alone).


2 June 2010: New SciApps distribution for linux (Jefferson Twilight) released on the networked /SciApps partition and as tarballs. Updated mac distribution (Doctor Orpheus) on network and stand-alone to reflect new IRAF and library directory structure (which were updated to facilitate further Snow Leopard integration), but no changes were made to the software versions. There is no need to reinstall the mac tarballs if your current mac installation is working; any problems with the mac networked SciApps can be resolved by logging out/in. Added instructions in the FAQ for using your own IDL license file with the SciApps IDL installation.


12 May 2010: SciApps moved from redshift to ipacsci0. Updated references to redshift in documentation.

4 May 2010: Interim update to provide missing SuperMongo initialization links in macintel6, macintel5, and macosx (network and stand-alone).

1 April 2010: Interim update to provide missing SExtractor libraries in macintel6, macintel5, and macosx (network and stand-alone).

31 March 2010: New SciApps distribution for macintel and macosx (Doctor Orpheus) released on the networked /SciApps partition and as tarballs. Updated procedure for obtaining and installing stand-alone SciApps tarballs.

22 January 2010: New SciApps distribution for solaris (Your Little Dog) released on the networked /SciApps partition. There will be no stand-alone (tarball) release for solaris.

11 January 2010: Interim update to upgrade APT to v18.0 in macintel, macosx, and linux distributions.

11 December 2009: Interim update to upgrade IDL to v7.1.1 in macintel, macosx, and linux distributions.

5 October 2009: New SciApps distribution for linux (Cowardly Lion) released, both on networked /SciApps partition and as stand-alone tarballs. Revised SciApps initialization procedure for macintel and macosx (same as the procedure for linux) released; this revision fixes the problem with logging in when the automounter has unmounted /SciApps. Patch for macintel version of pgplot released in tarball form; already deployed for networked SciApps. IDL has been moved into /SciApps (from /COTS); should be transparent to users.

22 September 2009: Interim update to SciApps (Flying Monkey) for macintel and macosx (networked and stand-alone): updated CALDB (CIAO) to version 4.1.4.

15 September 2009: Interim update to SciApps (Flying Monkey) for macintel and macosx (networked and stand-alone): updated APT to version 17.4.3 to provide support for HST proposal preparation using post-servicing mission parameters.

25 August 2009: Released SciApps (Flying Monkey) stand-alone tarballs for macintel and macosx.

22 July 2009: New SciApps distribution for macintel and macosx (Flying Monkey) released. Old SciApps for macintel and macosx will cease functioning on 31 August 2009.

8 May 2009: DS9 upgrade appears to have worked; only problems resulted from some users who had aliased old versions of the DS9 binary (which moved). Resolved these with individual users. Proceeding with inventory and clean-up of existing SciApps s/w, setting up for shift to new initialization scripts, followed by updating process. Now have access to macintel, macosx, and solaris operating systems, still waiting for SciApps linux machine to be brought online. SciApps User Survey closed.

24 April 2009: DS9 for Solaris and Mac upgraded to latest version (5.6.2; sorry Linux users, you have to wait a little longer). Some user-transparent changes made to /SciApps directory structure to prepare for new initialization and updating plans. Everything should still work for users with old (i.e., pre-July 2009) SciApps initialization files, but they should now receive the new version of DS9.

13 April 2009: SciApps User Survey released to IPAC. ISG completes sciapps account creation and transferal of ownership of the /SciApps partition, paving the way for updates to commence (eventually – some logistical work and clean-up of the /SciApps partition must be accomplished first).

30 March 2009: A new SciApps Administrator takes office. Expect many updates, changes, and improvements to SciApps soon.


Current Status

Supported Operating Systems

The following operating systems receive active SciApps support. Previous versions of these operating systems will be supported on a best-effort basis. If necessary, please contact the ISG to upgrade the operating system of your computer.


Mac OS X 10.6 (Snow Leopard) for Intel (macintel6)
Mac OS X 10.5 (Leopard) for Intel (macintel5)
Mac OS X 10.5 (Leopard) PowerPC (macosx) – FROZEN!
Red Hat Enterprise Linux 5.3 (linux)
Solaris 10 (solaris)

PowerPC and Solaris Support: Due to lack of demand at IPAC, active SciApps support for PowerPC Macs (macosx) was frozen in the Doctor Orpheus (March 2010) release. Future SciApps updates for Mac OS X will not include updates to macosx software, and the macosx distribution will disappear entirely during a future Mac OS X SciApps update (late 2011 or early 2012). It is expected that SciApps support for the Solaris operating system will also be gradually phased out if the current trend of declining purchases of new Sun/Solaris hardware continues.

Update Schedule

The following table lists the dates of the last and planned next updates of the SciApps distributions for each supported operating system. A reminder email for all updates will be circulated with at least 1 week of advance warning. SciApps may not be available for up to one day (but typically less) when updates occur. Planned updates will be postponed if no changes to the current SciApps distribution are required one month before the scheduled date.


OS Current SciApps
Version Name
Release Date
(Interim Updates)
Next Planned Release
macintel6
macintel5
Doomsday Machine 28 Feb 2011
(8 Apr 2011)
(25 Mar 2011)
(4 Mar 2011)
Oct 2011
macosx Doctor Orpheus 31 Mar 2010
(19 Jan 2011)
(8 Sep 2010)
(15 Jun 2010)
(2 Jun 2010)
(1 Apr 2010)
FROZEN!
linux Jefferson Twilight 2 Jun 2010
(25 Mar 2011)
(28 Feb 2011)
(19 Jan 2011)
(8 Sep 2010)
(15 Jun 2010)
May 2011
solaris The Alchemist 8 Sep 2010
(25 Mar 2011)
(28 Feb 2011)
(19 Jan 2011)
Jul 2011

Release History

The following table contains the historical record of release dates of previous SciApps distributions (starting in July 2009).


OS Previous SciApps
Version Name
Release Date
(Interim Updates)
macintel6
macintel5
macosx
Doctor Orpheus 31 Mar 2010
(19 Jan 2011)
(8 Sep 2010)
(15 Jun 2010)
(2 Jun 2010)
(1 Apr 2010)
Flying Monkey 22 Jul 2009
(15 Sep 2009)
(22 Sep 2009)
(11 Dec 2009)
(11 Jan 2010)
linux Cowardly Lion 5 Oct 2009
(11 Dec 2009)
(11 Jan 2010)
solaris Your Little Dog 22 Jan 2010
(15 Jun 2010)

Available Software

The following table lists the software packages and versions that are currently available in SciApps. Current version release dates are listed in parentheses in the format YYMMDD (MMDD = ---- or DD = -- indicates no precision on release date below year or month, respectively). Available older versions of software titles are listed in italics. See the FAQ for instructions to access old versions of IDL; contact the SciApps Administrator for instructions to access old versions of other software.


Snow Leopard Support: In the Table, the “macintel OS X 10.6” column lists any software titles for which a Snow Leopard-specific version is available. Typically, this indicates that the software has been compiled specifically to run under Snow Leopard without crashing; it may or may not include 64-bit capability. If you are using a Snow Leopard Mac, then you will automatically receive this version of the software. If no Snow Leopard version is available, then you will default back to the Leopard (“macintel OS X 10.5”) version. Because a Mac has to be 64-bit capable in order to run Snow Leopard, you will always receive a 64-bit capable version of the Snow Leopard software if it is available. This is different from the 64-bit options for linux and solaris software, which typically must be explicitly requested to avoid starting the default 32-bit versions – see the Table Notes.


Softwaremacintel
OS X 10.6
macintel
OS X 10.5
macosx
OS X 10.5
linuxsolarisHelp?Notes
AIPS user install
(see FAQ)
user install
(see FAQ)
user install
(see FAQ)
user install
(see FAQ)
user install
(see FAQ)
fw Astronomical Image Processing System for radio data.
APT (runapt) 19.0 [64!]
(110106)
19.0 [64!]
(110106)
18.2
none
(see Notes)
19.0
(110106)
18.2
19.0
(110106)
18.2
bfw The Astronomer's Proposal Tools package is used to submit Phases I/DD and II proposals for the Hubble Space Telescope. The SciApps version of APT is optimized for computers with 2 GB or more of RAM. As of v19, APT is no longer supported for non-Intel Macs. See the FAQ for additional information.
cfitsio library 3.260
(110113)
3.260
(110113)
3.240, 3.140
3.240@F
(100126)
3.140@
3.240
(100126)
3.200
3.240
(100126)
3.210
w Library of C and Fortran subroutines for reading and writing data files in FITS format.
CIAO (ciao) 4.3.0
(101215)
4.2.0
4.3.0
(101215)
4.2.0, 4.1.2
none
(see Notes)
4.2.0
(091215)
4.1.2
4.2.0
(091215)
(see FAQ)
bfw Chandra Interactive Analysis of Observations. Version for macosx (PowerPC) running OS X 10.5 (Leopard) is not available.
CIAO: CALDB 4.4.1
(101215)
4.2.0
4.4.1
(101215)
4.2.0, 4.1.4, 4.1.3
none 4.2.2
(100419)
4.2.0, 4.1.4, 4.1.3
4.2.2
(100419)
4.2.0, 4.1.4, 4.1.3
w Calibration Database for CIAO. Note: for a given CALDB version number, installations of CIAO for all operating system use the same CALDB installation.
Firefox none none none none see Notes bw Open source web browser. The current version of Firefox (3.6.8) requires some updated libraries that are not included in the standard IPAC Solaris 10 installation. If you wish to use this version of Firefox, then please contact the ISG to request an OS upgrade patch for your computer. The older, working version of Firefox (3.5), which was previously available in SciApps for solaris, is now considered to contain some security vulnerabilities. Consequently, it has been removed from availability in SciApps.
fpack (fpack, funpack) 1.5.1
(1012--)
1.5.1
(1012--)
none none none w Optimal compression of images in the FITS data format. Starting with v2.3, the ATV fits image viewer in IDL can read fpacked FITS images.
Fv (fv) none→ 5.3
(0907--)
5.2.1
5.2.1@F
(0807--)
(see Notes)
5.3
(0907--)
5.3
(0907--)
bw Graphical program for viewing and editing any FITS format image or table. Also provides the interface to HEASOFT through Hera (see FAQ). Version 5.3 of Fv for macosx produces erratic behavior of the Finder and is not being upgraded from version 5.2.1 at this time.
g77 none→ 3.4F
(0610--)
3.4F
(0610--)
none
(see Notes)
none
(see Notes)
bw Open source FORTRAN compiler. Available in /usr/bin/ for linux and in /opt/TWWfsw/bin/ for solaris. Development halted in 2006 in favor of gfortran (see below); no further updates to g77 are anticipated.
g95 none→ 0.92
(090625)
0.91
0.91F
(0803--)
0.91
(0803--)
0.92
(090624)
bw Open source FORTRAN compiler.
gfortran 4.5.0 [64]
(1001--)
4.4.1
(0907--)
4.4.0
4.4.1F
(0907--)
4.4.0
none
(see Notes)
none
(see Notes)
bw Open source FORTRAN compiler. Available in /usr/bin/ for linux; not available for solaris.
Ghostscript (gs) none→ 9.00
(100917)
8.64
8.64F
(090203)
none
(see Notes)
none mw An interpreter for the PostScript language. Available in /usr/bin/ for linux.
Ghostview (gv) 3.6.5
(0807--)
3.6.2
(0609--)
3.6.2F
(0609--)
3.5.8
(9706--)
none w Postscript previewer.
Grace (xmgrace) none→ 5.1.16
(040704)
5.1.16@F
(040704)
5.1.22
(080521)
5.1.22
(080521)
bw GUI-enabled scientific plotting package (like Supermongo, but with a GUI).
HEASOFT none
(see FAQ)
none
(see FAQ)
none
(see FAQ)
none
(see FAQ)
none
(see FAQ)
bfw A unified release of the FTOOLS and XANADU software packages for X-ray data.
IDL (idl) 8.0.1 [64]
(101028)
8.0 [64], 7.1.1 [64], 7.0.6 [64]
8.0.1 [64]
(101028)
8.0 [64], 7.1.1 [64], 7.0.6 [64], 7.0
7.1.1F
(090928)
7.0.6, 7.0
8.0.1 [64]
(101028)
8.0 [64], 7.1.1 [64], 7.0.6 [64], 7.0, 6.0
8.0.1 [64]
(101028)
8.0 [64], 7.1.1 [64], 6.0 [64], 5.6 [64], 5.5, 5.4, 5.2
bf Interactive Data Language. It does everything. As of v8.0, ITT VIS no longer supports IDL for PowerPC Macs (macosx). Affected users can still use v7.1.1 and previous versions.
IDL: astro library 24Jan11
21Jan10, 15May09
24Jan11
21Jan10, 15May09
24Jan11F
21Jan10, 15May09
24Jan11
17May10, 15May09
24Jan11
17May10, 15May09
w Useful astronomy-related routines for IDL. Requires using IDL v6.1 or higher.
IDL: ATV (atv) 2.3
(101018)
2.1, 1.5.2
2.3
(101018)
2.1, 1.5.2
2.3F
(101018)
2.1, 1.5.2
2.3
(101018)
2.2, 2.1, 1.5.2
2.3
(101018)
2.2, 2.1, 1.5.2
bw DS9-like FITS image viewer for IDL. For best results, include the following line in your ~/.idl_startup file:

device, true_color=24, decomposed=0, retain=2
IDL: buie library 8.0
(110103)
7.1, 7.0
8.0
(110103)
7.1, 7.0
7.1F
(100204)
7.0
8.0
(110103)
7.1, 7.0, 6.0
8.0
(110103)
7.1, 6.0, 5.6, 5.5, 5.4, 5.2
w More astronomy-related IDL routines. The version number for the buie library is tied to the IDL version number. More recent versions of the buie library might not work with older versions of IDL, so SciApps automatically serves the correct version of the buie library depending on the version of IDL being used.
IDL: Transit Analysis Package: TAP (tap) 2.1
(110130)
2.1
(110130)
2.1F
(110130)
2.1
(110130)
2.1
(110130)
w IDL package designed for the analysis of extrasolar planet transit light curves, utilizing Markov Chain Monte Carlo fitting techniques.
IDL: Transit Analysis Package: autoKep (autokep) 1.0
(110130)
1.0
(110130)
1.0F
(110130)
1.0
(110130)
1.0
(110130)
w IDL package designed to provide streamlined transit light curves from MAST Kepler archive fits files.
IDL: IDLwave macros none→ 6.0F
(060217)
6.0F
(060217)
6.0F
(060217)
6.0F
(060217)
bfiw Macros for writing IDL programs in Emacs. IDLwave v6.1+ is incorporated into Emacs v22.0+; consequently, no further updates to the SciApps installation of IDLwave will be made. See the FAQ for initialization instructions.
ImageMagick 6.6.7
(110129)
6.5.9
none none none
(see Notes)
none imw A software suite to create, edit, and compose bitmap images. Available in /usr/bin/ for linux.
IRAF (cl) 2.15.1a[64]
(110125)
2.14.1
2.15.1a[64]
(110125)
2.14.1
2.14.1F
(080916)
2.14.1
(080916)
2.14.1
(080916)
bw Image Reduction and Analysis Facility, built and distributed by NOAO. Starting with v2.15, IRAF is 64-bit capable; in order to run IRAF in 64-bit mode, your computer must be running a 64-bit kernel - see the FAQ for more info. Not all external packages have been carried forward into the 2.15 release of IRAF; consequently, the 2.14 version is still available in SciApps - see the FAQ for instructions for starting IRAF v2.14.1. See the FAQ for an important notice about SciApps support for IRAF external packages.
IRAF: x11iraf none→ 1.3.2
(03----)
1.3.2F
(03----)
1.3.2
(03----)
1.3.1
(02----)
imw Various X11 tools for use with IRAF (see xgterm below). Version 2 is currently in beta testing; when a stable version is released, it will be incorporated into SciApps.
pgplot none→ 5.3.1
(------)
5.3.1F
(------)
5.2.2
(010226)
5.2.2
(010226)
w Fortran- or C-callable, device-independent graphics subroutine library for making simple scientific graphs. The web documentation lists v5.2.2 as most recent, but is still valid for more recent versions.
PIA (pia) none
(see Notes)
none
(see Notes)
none
(see Notes)
none
(see Notes)
10.0F
(020507)
(see Notes)
w ISOPHOT Interactive Analysis. User Survey returned zero users, and development halted in 2002; no further updates are anticipated, but the old SciApps installation (solaris only) is preserved here. Requires use of IDL v5, so users must first redefine the default version of IDL by issuing the command “idl56”, then exit out of IDL before starting PIA.
pigz (pigz, unpigz) 2.1.6
(100117)
2.1.6
(100117)
2.1.6F
(100117)
2.1.6
(100117)
none w Parallel Implementation of GZip. A fully functional replacement for gzip that exploits multiple processors and multiple cores to the hilt when compressing data. For example, for a 1.5 Gb tarball on a 2.8 GHz Intel Core i7 quadcore iMac running OS X 10.6.2, compression (uncompression) with gzip (gunzip) took 89 (22) seconds, whereas with pigz (unpigz), the compression (uncompression) took 21 (16) seconds.
Python (python) 2.7.1
(101127)
(see FAQ)
2.7.1
(101127)
(see FAQ)
none
(see FAQ)
none
(see FAQ)
none
(see FAQ)
fw Dynamic object-oriented programming language.
Python: scientific tools user install
(see FAQ)
user install
(see FAQ)
none
(see FAQ)
user install
(see FAQ)
user install
(see FAQ)
fw Libraries for Python that provide scientific applications.
Python: PyRAF (pyraf) 1.10
(1101--)
(see Notes)
1.10
(1101--)
(see Notes)
none
(see Notes)
none
(see Notes)
none
(see Notes)
fw Command language for running IRAF tasks that is based on the Python scripting language. Utilizes the SciApps installations of python (see above), IRAF 2.14.1 (see below), and the PyRAF stsdas tasks. PyRAF currently only works with IRAF v2.14.1, so if you want to use these python-based IRAF routines, then you must set the “iraf214” flag in your SciApps initialization command.
Python PyRAF: stsdas tasks 2.11
(1101--)
(see Notes)
2.11
(1101--)
(see Notes)
none none none fw This is the stsci_python package version number for the relevant PyRAF tasks (such as multidrizzle, pydrizzle, pyfits, etc.). Each of these tasks has its own individual version number, but for the sake of brevity, these numbers are not reproduced here since the tasks are only updated when a new version of stsci_python is available. PyRAF currently only works with IRAF v2.14.1, so if you want to use these python-based routines, then you must set the “iraf214” flag in your SciApps initialization command.
SAOimage DS9 (ds9) 6.2
(101015)
6.0
6.2
(101015)
6.0, 5.6.2
6.0@F
(100115)
5.6.2@
6.1 [64]
(100515)
5.6.3 [64]
6.1.2
(100515)
6.0, 5.7, 5.6.2, 4.07b, 3.0b6, 2.0
bfw Astronomical imaging and data visualization application.
SExtractor (sex) 2.5.0
(060714)
2.8.6
(see Notes)
2.5.0
(060714)
2.8.6
(see Notes)
2.5.0F
(060714)
2.8.6
(see Notes)
2.5.0 [64!]
(060714)
2.8.6 [64!]
(see Notes)
2.5.0
(060714)
(see Notes)
imw Source Extractor. Builds a catalogue (with photometry) of objects from an astronomical image. Version 2.5.0 is the last fully stable version. Version 2.8.6 includes some non-essential improvements (which do not affect the basic source detection and photometry functions) that rely on the external ATLAS library, which is extremely sensitive to hardware and compilation options. This version of SExtractor is available via the command “sex286”, but should be considered unstable and used with caution. External library incompatibilities prevent compilation of v2.8.6 for solaris.
skycalc none→ 5.0
(0102--)
5.0@F
(0102--)
5.0
(0102--)
5.0
(0102--)
bw Astronomical almanac calculator. Part of the skycal package.
skycalendar none→ 5.0
(0102--)
5.0@F
(0102--)
5.0
(0102--)
5.0
(0102--)
bw Astronomical calendar. Part of the skycal package.
skyview none→ 3.6
(061130)
3.6@F
(061130)
3.6
(061130)
3.6
(061130)
bfw Image display and analysis program for the interactive analysis of astronomical data.
SuperMongo (sm) 2.4.36
(090908)
2.4.36
(090908)
2.4.26@
2.4.36F
(090908)
2.4.26
2.4.36
(090908)
2.4.26
2.4.26
(021223)
bfmw Interactive scientific plotting package. See the FAQ for initialization instructions.
SWarp (swarp) 2.19.1
(100904)
2.17.6
2.19.1
(100904)
2.17.6
2.17.6F
(090409)
2.17.6
(090409)
none imw Resamples and co-adds FITS images using any arbitrary astrometric projection defined in the WCS standard.
TeX (latex) none→ 2010
(100914)
2009, 2008
2009@F
(091107)
2008@
none
(see Notes)
none
(see Notes)
fw Typesetting package often used to prepare journal articles. Available in /usr/bin/ for linux and in /opt/TWWfsw/bin/ for solaris. See the FAQ for more information.
TeX: aastex macros none→ 5.2
(050617)
5.2@F
050617)
5.2
(050617)
(see FAQ)
5.2
(050617)
(see FAQ)
fw Latex macros for preparing manuscripts for AAS journals.
TeX: emulateapj macros none→ 13Aug10
16Feb10, 20Apr08
(see FAQ)
16Feb10F
20Apr08
(see FAQ)
16Feb10
20Apr08
(see FAQ)
16Feb10
20Apr08
(see FAQ)
fw Latex macros for formatting manuscripts to look like printed ApJ articles. See the FAQ for more information.
WCSTools 3.8.1
(091110)
3.8.1
(091110)
3.7.2
3.8.1@F
(091110)
3.7.2@
3.8.1
(091110)
3.6.2
3.8.1
(091110)
3.6.2
imw World Coordinate System Tools for astronomical images. Type “man wcstools” for a list and short description of the WCSTools tasks.
WIP (wip) none
(see Notes)
none
(see Notes)
2.3F
(980122)
2.3F
(980122)
2.3F
(980122)
bfw Interactive graphics package. See the FAQ for initialization instructions. Development halted in 1998; no further updates are anticipated, but the old SciApps installation is preserved here. A version for macintel is not available.
xgterm none→ 1.3.2
(03----)
1.3.2@F
(03----)
1.3.2
(03----)
1.3.1
(02----)
im Graphics-enabled xterm window for use with IRAF. Part of x11iraf.
XPA 2.1.13
(101015)
2.1.11
2.1.13
(101015)
2.1.11, 2.1.9
2.1.13@F
(101015)
2.1.11@, 2.1.9@
2.1.12
(100515)
2.1.9
2.1.12
(100515)
2.1.10
w X Public Access. Web data retrieval tasks used by DS9.
xv none none none none 3.10a (patched)
(------)
bmw Graphics display and manipulation program.
TABLE NOTES
  • Help? b = built-in software help function; f = see item(s) for this software in the SciApps FAQ; i = unix info command; m = unix man command; w = web page (see documentation link in Notes column).
  • F (appended to version number) = no further development of this software and/or no further updates to SciApps are anticipated; future OS upgrades may eventually “break” this software.
  • @ (appended to version number) = macosx uses universal binary from macintel installation, or macintel uses macosx installation via Rosetta.
  • [64] (appended to version number) = 64-bit version of this software is available for use on linux or solaris computers with compatible processors and operating systems. In general, start the 64-bit version by appending “-64” to the software title (e.g., to start the 64-bit version of DS9, use the command “ds9-64” instead of “ds9”. In some cases (e.g., IDL), the 64-bit version will start automatically when the software is called from a 64-bit capable computer. For macintel Snow Leopard software, this tag indicates that the default delivered version is 64-bit capable.
  • [64!] (appended to version number) = ONLY a 64-bit version of this software is available. In this case, both the default command and the command with “-64” appended will start the software title (e.g., to start SExtractor on linux, use either the command “sex” or “sex-64”).

Unsupported and Unavailable Software

The following software packages have been completely “retired” from SciApps and are no longer supported or available for any platform (see the FAQ):



In addition, note in the Table of Available Software that some packages (e.g., AIPS, HEASOFT) are not maintained as part of the SciApps distributions, but are available to IPAC users via other avenues (described in the table) and are supported (on a best-effort basis) by the SciApps Administrator.


Stand-alone (Tarball) Installation

The current SciApps distributions for macintel, macosx, and linux are available as tarballs for stand-alone installation on laptop and off-site computers that cannot mount the IPAC /SciApps partition.


If you have a desktop computer that is on the IPAC network, then you do NOT need to install SciApps from the tarballs. Please see the initialization instructions for SciApps on networked computers.

Caveats:

  1. Because it is commercial, licensed software, IDL is not included in the stand-alone tarball release of SciApps. However, the IDL astronomy library and associated resources included in SciApps (including the requisite path set-up) are included in the tarballs. So, if you have a licensed version of IDL installed on your laptop, then the SciApps IDL-related utilities will be available to you.

  2. The CIAO software package and its associated calibration file directory (CALDB) are quite large (~5 GB), and are utilized by relatively few IPAC scientists. Consequently, this software package is not included in the standard SciApps tarballs, but is instead packaged in its own tarball. If you want to install CIAO with SciApps, then first follow the tarball installation instructions for SciApps (see below), and then repeat using the CIAO tarball.

Installation and Initialization:

  1. Create a directory called SciApps (capitalization matters) in your home directory; e.g.,

    mkdir ~/SciApps

    Note: if you are upgrading to a new SciApps distribution (i.e., when the version name changes, like from “Flying Monkey” to “Doctor Orpheus”), then, in principle, you can unpack the tarball for the new distribution into your existing /SciApps directory. However, this will retain all of the old versions of the software, which will consume disk space. A better procedure would be to move your existing ~/SciApps directory to a new name; for example,

    mv ~/SciApps ~/SciApps_previous

    Then, create a new ~/SciApps directory as shown above and follow the rest of the steps below to install the new SciApps distribution. If anything goes wrong during the installation, or you are not happy with the new SciApps distribution, then you can restore the previous SciApps using the command

    mv -f ~/SciApps_previous ~/SciApps

    After you are satisfied that the new SciApps distribution is working, then you can delete the previous directory using the command

    rm -rf ~/SciApps_previous

    or open a Finder window (or non-Mac equivalent) and drag the ~/SciApps_previous folder into the Trash.

  2. Download the desired tarball from the table shown below (be sure to select a tarball for the correct operating system: macintel6 = Intel Mac with Snow Leopard, macintel5 = Intel Mac with Leopard, macosx = PowerPC Mac with Leopard).

    Table Notes:
    • The basic distribution does not include CIAO and CALDB, IRAF v2.14.1, nor the stsci_python packages. It does include IRAF v2.15.1, python, and the python_sci packages (ipython, numpy, and nose).

    PackageOSVersion NameRelease Date
    (Original Release)
    Link
    SciApps (basic distribution)macintel6Doomsday Machine08 Apr 2011
    (28 Feb 2011)
    Download
    SciApps (basic distribution)macintel5Doomsday Machine08 Apr 2011
    (28 Feb 2011)
    Download
    SciApps (basic distribution)linuxJefferson Twilight28 Feb 2011
    (08 Sep 2010)
    Download
    CIAO v4.3.0, CALDB v4.4.1 (patch)macintel6Doomsday Machine28 Feb 2011Download
    CIAO v4.3.0, CALDB v4.4.1 (patch)macintel5Doomsday Machine28 Feb 2011Download
    CIAO v4.2.0, CALDB v4.2.2 (patch)linuxJefferson Twilight28 Feb 2011
    (02 Jun 2010)
    Download
    IRAF v2.15.1a (patch)macintel6Doomsday Machine08 Apr 2011
    (28 Feb 2011)
    Download
    IRAF v2.15.1a (patch)macintel5Doomsday Machine08 Apr 2011
    (28 Feb 2011)
    Download
    IRAF v2.14.1, PyRAF v1.10, stsci_python v2.11 (patch)macintel6Doomsday Machine04 Mar 2011
    (28 Feb 2011)
    Download
    IRAF v2.14.1, PyRAF v1.10, stsci_python v2.11 (patch)macintel5Doomsday Machine04 Mar 2011
    (28 Feb 2011)
    Download
    python v2.7.1 and python_sci (patch)macintel6Doomsday Machine04 Mar 2011Download
    python v2.7.1 and python_sci (patch)macintel5Doomsday Machine04 Mar 2011Download

    The “patch” tarballs upgrade an existing stand-alone basic distribution of SciApps to include additional or updated software. With the exception of the CIAO and CALDB patch (which is never included in any of the full SciApps tarballs and is not available for macosx), a patch tarball should only be applied to stand-alone full versions of SciApps that were installed before the release date of the patch. The tarballs for the full SciApps distributions created on or after any patch tarball release date will already include the patch. After downloading a “patch” tarball, follow steps 3 and 4 below.


    The “only” tarballs install stripped down versions of SciApps containing only the indicated software. After downloading an “only” tarball, follow steps 3–6 below. Note that multiple SciApps “only” tarballs can not be installed into the same ~/SciApps directory. However, one could create multiple SciApps directories (e.g., ~/SciApps1, ~/SciApps2, etc.) to store separate SciApps “only” distributions. Each “only” distribution will have its own individualized initialization file (e.g., ~/SciApps/setup/sciapps_irafonly.csh for the IRAF only installation) and will have to be sourced separately in the ~/.tcshrc file (as in step 5 below). Note that using this method of creating separate SciApps directories requires making a slight modification to the “dmod” environment variable setting located near the top of the initialization file. For example, if I stored the IRAF only distribution of SciApps in a directory called ~/SciApps1, then I would modify the dmod setting in ~/SciApps1/setup/sciapps_irafonly.csh from its default value of

    setenv SciApps_irafonly_dmod ''

    to a new value of

    setenv SciApps_irafonly_dmod '1'

    to reflect the change in the default SciApps directory name. The value of the dmod environment variable is appended to the default SciApps directory name.


  3. Move the tarball into the SciApps directory that you created; e.g.,

    mv sciapps_macintel6_doctororpheus_31mar10.tar.gz ~/SciApps/

  4. cd to the SciApps directory, and uncompress and unpack the tarball; e.g.,

    cd ~/SciApps ; tar xvzf sciapps_macintel6_doctororpheus_31mar10.tar.gz

    Note to Mac users: Do not unpack the tarball by double-clicking on it in a Finder window, as this will create a sub-directory in ~/SciApps with the same name as the tarball, into which its contents are unpacked, rather than unpacking directly into ~/SciApps, which is the desired behavior.

  5. Insert the following line into your ~/.tcshrc file:

    source ~/SciApps/setup/sciapps.csh tarball

  6. Log out and back in, or source ~/.tcshrc, to initialize SciApps.

User Survey Results

The SciApps User Survey closed on 1 May 2009 – thanks for your input! The results from this survey (tabulated below) will help to maximize the efficiency of available SciApps administration resources by identifying the specific needs and desires of SciApps users. This will allow targeted development of SciApps to make it as useful as possible for IPAC scientists.


Many thanks for the large number of survey responses. The final survey results are summarized below.



SoftwareFrequentlySometimesRarelyNever   SoftwareFrequentlySometimesRarelyNever
AIPS33323   Lickmongo12227
APT15323   pgplot54518
cfitsio library56516   pia00032
CIAO20327   python45419
DAOphot58613   SAOimage DS927311
FV34421   SExtractor77414
GSL00131   skycalc34322
IDL23234   skycalendar11327
IDL astro library23117   skyview84416
IDL atv64220   SuperMongo35321
IDL buie library21128   swig10031
IDLwave21425   wcstools69314
IRAF141044   wip15125
LHEAsoft30029   xgterm136112


ctio = 10color = 3crutil = 5fitsutil = 11focas = 1gemini = 4
gmisc = 1guiapps = 3ifocas = 0mtools = 7mscred = 11mxtools = 1
nmisc = 2rvsao = 3stsdas = 16tables = 14xray = 1  


Frequently Asked Questions



FAQ: Getting Started



Q: How do I set up my computer to use SciApps?


A: Check on your computer for the presence of a root-level symbolic link that defines a permanent path to /SciApps. To do this, issue the following command in a Terminal or xterm window:

ls -l /SciApps

There are three possible outcomes:

  1. No link is present: The ls command listed above will return a message similar to

    ls: /SciApps: No such file or directory

    In this case, contact ISG and request creation of the symbolic link to SciApps on your computer.

    Mac users only – You can create the symbolic link yourself by issuing the following command in a Terminal or xterm window:

    sudo /bin/ln -s /net/ipacsci0/SciApps /SciApps

    Enter your normal login password when prompted.

  2. An incorrect link is present: In this case, the ls command will return a message similar to

    lrwxr-xr-x 1 admin admin 40 Jan 19 2007 /SciApps -> XXXXX/SciApps/OSNAME

    where XXXXX is a path designation (probably /Network/Servers/ipacsci0 or /net/ipacsci0 for macintel and macosx, and /stage for linux and solaris), and OSNAME is the name of your operating system (i.e., macintel, macosx, linux, or solaris). The problem with this form of the link is the trailing designation of the operating system name, which is not required for the new SciApps. Contact ISG and request that the symbolic link to SciApps is corrected on your computer.

    Mac users only – You can repair the symbolic link yourself by following this procedure (also see http://isgwiki/User_Guide/SciApps):

    1. Make sure that you are not in any /SciApps folder or directory, and all SciApps applications are closed. (If you are uncertain, then just logout and login again.)

    2. In a Terminal or xterm window, issue the following sequence of commands. You will be required to enter your normal login password for the first command, but not for the subsequent commands if they are all completed within 5 minutes.

      sudo umount -f /SciApps

      sudo /bin/rm /SciApps

      sudo /bin/ln -s /net/ipacsci0/SciApps /SciApps

    Please note that, currently, SciApps will likely still initialize even with this incorrect form of the link because of various symbolic links that have been installed in the old SciApps distribution directories, as workarounds to redirect the initialization script to the new distribution directories. However, it is not guaranteed that these will continue to work (or even that the old distribution directories will be available) in the future, so please do request that your link to /SciApps is corrected even if it appears to work as is.

  3. A correct link is present: In this case, the ls command will return a message similar to

    lrwxr-xr-x 1 admin admin 40 Jan 19 2007 /SciApps -> XXXXX/SciApps

    This is similar to the incorrect link case described above, but the important distinction is that the trailing operating system designation is not present. That is, the link path must end at /SciApps. If this is the case for your computer, then you are already prepared to set up SciApps.


Once you have the correct /SciApps symbolic link on your computer, simply include the following line in your shell configuration file (typically ~/.cshrc or ~/.tcshrc – see which shell can I use?).


source /SciApps/setup/sciapps.csh force_idl

The switch force_idl controls whether or not SciApps will override the set-up for a local installation of IDL and force usage of the SciApps installation of IDL. If you want to use your own installation of IDL, then remove force_idl from the command string. This setting is currently only valid for macintel and macosx; linux and solaris will always use the SciApps installation of IDL.


The switch verbose can be added to the SciApps initialization command, and controls whether or not SciApps will display an initialization confirmation message, as well as a number of possible warning messages. This is mostly useful when diagnosing problems with the SciApps initialization on your computer, and is not recommended as the default usage.


SciApps will be globally initialized the next time you log out and back in. It will be locally initialized for any new terminal window (e.g., an xterm) that you open, or by typing source ~/.cshrc or source ~/.tcshrc (as appropriate for your particular shell) in any existing window.


In the old (pre-July 2009) implementation of SciApps, a set of nested files were created in your home directory by the initialization script, and these were used to set up the software distribution. In the new version of SciApps, the initialization settings, definitions, etc., are all moved into the script itself, so all you have to do is source the set-up script. This also gives you freedom to structure your shell configuration file(s) as you desire, and the ability to insert the SciApps initialization command at any desired point in the shell configuration (e.g., in order to preferentially place the SciApps directories in your PATH at a desired priority level).



Q: What do I do with the shell configuration files created by the old (pre-July 2009) SciApps?


A: The old (pre-July 2009) SciApps initialization created or modified an assortment of nested shell configuration files in your home directory (~/). For example, a typical initialization on a solaris computer would create or modify ~/.tcshrc, ~/.tcshrc.solaris, and ~/.user.post.csh and/or ~/.user.post.solaris.csh. The file ~/.tcshrc is sourced every time X11 starts or a new X window starts. The files ~/.tcshrc.solaris and ~/.user.post.csh are sourced (in that order) by ~/.tcshrc. The file(s) ~/.user.post.csh and/or ~/.user.post.solaris.csh are sourced by ~/.tcshrc.solaris. The file ~/.user.post.csh is intended to contain your personal command aliases and/or environment variable definitions. All of the other files contain old SciApps initialization commands, aliases, and definitions.


The new SciApps initialization requires only one command in your ~/.tcshrc file, as noted above. So, at a bare minimum, all you would need to have a functional computer account with SciApps initialized is a ~/.tcshrc file that contains only the SciApps initialization command. Additional command aliases and/or environment variables can be added directly to ~/.tcshrc, or may still be sourced from a separate file (e.g., ~/.user.post.csh) by including the line

source ~/.user.post.csh

at the bottom of your ~/.tcshrc file.


So, the recommended procedure for transitioning from the old SciApps to the new SciApps is to first move the existing configuration files to harmless names; for example,


mv ~/.tcshrc ~/.tcshrc.OLD
mv ~/.tcshrc.solaris ~/.tcshrc.solaris.OLD
mv ~/.user.post.csh ~/.user.post.csh.OLD
mv ~/.user.post.solaris.csh ~/.user.post.solaris.csh.OLD


(substitute the appropriate OS name for “solaris” in this example). These files can (optionally) eventually be deleted once you are comfortable that your current SciApps and overall shell configurations are stable and conform to your desires.


Next, create a new ~/.tcshrc file that contains the new SciApps initialization command discussed above, followed (and/or preceded, as desired) by your personal command aliases or environment variable definitions, if any.


The old SciApps initialization also created a file called ~/.local_iraf. This file is no longer used and should be deleted or renamed; e.g.,


mv ~/.local_iraf ~/.local_iraf_OLD

Please contact the SciApps Administrator if you have any questions about this process or desire assistance in implementing it.



Q: Which shell can I use?


A: The SciApps initialization scripts will currently function under the C shell (csh) and TENEX C shell (tcsh). Of these two, tcsh is preferred, since some software (notably IRAF) occasionally has problems running under csh due to long variable names. In the future, SciApps initialization scripts for the Bourne-again shell (bash) on Mac computers will be made available.


For instruction for changing your default shell to tcsh on Mac laptops and self-administered Mac computers, see

http://mactips.dwhoard.com/mactips/system/change-default-shell

For all other ISG-administered computers, contact the ISG.



Q: I get an error message that looks like this:


/setup/sciapps.csh: No such file or directory.

and SciApps will not initialize. What is wrong?


A: It is likely that you do not have the /SciApps partition mounted on your computer, or you have an incorrect mount point or root-level symbolic link to /SciApps (also see “How do I set up my computer to use SciApps?”).


Issue the command


\df | grep SciApps | grep -v trigger

  1. If this command produces no output, then the /SciApps partition is not mounted on your computer. Contact the ISG to add a permanent mount point to your computer. The correct mount point is

    ipacsci0.ipac.caltech.edu:/SciApps

  2. If this command produces a line of output that contains the following path:

    ipacsci0.ipac.caltech.edu:/SciApps/linux

    (substitute your current operating system for “linux”), then you have an incorrect mount point that must be changed to the correct version noted above – contact ISG. Note that changing the mount point, although necessary for the new SciApps initialization, will disable access to the old (pre-July 2009) SciApps (this is OK, as the old SciApps will be phased out anyway).


For macosx and macintel only: You can mount /SciApps yourself by promoting the Finder (i.e., click on the Desktop background) and pressing Cmd-K, or use


Finder → Go → Connect to Server...

In the Connect to Server pop-up window, enter


nfs://ipacsci0.ipac.caltech.edu/SciApps

for the Server Address and press the Connect button. This is a temporary mounting and will be unmounted if you reboot your computer.



Q: How can I use SciApps on my laptop or home computer?


A: The /SciApps partition can only be mounted on a computer that is permanently connected to the IPAC network, which typically excludes laptops and off-site computers. You can run most of the SciApps tasks remotely by logging in to your IPAC computer from your laptop or home computer. Stand-alone tarball installations of the current distributions of SciApps for macintel, macosx, and linux are also available – see above for additional information.



Q: Where's my favorite software package? Why isn't it supported in SciApps (anymore)?


A: The limited SciApps administrative resources preclude supporting many software packages that do essentially the same thing, or complex software packages that are utilized by very few people. In the interests of providing useful software for IPAC scientists, while at the same time streamlining the SciApps maintenance and updating tasks to facilitate a frequent and regular update schedule, some duplicate and under-utilized software packages were eliminated.


For example, SciApps now supports one command line plotting package (SuperMongo) and one (new) GUI-enabled plotting package (Grace). Software packages such as WIP and Lickmongo, which provide essentially the same services (i.e., producing scientific plots) are no longer supported in SciApps. (Actually, both IDL and pgplot – which are supported in SciApps – can also be used to construct publication-quality scientific plots, so really there are already four plotting packages supported in SciApps.)




FAQ: IRAF



Q: How can I use the old version 2.14.1 of IRAF?


A: The default version of IRAF in SciApps is 2.15+ on all platforms for which it is available. In order to use IRAF v2.14.1 instead, you must append the flag iraf214 to the SciApps initialization command in your ~/.tcshrc file; i.e.,

source /SciApps/setup/sciapps.csh iraf214

See “How do I set up my computer to use SciApps?” for additional information about setting up SciApps on your computer.



Q: How can I use IRAF v2.15+ in 64-bit mode on my Intel Mac?


A: IRAF uses the result of the uname -m command to determine if your Intel Mac is running a 64-bit kernel: i386 = 32-bit, while x86_64 = 64-bit. It then sets the value of the system variable IRAFARCH to either macosx (32-bit) or macintel (64-bit), and delivers the appropriate IRAF binaries. (Note that these labels differ somewhat from their use in the rest of SciApps, where macintel indicates any 64-bit capable Mac containing an Intel processor, regardless of whether it is running in 32-bit or 64-bit mode, whereas macosx indicates any Mac using a PowerPC processor.)


Only Mac OS X v10.6+ (Snow Leopard) is capable of running in 64-bit mode. If you are not running the 64-bit kernel (check the output of the uname -m command) but want to start IRAF in 64-bit mode anyway, then you can manually set the value of the system environment variable IRAFARCH, as follows:

setenv IRAFARCH macintel

Alternatively, you can append the flag iraf64bit to the SciApps initialization command in your ~/.tcshrc file; i.e.,

source /SciApps/setup/sciapps.csh iraf64bit

See “How do I set up my computer to use SciApps?” for additional information about setting up SciApps on your computer.


Another option is to boot your Mac into the 64-bit kernel, in which case IRAF will deliver the 64-bit binaries by default. First, ensure that your computer's firmware is capable of booting the 64-bit Snow Leopard kernel at all by issuing the following command in a Terminal window:

ioreg -l -p IODeviceTree | grep firmware-abi

If the output of this command contains the string EFI64, then your computer can boot the 64-bit Snow Leopard kernel. If the output contains EFI32, then sorry, stop here, do not pass go – your computer cannot boot the 64-bit kernel.


Assuming that your computer is able to boot the 64-bit kernel, then you can do so by holding down the 6 and 4 keys simultaneously while the computer is rebooting. There are possibly ways to make booting into the 64-bit kernel the default behavior (e.g., see this link); however, these are not for the faint of heart, and are not officially endorsed here. Just hold down the 6 and 4 keys while rebooting - how often do you reboot your Mac anyway?



Q: Why is there no MXTOOLS package for solaris IRAF?


A: Although source code and pre-compiled binaries for the MXTOOLS package are available (e.g., on the NOAO IRAF FTP site), these date from 2001. These files will neither compile from source nor run as pre-compiled executables on current solaris computers. This behavior is likely related to backwards compatibility issues in the solaris operating system. If you absolutely need the MXTOOLS package to run on a solaris computer, then please contact the SciApps Administrator; otherwise, it is no longer going to be supported in SciApps for solaris.



Q: Which external packages are supported in the SciApps installation of IRAF?


A: Prior to the IRAF 2.15 release, external packages in SciApps were maintained (and documented) on a case-by-case basis. However, starting with IRAF 2.15, the new dynamic package loading feature allows for package directories created in the iraf$extern directory to be automatically defined at runtime when IRAF is started. This greatly simplifies the installation and maintenance of IRAF external packages, since (for example) the IRAF configuration files no longer have to be updated manually following installation or update of external packages. Consequently, in order to simplify the corresponding documentation of IRAF external packages, individual documentation of the installed versions of packages will no longer be maintained on the SciApps web page. The SciApps Administrator will endeavour to keep an up-to-date suite of widely used external packages available within IRAF. The available packages are listed upon first starting IRAF, and (starting with v2.15.1a) the version number and/or date for each package is listed upon loading that package in IRAF. If you require an IRAF package that is not currently installed, or have reason to believe that an installed package is out of date, then please contact the SciApps Administrator. Note that external packages in IRAF v2.14 will generally not be updated in the future, since that version of IRAF is only being maintained temporarily as a transitional option until more external packages and PyRAF become compatible with IRAF v2.15.




FAQ: IDL and Related Software



Q: How can I use an old version of IDL?


A: To start an old version of IDL (see the Table of Available Software for the list of old versions of IDL available for each supported operating system), use the command idlNN, where NN is the version number with the decimal point removed. For example, to start IDL version 5.6, you would use the command idl56. This command also redefines the generic idl command to point at the selected version number in subsequent usage (in the current X11 or Terminal window only). In order to go back to the most recent version of IDL (or a different old version), the command idlNN must be run again, with the desired version number specified.



Q: All of the IPAC IDL licenses are in use. If I have my own license, how can I use the SciApps installation of IDL?


A: Follow these instructions:

  1. Close any running instances of IDL.

  2. Delete the flexnet resource file (which stores the address of the last used IDL license):

    /bin/rm ~/.flexlmrc

  3. Ensure that ~/.tcshrc includes this line:

    source /SciApps/setup/sciapps.csh force_idl

  4. Make sure that there are no other source, alias, or setenv commands involving IDL or sciapps.csh in ~/.tcshrc. If so, comment them out with a leading #.

  5. Open a new xterm window (ideally, log out then back in, but try it with just a new xterm first).

  6. Issue this command in the new xterm (use the correct path to the license file on your computer):

    setenv LM_LICENSE_FILE /usr/local/rsi/license/license.dat

  7. Start IDL. Did it work? If so, then the setenv command from the previous step can be added to ~/.tcshrc after the source /SciApps... command.

  8. If you want to add custom paths to IDL routines, use a path definition like this:

    setenv IDL_PATH +/YOUR_PATH/idl/pro:${IDL_PATH}

    This can be added to ~/.tcshrc, after the setenv LM_LICENSE_FILE... command. Note that SciApps IDL provides the latest version of the IDL astronomy library, as well as ATV and the BUIE library.



Q: How do I enable the idlwave macros in Emacs?


A: If you do not already have a .emacs file in your home directory, then copy the minimal file from the SciApps distribution using the SciApps command alias idlwave_setup. This alias actually runs the following command:


source ${SciApps_path}/setup/idlwave_setup.csh

If you do already have a ~/.emacs file, then just add the following lines to it:


(setq load-path (cons "${SciApps_longpath}/idlwave/local/share/emacs/site-lisp" load-path))
(autoload 'idlwave-mode "idlwave" "IDLWAVE Mode" t)
(autoload 'idlwave-shell "idlw-shell" "IDLWAVE Shell" t)
(setq auto-mode-alist (cons '("\\.pro\\'" . idlwave-mode) auto-mode-alist))


If any of these lines are already present in your .emacs file, then comment out the old versions of the lines before adding the new versions to your .emacs file. Running the idlwave_setup command will rename any pre-existing .emacs file in your home directory to .emacs{timestamp} before writing the new file.




FAQ: APT from STScI



Q: Why isn't APT available for my computer?


A: As of APT v19 (released in January 2011), STScI supports APT on Linux, Solaris 10, and 64-bit Intel Macs running OS X 10.5 (Leopard) and OS X 10.6 (Snow Leopard). For 32-bit Intel Macs only OS X 10.6 (Snow Leopard) is supported. Non-Intel (i.e., PowerPC) Macs are not supported. (This is due to APT's upgrade to Java 6 which is only supported on the Intel platforms.) APT requires a minimum of 512 Mb of RAM, but at least 1 Gb of RAM is recommended.

Additional Mac OS X System Configuration Issues:

  1. You must have Java up to date on your Mac (which simply means that you have the latest Mac software update).

  2. If you have Acrobat Reader configured as your default PDF viewer, you will need Adobe Reader 5.0 or higher installed on your machine. To check your version, start Adobe Reader and select "About Adobe Reader" from the Help menu.

  3. You should have the web browser plugin Shockwave 5.0 or higher for viewing the training movies. (In Safari you can check your version by clicking on "Installed Plug Ins" in the Help menu.)


Q: APT crashes on my Mac – how can I fix this?


A: The most likely culprit is an incorrect version of Java. APT will only run using Java 6 (version 1.6), which was updated into Mac OS X in mid-June of 2009. In addition, APT requires Java 6 to be the first Java version in the Java search path. In order to correct this, run


Applications → Utilities → Java → Java Preferences

Under the General tab, rearrange the available Java versions so that Java 6 is at the top of the priority list. Quit Java Preferences and run APT. You can either restore the original order in Java Preferences after finishing with APT, or leave it – having Java 6 at the top of the priority list should not have an adverse effect on other applications.


Note that Java 6 is intended for 64-bit Intel Macs. It will not run – nor will it be available as an option in Java Preferences – on a PowerPC Mac, even if it is a 64-bit PowerPC Mac, nor on a 32-bit Intel Mac. As of v19, APT is no longer supported on non-Intel Macs, and will only run on a 64-bit Intel Mac that is using either Leopard (OS X 10.5) or Snow Leopard (OS X 10.6), or on a 32-bit Intel Mac that is using Snow Leopard (OS X 10.6).




FAQ: Graphics and Plotting Software



Q: How do I initialize SuperMongo (sm) before running it for the first time?


A: This is accomplished by creating a .sm file in your home directory that defines the correct paths to a number of SuperMongo configuration files. This can be accomplished by running the SciApps SuperMongo setup script using the SciApps command alias sm_setup. This alias actually runs the following command:


source ${SciApps_path}/setup/sm_setup.csh

This process only needs to be done once, before the first time you run SuperMongo. An existing .sm file in your home directory will be renamed to .sm{timestamp} before the script writes the new file.



Q: How do I initialize the WIP interactive graphics package (wip) before running it for the first time?


A: This is accomplished by creating a .wipinit file in your home directory that defines a number of environment variables used by wip, and can be used to add your own customizations. This can be accomplished by running the SciApps WIP setup script using the SciApps command alias wip_setup. This alias actually runs the following command:


source ${SciApps_path}/setup/wip_setup.csh

This process only needs to be done once, before the first time you run WIP. An existing .wipinit file in your home directory will be renamed to .wipinit{timestamp} before the script writes the new file.



Q: How do I run gimp on a solaris computer?


A: For the Your Little Dog (Jan 2010) release of SciApps for solaris, the possibility of installing an up-to-date version of the GNU Image Manipulation Program (gimp) was investigated. Unfortunately, this was found to be impossible, due to its dependence on a large number of libraries and associated applications that are missing or out of date on IPAC solaris computers.


An older version of gimp is currently available in /opt/TWWfsw/bin on IPAC solaris machines; however, to successfully start this version of gimp, you will probably have to use the somewhat clunky command

unsetenv LD_LIBRARY_PATH ; /opt/TWWfsw/bin/gimp & ; source ~/.tcshrc

to get around a GLIB incompatibility issue. This command could be aliased to "gimp" in your ~/.tcshrc file.




FAQ: Astronomical Image Display and Analysis Software



Q: I'm using a PowerPC Mac with the Tiger (OS X 10.4) operating system. Is there a version of DS9 that I can use?


A: Yes. PowerPC Macs (macosx) running OS X 10.4 (Tiger) require an older and specific version of DS9. With a full SciApps initialization, the command ds9_5.1_ppctiger will run the correct version. If you are not using all of SciApps, but wish to create a command alias just for this version of DS9, then put the following line in your ~/.cshrc or ~/.tcshrc file:


alias ds9 /SciApps/NEW/macosx/bin/ds9_5.1_ppctiger

Please consider upgrading to Mac OS X 10.5 (Leopard) if you want to be able to use the full functionality of SciApps.



Q: I'm using an Intel Mac with the Tiger (OS X 10.4) operating system. Is there a version of DS9 that I can use?


A: Yes. With a full SciApps initialization, the command ds9_5.6_inteltiger will run the correct version. If you are not using all of SciApps, but wish to create a command alias just for this version of DS9, then put the following line in your ~/.cshrc or ~/.tcshrc file:


alias ds9 /SciApps/NEW/macintel/bin/ds9_5.6_inteltiger

Please consider upgrading to Mac OS X 10.5 (Leopard) if you want to be able to use the full functionality of SciApps.



Q: When I run skyview with the -n24 option, it crashes with an error message that looks like this:


Fatal error: can't find file rgb.txt

How can I fix this?


A: The -n24 option causes skyview to execute in 24-bit mode with no graphics (i.e., without invoking X11). However, skyview still needs one resource that it usually gets from X11; namely, a table of the colors with RGB values for each color. In the absence of X11, skyview looks for the file rgb.txt in a standard place: /usr/lib/X11. If rgb.txt is not located in that directory, then skyview will crash. The following table gives the standard location for rgb.txt under different operating systems.


OSRGBFILE
macintel /usr/X11/share/X11
macosx /usr/X11/share/X11
linux /usr/X11R6/lib/X11
solaris /usr/openwin/lib/X11

The SciApps initialization defines these locations for rgb.txt. However, if the file is in a different location on your system, then you will first have to locate it, and then redefine the environment variable RGBFILE; for example, by including a line like


setenv RGBFILE /usr/X11R6/lib/other

in your ~/.tcshrc file after the command to source the SciApps set-up script.


Q: I upgraded my Mac from Tiger to Leopard, and now the colors are gone from the overlays in skyview – what's going on?


A: The skyview developers have been notified of this bug, but do not currently know its origin. A workaround is to invoke skyview as follows:


skyview -visual TrueColor



FAQ: Miscellaneous



Q: How do I request additional help with SciApps?


A: Submit a ticket to the ISG Helpdesk. Active SciApps support (e.g., installing updates, answering Helpdesk tickets, etc) is provided on Tuesdays and Thursdays.



Q: I'm new to using a Mac computer – help!


A: A number of useful tips for configuring your Mac in astronomer-friendly ways are compiled at D. W. Hoard's Mac OS X Configuration Tips web page.



Q: Why isn't python available in SciApps?


A: Actually, the python software itself is available by default on all of the operating systems supported by SciApps. For macintel6, python 2.6 and 2.5 are in /usr/bin; for macintel5 and macosx, python 2.5 is in /usr/bin; for linux, python 2.4 is in /usr/bin; and for solaris, python 2.4 and 2.3 are in /opt/TWWfsw/bin. Starting with the Doomsday Machine (Feb 2011) SciApps distribution for macintel, a more recent version of python is provided.


The real question here should be: “why isn't the vast array of associated python libraries that provide scientific applications available in SciApps?”


Well, some of them are included in SciApps (for macintel5 and macintel6); namely PyRAF and the associated STScI tasks for analyzing Hubble Space Telescope data that only run under PyRAF. In addition, a few packages of more general usefulness are installed as part of stsci_python; these include numpy and ipython. However, after considerable testing of installation procedures and assessing the level of effort required for future installation support and updates, it was determined that it is not feasible to support an extensive package of python scientific tools within SciApps at the present time.


Alternatively, a simple package installer that provides python and numerous associated scientific libraries is available for all operating systems (except macosx – the software requires an Intel processor, so cannot be used with a PowerPC Mac). If you are interested in utilizing python and its associated scientific libraries, then please download and install the Python Distribution from Enthought Scientific Computing Solutions. This is commercial software that normally requires purchase of a license. However, Enthought provides a free version of the software for academic use (free to students and employees of degree-granting institutions). Simply point your web browser at the Enthought Academic Download page, select your operating system, and provide your name, email address, and institution (i.e., “California Institute of Technology”). You may choose to select or deselect the box allowing Enthought to send you email, as desired (note that it is selected to opt in by default). After the installer has downloaded, follow its instructions (e.g., on Mac computers, this amounts to double-clicking on the installer .dmg file to open it, double-clicking on the “EPD.mpkg” file to start the installation, and then accepting all of the default choices).


If you are not comfortable performing the Enthought Python Distribution installation procedure, then contact the SciApps Administrator for assistance.


A few additional notes about the Enthought Python Distribution (EPD):


  1. As of the current (Feb 2010) version (v7.0), the EPD delivers python 2.7 and 75+ associated scientific libraries, including numpy, scipy, matplotlib, and ipython. The complete list of packages can be found here.
  2. The one potential drawback of the free academic version of the EPD is that it is restricted to 32-bit operations. If you find that you require 64-bit functionality, then currently your only option is to purchase a licensed version of the EPD.
  3. Installation on Mac computers requires entry of an Administrator level password. If you do not have this for your computer or are unsure how to proceed, then please submit a ticket to the ISG Helpdesk to request assistance with the installation.
  4. During installation, you will be asked to allow the installer to modify your shell configuration file. Do not be alarmed, this is OK. This simply ensures that the path to the installed EPD software is provided to your OS so you can run the software. For example, on Mac computers, the EPD installer places software in the /Applications folder (in a folder called “EPD32-7.0” for version 7.0 of the EPD) as well as at /Library/Frameworks/Python.framework/Versions/7.0. The installer then makes a backup copy of your current ~/.tcshrc file, and appends the lines

    # Setting PATH for EPD-7.0
    # The orginal version is saved in .cshrc.pysave
    set path=(/Library/Frameworks/Python.framework/Versions/Current/bin $path)

    to the active version of ~/.tcshrc. The new path will be implemented in any new windows that you start, or globally after you log out and back in. This modification to ~/.tcshrc will not interfere with the SciApps initialization command that is also contained in this file.


Q: Why isn't AIPS available in SciApps?


A: A straightforward installation of AIPS with access for multiple users requires a generic computer user group name and permission for all users to have write access to parts of the AIPS installation directory. However, there is no common “generic” group id that covers everyone at IPAC and, more importantly, users do not have write access to the /SciApps partition. Past SciApps installations of AIPS have been hacked to get around these requirements, but this has not been conducive to keeping AIPS up to date since the whole thing has to be torn down and remade each time it is updated. Fortunately, a self-updating, single-user, binary installation of the current (and future) version of AIPS is now easy and painless on all platforms, using the installer script provided by NRAO.


Given the relatively small number of regular AIPS users at IPAC (as per the SciApps User Survey), it was decided to no longer support a system-wide distribution of AIPS. Instead, installation of AIPS will be done on a case-by-case basis. If you want to install AIPS yourself, then please follow the instructions for a binary installation on the AIPS web page; otherwise, you may contact the SciApps Administrator for assistance.



Q: Why isn't HEASOFT available in SciApps?


A: All HEASOFT tasks can now be run remotely using the Hera data analysis service at HEASARC. Hera provides all of the HEASARC software packages, local disk space, and computing resources needed to do general processing of FITS format data files residing on the user's local computer, and to do advanced research using the publicly available data from High Energy Astrophysics missions. Because of the small number of HEASOFT users at IPAC, a local installation of HEASFOT will not be maintained as part of SciApps. Please utilize the Hera service instead.


To use HEASOFT through Hera, start the Fv image viewer (which is maintained as part of SciApps), select Connect to Hera... from the main menu window, then follow the on-screen instructions to establish a Hera user account. See “Getting Started with Hera” and “Frequently Asked Questions about Hera” for additional information.



Q: What else do I need to know about using TeX/laTeX in SciApps?


A (macintel/macosx): SciApps for macintel and macosx contains the BasicTeX version of MacTeX, which is accessed from the command line only. BasicTeX is utilitarian but perfectly functional; the SciApps version has been supplemented to include the aastex and emulateapj class files, and the apjfonts and txfonts packages. Contact the SciApps Administrator if you are interested in installing the full, GUI-enabled version of MacTeX on your computer.


Apply the emulateapj class using the following command in the .tex file preamble:

\documentclass[iop]{emulateapj}

For best results, also use the ApJ fonts package:

\usepackage{apjfonts}

and then compile the postscript output using:

dvips -Papjfonts -o filename.ps filename

Versions of the emulateapj style file starting with 16Feb10 are not backwards compatible with versions of BasicTeX prior to 2009.


A (linux/solaris): TeX is installed by default in /usr/bin/ on linux computers and in /opt/TWWfsw/bin/ for solaris computers. In order to make the aastex or emulateapj macros available, SciApps defines the TEXMFHOME environment variable on linux and solaris computers to point to the corresponding SciApps installation directory; that is


setenv TEXMFHOME /SciApps/NEW/linux/tex/texmf

or

setenv TEXMFHOME /SciApps/NEW/solaris/tex/texmf


Q: Why don't any of the fortran compilers for macintel or macosx work?


A: When trying to use any of the SciApps fortran compilers (g77, g95, gfortran) for macintel or macosx, if you receive an error message similar to

gfortran: error trying to exec ‘as’: No such file or directory

or

g77: installation problem, cannot exec ‘as’: No such file or directory

then the problem is that you do not have gcc installed on your computer. Strangely enough, the fortran compilers require you to have a C compiler installed, because they share the same assembler (i.e., the ‘as’ that cannot be found).


Under Mac OS X, gcc is not installed with OS X by default, and must be installed on your computer from the “Xcode Tools” (or, on recent installations, just “Xcode”) package inside the “Optional Installs” folder on the original OS X installation DVDs that came with your computer. This process requires root level access to your computer, so please contact ISG to install the Xcode Tools.



Q: Why doesn't CIAO work (completely) on Solaris computers?


A: Currently, the prism and sherpa tasks in the solaris installation of CIAO are unusable due to compatibility problems that are being worked with the Chandra Help Desk. If possible, these tasks will be repaired and released as an interim update to the solaris SciApps. The chips task in CIAO for solaris will not work in a remote display environment, so this task will not function under SciApps. This is due to an incompatibility in the Solaris X server, and cannot be repaired. If you require access to any of these non-functioning CIAO tasks, and you are limited to only a solaris computer, then please contact the SciApps Administrator for assistance in either utilizing CIAO on a different platform or installing it locally on your solaris computer. Please note that CIAO is fully functional in the macintel and linux distributions of SciApps.