If you do not have an IDL license, the GPI Data Reduction Pipeline is distributed as compiled code along with the IDL runtime.
Note
If you do have an IDL license, there’s nothing stopping you from installing these compiled versions of the code instead of the source if you want to; it’s just not required!
The distribution ZIP files for the GPI pipeline come in two flavors:
- A platform-independent ZIP file containing only the compiled pipeline code itself. To use this file, you must download and install the IDL runtime virtual machine yourself. It may be obtained from Excelis.
- Platform specific ZIP files that contain the compiled pipeline code plus the IDL runtime virtual machine for a given operating system. These contain everything you will need to start the GPI pipeline on that OS.
Obtain the desired zip file and uncompress it to a directory of your choosing. Remember this path for use when configuring DRP paths in the next section.
Download Links for Prior Versions can be found below if desired
Before you can start the pipeline, you will need to do some basic configuration to set up your environment. This is an abbreviated version of the full set of configuration options described in Configuring the Pipeline.
Mac OS X, Linux
After downloading and unzipping, set up your shell for the pipeline (update the pipeline version number, 1.2.0_r3401, with the version you downloaded)
unix% cd [Location of the pipeline]/gpi_pipeline_1.2.0_r3401/scripts/
unix% ./gpi_setup_nix
unix% cd ../executables/
unix% cp -r idl83 idl81
This will set up most of what’s needed in the file .gpienv (in your home directory), and provide the copy of IDL in the directory expected by the pipeline, but the following changes are also needed. Enter these lines into your copy of .gpienv
export GPI_DRP_DIR="[Location of the pipeline]/gpi_pipeline_1.2.0_r3401"
export IDL_DIR="[Location of the pipeline]/gpi_pipeline_1.2.0_r3401/executables/idl81"
alias idl="[Location of the pipeline]/gpi_pipeline_1.2.0_r3401/executables/idl81/bin/idl"
Remember to restart your terminal for these changes to go into effect.
See Configuring the Pipeline if you need more information on how to set an environment variable.
Windows
The zip file contains, among other things, a directory called executables which contains .sav files needed by the Virtual Machine to run the pipeline:
- gpi_launch_pipeline.sav starts the main data reduction session and status console
- gpi_launch_guis.sav starts the GUI session, including a launcher window that will allow the user to start the various GUIs.
- gpitv.sav starts GPItv alone.
How to start the compiled code varies by operating system.
Mac OS X
On Mac OS X, the executables directory contains three Applescript files corresponding to the above named .sav files. Double click any of these to start that component of the pipeline. You can also start compiled code from the command line
unix% idl -rt=/path/to/executables/gpi_launch_pipeline.sav
To conveniently start both required IDL sessions at once, there is a shell script scripts/gpi-pipeline which launches two xterms and starts the pipeline and GUIs sessions in them.
You may need to set the environment variable IDL_DIR to the executables\idl## directory.
Linux
There are scripts inside the $GPI_DRP_DIR/executables directory that you can use to start the pipeline. The following two commands should start the pipeline IDL sessions:
unix% $GPI_DRP_DIR/executables/gpi_launch_pipeline
unix% $GPI_DRP_DIR/executables/gpi_launch_guis
You can also start IDL directly from the command line and supply one of the sav files:
unix% idl -rt=/path/to/executables/gpi_launch_pipeline.sav
unix% idl -rt=/path/to/executables/gpi_launch_guis.sav
You may need to set the environment variable IDL_DIR to the executables\idl## directory for this to work.
To conveniently start both required IDL sessions at once, there is a shell script scripts/gpi-pipeline which launches two xterms and starts the pipeline and GUIs sessions in them. If you encounter problems when using this, just manually start both the pipeline and GUI sessions as shown above.
Windows
On Windows, the executables directory contains three .exe files corresponding to the above named .sav files. Double click any of these to start that component of the pipeline.
You must manually start both the pipeline and GUIs sessions to use the pipeline interactively.
For any of the above OSes, you may also manually start the IDL Virtual Machine by itself, and it will present you with a file dialog for browsing to and selecting a .sav file to run. See the Exelis documentation on starting a runtime application for more information.
If you have followed these steps successfully, you have installed the pipeline code. Proceed now to Configuring the Pipeline.