Merge pull request #27 from kdl222/m03887

<application name="mdis2isis" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://isis.astrogeology.usgs.gov/Schemas/Application/application.xsd">

  <brief>

    Import MESSENGER/MIDS EDR/RDR products into ISIS cubes

    Import MESSENGER/MDIS EDR/RDR products into ISIS cubes

  </brief>

  <description>

    <p>

       mdis2isis converts PDS labelled MESSENGER/MDIS EDRs to ISIS labels.

      MDIS has a narrow angle camera (MDIS-NAC) and a wide angel camera (MDIS-WAC)

      with twelve filters.  This application will convert all these observations to ISIS format.

      The resulting ISIS cubes are ready for SPICE initialization and projection.

      This program, mdis2isis, converts PDS-labelled Mercury Dual Imaging (MDIS)

      Experiment Data Record (EDRs) or Reduced Data Records (RDR) to ISIS labels.

      MDIS has a narrow angle camera (NAC) and a wide angle camera (WAC)

      with twelve filters. These observations, using mdis2isis, are converted to

      ISIS format, and the resulting ISIS cubes are ready for SPICE initialization and projection.

    </p>

    <p>

      Some of the images are compressed onboard the spacecraft.  When this is 

      detected, they are unlutted and each DN is converted to its precompressed 

      12-bit DN value.  All output files are created in floating point DN 

      format.

      Some MDIS-images are compressed onboard the spacecraft.  When such

      compression is detected by mdis2isis, each DN is converted to its

      pre-compressed, 12-bit DN value using the original Lookup Table (LUT).

      All output files are created in floating point DN format.

    </p>

    <p>

      There are DN limits that are imposed on the output pixel.  For the NAC

      instrument, the valid range is 0 < DN < 3400.  The limit for the WAC

      is 0 < DN < 3600.  For both instruments, 0 values are mapped to the

      NULL special pixel value.  And values that exceed the maximum are set to 

      NULL special pixel value.  Values that exceed the maximum are set to

      the HIS (high instrument saturation) special pixel value.

    </p>

  </description>

        Added appTest

    </change>

    <change name="Steven Lambright" date="2007-12-10">

        Added lookup table capabilities

        Added Lookup Table capabilities

    </change>

    <change name="Steven Lambright" date="2007-12-11">

        Fixed problem where labels went outside the IsisCube object

        OrbitNumber keyword to the translation tables for inclusion in the

        Archive group.

    </change>

    <change name="Kaitlyn Lee" date="2018-01-17">

        Reworded application description to make it more understandable.

    </change>

  </history>

  <groups>

        <description>

          Output file converted from PDS EDR format to ISIS.  This ISIS file will have all the

          information transferred from the PDS EDR file that is necessary to

          initialize for geometric processing (see spiceinit, cam2map, etc...).

          initialize for geometric processing (see spiceinit, cam2map, etc).

        </description>

        <filter>

          *.cub

            <type>string</type>

            <brief>Provide observation target if not in EDR</brief>

            <description>

                This parameter may be necessary as some EDR labels do not adequately defined

                This parameter may be necessary as some EDR labels do not adequately define

                the TARGET_NAME keyword in the labels.  Messenger takes a very long trip to

                finally arrive at Mercury orbit in 2011.  During cruise, many flybys occur.  The

                proper specification of the TARGET_NAME is critical to valid instantiation of

                ISIS camera models.

                At the time of the original writing of this application, NULL was a frequently

                occuring value of the TARGET_NAME keyword even for flyby encounters.

                This keyword allows one to specify the observed body explicitiy for these cases.

                When this application was originally written, NULL was a frequently

                occurring value of the TARGET_NAME keyword even for flyby encounters.

                This keyword allows one to specify the observed body,

                as many flybys occurred, explicitly for these cases.

                The default is to honor the value in the EDR label as it is anticipated this will be

                corrected in subsequent EDR generation.

          Convert 8-bit values to 12-bit values

        </brief>

        <description>

          If this is set to true, and the input cube is lutted, a lookup table 

          If this is set to true, and the input cube is lutted, a Lookup Table

          will be used to convert the original DN values to their original

          12-bit values. This must be set to true for calibration.

        </description>