ISIS Application Documentation
      Program to output a selected table to a file
  
 
          Description
        
    
      This program takes a cube with one or more table blobs in it, and, through
      input provided by the user, outputs a selected table to an ASCII file,
      with formatting determined by user input.
     
    
      Helper button has been provided in the GUI mode for the NAME 
      parameter.  The helper button will sequentially fill in the name of 
      each table when pressed, clear the field to blank after the last table
      has been reached, and then wrap back to the beginning.
     
   
 
          Categories
        
 
              History
          
| Brendan George | 2006-10-26 | 
      Original version
     | 
 
| Brendan George | 2006-12-18 | 
      Fixed helper button
     | 
 
| Steven Lambright | 2007-07-27 | 
      Changed category from Utility to Import and Export 
     | 
 
| Steven Koechle | 2008-05-20 | 
      Changed TO parameter to function like other applications in ISIS.
      It now defaults to console output when no TO file is enterd.
     | 
 
| Christopher Austin | 2008-06-19 | 
      Fixed string representation and display.
     | 
 
| Travis Addair | 2009-03-03 | 
      Changed helper button to only place one table name into the 
      NAME parameter each time it is pressed
     | 
 
| Kris Becker | 2010-12-10 | 
      Added a newline to the last line of the output TO file.
     | 
 
| Jeannie Backer | 2012-10-04 | 
      Changed references to TableField methods to lower camel case. 
      Ordered includes. Added g_ prefix to global variables. Added padding to 
      control statements. References #1169.
     | 
 
| Steven Lambright | 2012-12-10 | 
      Text field outputs are no longer padded with NULL (ASCII 0) characters; these
      characters were not intended to be part of the output. This was fixed because
      preserving this behavior would have been much more difficult than fixing it.
      References #1312.
     | 
 
 
 | 
 
 
                Parameter Groups
            
Files
| 
                    Name
                     | 
                    Description
                     | 
 
| FROM | 
          Input Cube
         | 
 
| TO | 
          Output file
         | 
 
 
Specifications
| 
                    Name
                     | 
                    Description
                     | 
 
| NAME | 
          The name of the table
         | 
 
| DELIMIT | 
            The character to be inserted between table entries
           | 
 
| CUSTOM | User-defined delimiter | 
 
 
 | 
 
Files:
                        FROM
                         Description
                       
            This is the cube containing the table to be output.
        
| 
                             Type
                            | cube | 
| 
                               File Mode
                              | input | 
| 
                               Filter
                              | *.cub | 
 
 
Files:
                        TO
                         Description
                       
          This is the output file where the table will be written.
        
| 
                             Type
                            | filename | 
| 
                               File Mode
                              | output | 
| 
                               Internal Default
                              | 
          No Output file will be created
         | 
| 
                               Filter
                              | *.txt | 
 
 
Specifications:
                        NAME
                         Description
                       
          This is the name of the table to be output. The name is found
          in the labels, in the relevant object, as the value of the
          Keyword "Name." This value is set by the program creating
          the table, and is standardized to certain conventions.
        
 
Specifications:
                        DELIMIT
                         Description
                       
            This option will determine which character will be used to
            separate table entries, with the default option as a comma.
            The other options are space, to separate with a single
            space, or "OTHER," which allows the user to input whatever
            they wish as the delimiter character.
          
| 
                             Type
                            | string | 
| 
                               Default
                              | COMMA | 
| 
                               Option List:
                              | 
| 
                                   Option | 
                                   Brief | 
                                   Description | 
 
| COMMA | Separate with commas | 
                This option will cause the table entries to be
                separated by commas.
              Exclusions
 | 
 
| SPACE | Separate with spaces | 
                This option will cause the table entries to be
                separated by single space when output.
              Exclusions
 | 
 
| OTHER | Separate with user-defined characters | 
              This option allows the user to determine what
              character is used to separate entries. When this
              option is selected, the CUSTOM parameter is used
              to determine what will be used. Whatever string the
              user enters will be used in between the entries.
            Inclusions
 | 
 
 
 | 
 
 
Specifications:
                        CUSTOM
                         Description
                       
          This parameter is only used if the user has selected "OTHER"
          as a delimiter. The user then enters something into this
          parameter to use as a delimiter.