1 SID_DISPLAY
2 GET_FILE2TIME
 PROJECT:
       SOHO - SUMER

 NAME:
       GET_FILE2TIME()

 PURPOSE: 
       Get Filename by time before actual file and after

 CATEGORY:
       SUMER/CD
 
 EXPLANATION:
       
 SYNTAX: 
       Result = get_file2time(time_val)

 EXAMPLES:
       
 INPUTS:
       time_val - Time value in long TAI

 OPTIONAL INPUTS: 
       CD_STAT_LOC:cd_science.wrk  file

 OUTPUTS:
       Result - 0 = nosuccess
                1 = success

 OPTIONAL OUTPUTS:
       Via Keywords (see Keywords)

 KEYWORDS: 
       before - Filename one before actual file
       next - Filename one after actual file

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, December 12, 1996, Dietmar Germerott, MAPE Lindau. Written

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)
 
2 GET_FILE4DATE
 PROJECT:
       SOHO - SUMER

 NAME:
       GET_FILE4DATE()

 PURPOSE: 
       Select a file from file_list via date_string

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = get_file4date()

 EXAMPLES:
       
 INPUTS:
       date_string - Date String
       file_list   - String or String Array of Filenames   

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       Filename corresponding to date_string

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       ERRMSG - Returns possible Error Message
       FILE_NUM - Returns the position of file in list
       NEAREST - look for nearest Date if not direct available   
   
 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, December 30, 1997, Dietmar Germerott, MPAE Lindau. Written
       Version 1.1, January 30, 1998, Dietmar Germerott, MPAE Lindau
           added NEAREST KEYWORD to look for nearest Date file if
           there is no File for this specific Date

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 GET_IMAGE4POINTER
 PROJECT:
       SOHO - SUMER

 NAME:
       GET_IMAGE4POINTER()

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = get_image4pointer()

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, December 29, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 READ_BIN_HEADER
 PROJECT:
       SOHO - SUMER

 NAME:
       READ_BIN_HEADER()

 PURPOSE: 
       Read SUMER binary 100 Byte Header from File

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = read_bin_header(filename)

 EXAMPLES:
       
 INPUTS:
       filename - File of SUMER Image Headers

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       Either Bytearray (100,n) or SUM_IMAGE_HEAD - Structure

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       decode - decode Headers with SUM_IMAGE_HEAD and return Structure
       count - returns the number of Headers
       errmsg - returns the Error message

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, December 29, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SID_COMMON_PRIV
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_COMMON_PRIV

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       @sid_common_priv 

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, November 14, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linsu1.mpae.gwdg.de)
 
2 SID_DISPLAY
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_DISPLAY

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       sid_display, 

 EXAMPLES:
       
 INPUTS:
       None.

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       group -

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, October 29, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linsu1.mpae.gwdg.de)
 
2 SID_GETHEAD4DATE
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_GETHEAD4DATE()

 PURPOSE: 
       Read in the SUMER Image Header for the specified Date

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sid_gethead4date()

 EXAMPLES:
       
 INPUTS:
       date_string - Date in any form for anytim2utc

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, November 17, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linsu1.mpae.gwdg.de)
 
2 SID_GETHEAD4ID
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_GETHEAD4ID()

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sid_gethead4id()

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, November 24, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SID_GRAPH_STC
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_GRAPH_STC()

 PURPOSE: 
       Init SID Graphic Information Structure

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sid_graph_stc()

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, January 9, 1998, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SID_INIT
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_INIT

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       sid_init, 

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, November 14, 1997, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linsu1.mpae.gwdg.de)
 
2 SID_MINDEC_HEAD
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_MINDEC_HEAD()

 PURPOSE: 
       Decode SUMER Image Head to Structure with minimal tags for sid

 CATEGORY:
       SUMER - DATA
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sid_mindec_head()

 EXAMPLES:
       
 INPUTS:
       header - SUMER Image header BYTARR(92-)

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       num_of_header - returns the number of headers
       errmsg - returns the ERROR String   

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, January 6, 1998, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SID_QUERY
 PROJECT:
       SOHO - SUMER

 NAME:
       SID_QUERY.PRO()

 PURPOSE: 
       

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sid_query()

 EXAMPLES:
       
 INPUTS:
       

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       None.

 COMMON:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, January 29, 1998, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SUM_HEAD2IMAGE
 PROJECT:
       SOHO - SUMER

 NAME:
       SUM_HEAD2IMAGE

 PURPOSE: 
       Produce the Imag files for the selected Headers

 CATEGORY:
       SUMER Image Preparation
 
 EXPLANATION:
       
 SYNTAX: 
       sum_head2image, filename='binary_header_file'

 EXAMPLES:
       
 INPUTS:

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       filename - Input file containing binary Headers   
       bin_header - Array of binary Header   
       struct_header - Array of Header Structure (MINDECODED)
       out_path - Output Path for Image files
       saverst - set for Restore file creation
       helpp - get help about usage   
   
 COMMON:
       None.

 RESTRICTIONS: 
       calls read_bin_header, get_image4pointer, sum_save_image

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, January 14, 1998, Dietmar Germerott, MPAE Lindau. Written

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linmpi.mpg.de)
 
2 SUM_IMAGE_HEAD
 PROJECT:
       SOHO - SUMER

 NAME:
       SUM_IMAGE_HEAD()

 PURPOSE: 
       Decode SUMER Image Head to Structure

 CATEGORY:
       SUMER - DATA
 
 EXPLANATION:
       
 SYNTAX: 
       Result = sum_image_head(header [,num_of_header=num_of_header])

 EXAMPLES:
       
 INPUTS:
       header - SUMER Image header BYTARR(92..)

 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       Result - Structure or -1.0 in case of error

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       num_of_header - returns the number of headers
       errmsg - returns the ERROR String   

 COMMON:
       None.

 RESTRICTIONS: 
       CALL TAI2UTC, OBT2TAI, IEEE_TO_HOST, DATATYPE
       The Structure Tag UTC_VMS contains a string only
       if the number of headers is less 1024.
   
 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, December 1, 1996, Dietmar Germerott, MAPE Lindau. Written

 CONTACT:
       Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)
 
2 SUM_SAVE_IMAGE
 PROJECT:
       SOHO - SUMER

 NAME:
       SUM_SAVE_IMAGE

 PURPOSE: 
       Write a standard savefile either restore or binary

 CATEGORY:
       
 
 EXPLANATION:
       
 SYNTAX: 
       sum_save_image, header_data, image_data 

 EXAMPLES:
       
 INPUTS:
       head - sumer image header
       image_data - sumer image data   
   
 OPTIONAL INPUTS: 
       None.

 OUTPUTS:
       None.

 OPTIONAL OUTPUTS:
       None.

 KEYWORDS: 
       saverst - make IDL-Restore file
       out_path - directory where to write
   
 COMMON:
       None.

 RESTRICTIONS: 
       need write access to outpath or default directory

 SIDE EFFECTS:
       None.

 HISTORY:
       Version 1, September 18, 1997, Dietmar Germerott, MPAE Lindau. Written
       Version 2, November 3, 1997, Dietmar Germerott, MPAE Lindau
            added Imageformat to Filename to make it uniq 
            (in case of Flatfield ther could be a double Filename)

 CONTACT:
       Dietmar Germerott, MPAE Lindau (Dietmar Germerott@linsu1.mpae.gwdg.de)
 
