ALPHA GUI for OMEGA SOFTXX software


LICENSE

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published
    by the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

    Harald van der Werff, University of Twente, 2017


ABOUT

    ALPHA is a GUI for the IDL ''SOFTXX'' software published by the OMEGA
    science team. The SOFTXX software is designed for batch processing 
    under UNIX/Linux. This IDL script adds a simple interactive GUI.
 
    The output of ALPHA consists of 5 images in ENVI format (binary file with a separate
    ASCII header) and an ASCII file:
       <filename>_mola     - MOLA altitude data
       <filename>_lonlat   - LONLAT data for building a GLT
       <filename>_idat     - OMEGA raw data 
       <filename>_jdat     - OMEGA radiance data 
       <filename>_geocube  - Housekeeping data   
       <filename>_specmars - Solar spectrum at data acquisition 
   
    The basename of the output files is taken from the OMEGA scene that is processed.
    For example, OMEGA scene 'ORB0422_4' will result in filename 'ORB0442_4_jdat'
    for the radiance data.
 
INSTALLATION

    The Alpha software comes in 2 files: an IDL source file and an ASCII patch 
    file. The IDL code creates the GUI, runs the SOFTXX software and saves the 
    output to disk. It calls the main routine of the SOFTXX software, the script
    'readomega.pro', via a newly added procedure header that is defined in the 
    patch file.
 
    Under UNIX/Linux, the patch can directly be applied using the 'patch' program:

      :~$ cd <path-to>/SOFTXX
      :SOFTXX $ cp readomega.pro hw_alpha_omega.pro
      :SOFTXX $ patch hw_alpha_omega.pro < hw_alpha_omega.patch
  
    Alternatively, or under Windows, please study the patch file and manually
    edit the lines that need to be added or removed from alpha_omega.pro:
 
      +pro hw_alpha_omega,fname,idat,jdat,geocube,alt,lati,longi,specmars,orbnum,wvl,ic
      +
  
      -print,'OMEGA observation: '
      -read,nomfic0
      +;print,'OMEGA observation: '
      +;read,nomfic0
      +nomfic0=fname
  
       if (errflag ne 0) then begin
         print,'file ',nomfic,' not found'
      -  goto, start
      +  ;goto, start
      +  return
       endif
  
    After patching, both IDL procedures (hw_alpha.pro and hw_alpha_omega.pro) should be copied
    into the SOFTXX directory. You can start hw_alpha.pro using the IDL workbench (File -> Open)
    or, in UNIX/Linux, by running it from the command line:
  
      :~$ idl
      IDL> cd, 'path-to-SOFTXX'
      IDL> .compile hw_alpha
      IDL> hw_alpha
  

RUNNING ALPHA
 
    In the GUI, you have to set the following paths:
 
     - The path to the OMEGA .QUB file
     - The path to the OMEGA .NAV file (follows automatically the .QUB selection)
     - The path to the SOFTXX directory
     - The path to the output directory
 
    By default, ALPHA outputs the idat, jdat, alt and latlon files. The geocube image and
    specmars ASCII file can be added by selection buttons, as can other files be de-selected.


BUGS

    Undoubtedly. Happy hunting, and let me know what you caught :-)


FEEDBACK

    Please! Email them to harald.vanderwerff (at) utwente (dot) nl