==========================================================
==            OSIRIS Calibration Pipeline               ==
==========================================================

License:
(C) 2004-2010 Stubbe F. Hviid - all rights reserved

A license is provided for calibrating OSIRIS images
All other rights are reserved


Prerequisites
-------------

The OSIRIS calibration softwar ehas been developed using IDL 6.1 - 6.3 on a microsoft windows platform.
While the software may likely work on other platforms the cannot be guarantied.



Installation of the Osiris Calibration Pipeline software:
---------------------------------------------------------

1. Copy the <osiris_calibration_pipeline> directory to some location in
your IDL tree (must be a location included in a recursive IDL path member).

2. Open the <osiris_calibration_pipeline>/osiris_environment.pro in a text editor.

3. Modify the <root_path> variable to point to the fully qualified path to the
<osiris_calibration_pipeline> directory

Done


Dependensies:
-------------

The Fairwood PDS library must be installed (included in the EXTRAS/SOFTWARE folder of the PDS archive)


Note:
-----

The calibration pipeline was developed within the instrument team, where uncalibrated
data is commonly refered to as level 1, whereas radiometrically corrected data is known
as level 2.

To calibrate an image:
----------------------

1. Read in image using:
        p_read, <filename>, header, data

2. Calibrate the image using:
   om = osiris_level1_to_level2(header, data, header_out, data_out)

3. Optionally save the image to disk using:
        p_write, <filename>, header_out, data_out

