.. _installing-from-zips:

Installing from Software Release Zip Files
=============================================

This section describes how to install the pipeline from Zip files containing
released source code of the pipeline. This is appropriate for anyone who **has** a
full copy of IDL, but does not immediately intend to contribute to ongoing
pipeline development. 

.. note::
    This method requires you have an IDL license. If you do not have an IDL
    license, please refer to  :ref:`this page <installing-from-compiled>` for 
    installing compiled executables instead.

**Version 1.4.0** (2016 July):
 * `gpi_pipeline_1.4.0_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_1.4.0_source.zip>`_ -  GPI pipeline source code 


See :ref:`here <priorversions>` to download earlier versions of the pipeline, if desired.

.. comment:
 **Version 1.3.0** (2015 March 16):
 * `gpi_pipeline_1.3.0_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_1.3.0_source.zip>`_ -  GPI pipeline source code 
 **Version 1.2.0** (2014 Oct 30):
 * `gpi_pipeline_1.2.0_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_1.2.0_source.zip>`_ -  GPI pipeline source code 
 **Version 1.1** (2014 May 6):
 * `gpi_pipeline_1.1.1_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_1.1.1_source.zip>`_ -  GPI pipeline source code 
    **Version 1.0.0** (2014 Feb 14):
     * `gpi_pipeline_1.0_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_1.0_source.zip>`_ -  GPI pipeline source code 
    **Version 0.9.4** (2014 Jan 7):
     * `gpi_pipeline_0.9.4_r2360_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_0.9.4_r2360_source.zip>`_ -  GPI pipeline source code (available for reference)
    **Version 0.9.2** (2013 Sept 5):
     * `gpi_pipeline_0.9.2_r1926_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_0.9.2_r1926_source.zip>`_ -  GPI pipeline source code, including all dependencies
    **Version 0.9.1** (2013 July 18):
     * `gpi_pipeline_0.9.1_source.zip <http://www.stsci.edu/~mperrin/gpi/downloads/gpi_pipeline_0.9.1_source.zip>`_ -  GPI pipeline source code, including all dependencies



Unzip this file in a directory that is a part of your ``$IDL_PATH`` (To determine where your ``$IDL_PATH`` is, type ``echo $IDL_PATH`` in a terminal prompt.

.. admonition:: Mac OS and Linux

    .. image:: icon_mac2.png

    .. image:: icon_linux2.png
  
  On Mac OS and Linux, you will likely want to add the ``pipeline/scripts`` subdirectory
  to your shell's ``$PATH``. How you do this depends upon your chosen shell (sh, csh, tcsh, bash etc). This is addressed in the :ref:`configuring` section. 


.. warning::
   The usual caveats about name collisions between different versions of IDL routines apply.
   If you have old versions of e.g. the Goddard IDL library functions in your ``$IDL_PATH``, 
   you may encounter difficulties. We suggest placing the data pipeline code first in your ``$IDL_PATH``. More information can be found in the :ref:`frequently-asked-questions` section. 
   

Proceed now to :ref:`configuring`.