PDS_VERSION_ID     = PDS3
RECORD_TYPE        = STREAM
OBJECT             = TEXT
  PUBLICATION_DATE = 2006-04-27
  NOTE             = "User's guide for createMiniTEStable software"
END_OBJECT         = TEXT
END

CreateMiniTEStable.exe is a tool to create an ASCII table version of a MER 
Mini-TES BTR, EMR, or RDR data product. It is a command line application 
written in C#, that can be executed on Windows, Mac OSX, and Linux. The 
application source code is included as well.

This tool was developed by Dan Scholes at Washington University for the MER 
Project and is included in the Mini-TES archives.

How to Run the Program
----------------------

Windows:
Copy the executable file createMiniTEStable.exe from the bin subdirectory 
to a directory on your local system. Run the program from the command line 
with this command:

   createMiniTEStable.exe <input> <output>

where <input> is a Mini-TES data file and <output> is a new file containing 
the ASCII table generated by the program. The desired full file path can be 
specified on the command line for the <input> and <output>. If full file
paths are ommitted, the application will search the current execution folder 
for the input file and save the output file to the same folder.

Linux and Mac OSX:
This application has been successfully tested on Linux Red Hat and Mac OS X.
To run the program on one of these operating systems, the user will need
to have Mono Project software installed. Mono Project allows C# code to
run on these operating systems. A variety of free installs can be found at 
the following url: http://www.mono-project.com/Downloads/
When installing Mono, only the Mono Core is required to run the 
createMiniTEStable application. 

After installation of the Mono Core, copy the executable file 
createMiniTEStable.exe from the bin subdirectory to a directory on your 
local system. Run the program from the command line with this command:

   mono createMiniTEStable.exe <input> <output>

where <input> is a Mini-TES data file and <output> is a new file containing 
the ASCII table generated by the program. The desired full file path can be 
specified on the command line for the <input> and <output>. If full file
paths are ommitted, the application will search the current execution folder 
for the input file and save the output file to the same folder.

How to Interpret the Output
---------------------------

The ASCII table generated by this program contains three header rows. 

The first row in the file gives the name of the original data product. 
The second row gives the column headings for the data. The third row
gives the wave number for each column. The remaining rows contain data.

Each row of data contains the spectral measurements at a single line-sample 
location in the Mini-TES image. Ancillary data from the back planes of the 
Mini-TES image cube are listed as additional columns at the end of each row. 

The output table can be loaded into a spreadsheet program, such as Microsoft
Excel, for ease of use.

Source Code
------------------------------

The source code consists of three C# (C-Sharp) files, which are
archived in the Zip-compressed file createMiniTEStable.zip in the 
software/src directory. The Zip file must be decompressed to access 
the source code. 

The primary source code class (MiniTestoAscii.cs) has been included in 
the archive. Example cs files for executing the code from a command line 
program and a C# ASP.Net web page have been included as well.
  
  Contents:
  Primary C# code class: MiniTestoAscii.cs
  Example C# command line wrapper: Class1.cs
  Example C# ASP.Net wrapper: DownloadASCIIMinites.aspx.cs
  
MiniTestoAscii.cs can be imported into another Visual Studio project 
to add the features of the class to a custom application. One of the two
included example files can be imported or used as a pattern for executing
the functions of MiniTestoAscii.