The JWST calibration pipeline software is available for installation from AstroConda, which is a free Conda channel maintained by the Space Telescope Science Institute (STScI) in Baltimore, Maryland. This channel provides tools and utilities required to process and analyze data from the Hubble Space Telescope (HST), James Webb Space Telescope (JWST), and others.
Conda is an open source package management system and environment management system for installing multiple versions of software packages and their dependencies and switching easily between them. It works on Linux, OS X and Windows, and was created for Python programs but can package and distribute any software. On-line Conda documentation provides full details on the inner workings of this management system. Briefly, Conda is a package manager application that quickly installs, runs, and updates packages and their dependencies. The conda command is the primary interface for managing installations of various packages. It can query and search the package index and current installation, create new environments, and install and update packages into existing conda environments.
You must have the Conda software installed before you can install the JWST package from the AstroConda channel. Full details on downloading and installing Conda can be found here. In a nutshell, you:
- Download the appropriate version of Anaconda for your system's OS from the Anaconda download page
- Follow the directions on the download page for installing the package on your system
NOTE: Command-line installation and operation of Conda requires use of the bash shell on Linux and OS X systems.
In order to use Conda to install packages directly from the STScI AstroConda channel you will need to append our URL to Conda’s channel search path.
$ conda config --add channels http://ssb.stsci.edu/astroconda # Writes changes to ~/.condarc
The package management system Conda is now configured to pull from our repository, so you may go ahead and install the
stsci package. This package installs nearly all of the software provided by STScI in one shot, including the JWST calibration pipeline package.
The following example generates a new conda environment on your system named “astroconda”, however this naming convention is merely a suggestion. Feel free to use a name that works best for you.
$ conda create -n astroconda stsci
Using the Software
After the installation is complete go ahead and activate the “astroconda” environment. This command only needs to be executed one time per terminal session.
$ source activate astroconda
Anytime that you terminate and reactivate a terminal window or session and want to use the environment again, you will need to reactivate the environmen, using the above command.
To deactivate the “astroconda” environment or switch to another conda environment on your system, close your terminal window or run:
$ source deactivate
You can then activate any other environment on your system.
From time to time STScI will make updates available for the JWST package and dependent packages. You can download and install updates by updating your conda environment with:
$ conda update -n astroconda stsci
where "astroconda" is the name of the environment on your system and "stsci" is the package to be updated. Conda will automatically search for and install updated versions of all packages contained in "stsci".